Skip to main content
Server path: /twelvedata-market-data | Type: Application | PCID required: Yes

Tools


twelvedata_market_data_get_api_usage

API usage Parameters:
ParameterTypeRequiredDefaultDescription
formatstringNoOutput format
delimiterstringNoSpecify the delimiter used when downloading the CSV file
timezonestringNoTimezone at which output datetime will be displayed. Supports: <ul> <li>1. <code>UTC</code> for datetime at universal UTC standard</li> <li>2. Timezone name according to the IANA Time Zone Database. E.g. <code>America/New_York</code>, <code>Asia/Singapore</code>. Full list of timezones can be found <a href=“https://en.wikipedia.org/wiki/List_of_tz_database_time_zones” target=“blank”>here</a>.</li> </ul> <i>Take note that the IANA Timezone name is case-sensitive</i>

twelvedata_market_data_get_currency_conversion

Currency conversion Parameters:
ParameterTypeRequiredDefaultDescription
symbolstringYesThe currency pair you want to request can be either forex or cryptocurrency. Slash(/) delimiter is used. E.g. EUR/USD or BTC/ETH will be correct
amountnumberYesAmount of base currency to be converted into quote currency. Supports values in the range from 0 and above
datestringNoIf not null, will use exchange rate from a specific date or time. Format 2006-01-02 or 2006-01-02T15:04:05. Is set in the local exchange time zone, use timezone parameter to specify a specific time zone
formatstringNoValue can be JSON or CSV. Default JSON
delimiterstringNoSpecify the delimiter used when downloading the CSV file. Default semicolon ;
dpintegerNoThe number of decimal places for the data
timezonestringNoTimezone at which output datetime will be displayed. Supports: <ul> <li>1. <code>Exchange</code> for local exchange time</li> <li>2. <code>UTC</code> for datetime at universal UTC standard</li> <li>3. Timezone name according to the IANA Time Zone Database. E.g. <code>America/New_York</code>, <code>Asia/Singapore</code>. Full list of timezones can be found <a href=“https://en.wikipedia.org/wiki/List_of_tz_database_time_zones” target=“blank”>here</a>.</li> </ul> <i>Take note that the IANA Timezone name is case-sensitive</i>

twelvedata_market_data_get_eod

End of day price Parameters:
ParameterTypeRequiredDefaultDescription
symbolstringNoSymbol ticker of the instrument
figistringNoFilter by financial instrument global identifier (FIGI). This parameter is available on the <a href=“https://twelvedata.com/pricing”&gt;Ultra&lt;/a> plan (individual) and the <a href=“https://twelvedata.com/pricing-business”&gt;Enterprise&lt;/a> plan (business) and above.
isinstringNoFilter by international securities identification number (ISIN). ISIN access is activating in the <a href=“https://twelvedata.com/account/add-ons”&gt;Data add-ons</a> section
cusipstringNoThe CUSIP of an instrument for which data is requested. CUSIP access is activating in the <a href=“https://twelvedata.com/account/add-ons”&gt;Data add-ons</a> section
exchangestringNoExchange where instrument is traded
mic_codestringNoMarket Identifier Code (MIC) under ISO 10383 standard
countrystringNoCountry where instrument is traded, e.g., United States or US
typestringNoThe asset class to which the instrument belongs
datestringNoIf not null, then return data from a specific date
prepostbooleanNoParameter is optional. Only for the Pro plan (individual) and Venture plan (business) and above. Available at the 1min, 5min, 15min, and 30min intervals for US equities. Open, high, low, close values are supplied without volume
dpintegerNoSpecifies the number of decimal places for floating values Should be in range [0,11] inclusive

twelvedata_market_data_get_exchange_rate

Exchange rate Parameters:
ParameterTypeRequiredDefaultDescription
symbolstringYesThe currency pair you want to request can be either forex or cryptocurrency. Slash(/) delimiter is used. E.g. EUR/USD or BTC/ETH will be correct
datestringNoIf not null, will use exchange rate from a specific date or time. Format 2006-01-02 or 2006-01-02T15:04:05. Is set in the local exchange time zone, use timezone parameter to specify a specific time zone
formatstringNoValue can be JSON or CSV. Default JSON
delimiterstringNoSpecify the delimiter used when downloading the CSV file. Default semicolon ;
dpintegerNoThe number of decimal places for the data
timezonestringNoTimezone at which output datetime will be displayed. Supports: <ul> <li>1. <code>Exchange</code> for local exchange time</li> <li>2. <code>UTC</code> for datetime at universal UTC standard</li> <li>3. Timezone name according to the IANA Time Zone Database. E.g. <code>America/New_York</code>, <code>Asia/Singapore</code>. Full list of timezones can be found <a href=“https://en.wikipedia.org/wiki/List_of_tz_database_time_zones” target=“blank”>here</a>.</li> </ul> <i>Take note that the IANA Timezone name is case-sensitive</i>

twelvedata_market_data_get_movers

Market movers Parameters:
ParameterTypeRequiredDefaultDescription
marketstringYesMaket type
directionstringNoSpecifies direction of the snapshot gainers or losers
outputsizeintegerNoSpecifies the size of the snapshot. Can be in a range from 1 to 50
countrystringNoCountry of the snapshot, applicable to non-currencies only. Takes country name or alpha code
price_greater_thanstringNoTakes values with price grater than specified value
dpstringNoSpecifies the number of decimal places for floating values. Should be in range [0,11] inclusive

twelvedata_market_data_get_price

Latest price Parameters:
ParameterTypeRequiredDefaultDescription
symbolstringNoSymbol ticker of the instrument
figistringNoFilter by financial instrument global identifier (FIGI). This parameter is available on the <a href=“https://twelvedata.com/pricing”&gt;Ultra&lt;/a> plan (individual) and the <a href=“https://twelvedata.com/pricing-business”&gt;Enterprise&lt;/a> plan (business) and above.
isinstringNoFilter by international securities identification number (ISIN). ISIN access is activating in the <a href=“https://twelvedata.com/account/add-ons”&gt;Data add-ons</a> section
cusipstringNoThe CUSIP of an instrument for which data is requested. CUSIP access is activating in the <a href=“https://twelvedata.com/account/add-ons”&gt;Data add-ons</a> section
exchangestringNoExchange where instrument is traded
mic_codestringNoMarket Identifier Code (MIC) under ISO 10383 standard
countrystringNoCountry where instrument is traded, e.g., United States or US
typestringNoThe asset class to which the instrument belongs
formatstringNoValue can be JSON or CSV
delimiterstringNoSpecify the delimiter used when downloading the CSV file
prepostbooleanNoParameter is optional. Only for Pro or Venture, and above plans. Available at the 1min, 5min, 15min, and 30min intervals for US equities. Open, high, low, close values are supplied without volume.
dpintegerNoSpecifies the number of decimal places for floating values. Should be in range [0,11] inclusive

twelvedata_market_data_get_quote

Quote Parameters:
ParameterTypeRequiredDefaultDescription
symbolstringNoSymbol ticker of the instrument
figistringNoFilter by financial instrument global identifier (FIGI). This parameter is available on the <a href=“https://twelvedata.com/pricing”&gt;Ultra&lt;/a> plan (individual) and the <a href=“https://twelvedata.com/pricing-business”&gt;Enterprise&lt;/a> plan (business) and above.
isinstringNoFilter by international securities identification number (ISIN). ISIN access is activating in the <a href=“https://twelvedata.com/account/add-ons”&gt;Data add-ons</a> section
cusipstringNoThe CUSIP of an instrument for which data is requested. CUSIP access is activating in the <a href=“https://twelvedata.com/account/add-ons”&gt;Data add-ons</a> section
intervalstringNoInterval of the quote
exchangestringNoExchange where instrument is traded
mic_codestringNoMarket Identifier Code (MIC) under ISO 10383 standard
countrystringNoCountry where instrument is traded, e.g., United States or US
volume_time_periodintegerNoNumber of periods for Average Volume
typestringNoThe asset class to which the instrument belongs
formatstringNoValue can be JSON or CSV Default JSON
delimiterstringNoSpecify the delimiter used when downloading the CSV file
prepostbooleanNoParameter is optional. Only for the Pro plan (individual) and Venture plan (business) and above. Available at the 1min, 5min, 15min, and 30min intervals for US equities. Open, high, low, close values are supplied without volume.
eodbooleanNoIf true, then return data for closed day
rolling_periodintegerNoNumber of hours for calculate rolling change at period. By default set to 24, it can be in range [1, 168].
dpintegerNoSpecifies the number of decimal places for floating values Should be in range [0,11] inclusive
timezonestringNoTimezone at which output datetime will be displayed. Supports: <ul> <li>1. <code>Exchange</code> for local exchange time</li> <li>2. <code>UTC</code> for datetime at universal UTC standard</li> <li>3. Timezone name according to the IANA Time Zone Database. E.g. <code>America/New_York</code>, <code>Asia/Singapore</code>. Full list of timezones can be found <a href=“https://en.wikipedia.org/wiki/List_of_tz_database_time_zones” target=“blank”>here</a>.</li> </ul> <i>Take note that the IANA Timezone name is case-sensitive</i>

twelvedata_market_data_get_time_series

Time series Parameters:
ParameterTypeRequiredDefaultDescription
symbolstringNoSymbol ticker of the instrument. E.g. AAPL, EUR/USD, ETH/BTC, …
isinstringNoFilter by international securities identification number (ISIN). ISIN access is activating in the <a href=“https://twelvedata.com/account/add-ons”&gt;Data add-ons</a> section
figistringNoThe FIGI of an instrument for which data is requested. This parameter is available on the <a href=“https://twelvedata.com/pricing”&gt;Ultra&lt;/a> plan (individual) and the <a href=“https://twelvedata.com/pricing-business”&gt;Enterprise&lt;/a> plan (business) and above.
cusipstringNoThe CUSIP of an instrument for which data is requested. CUSIP access is activating in the <a href=“https://twelvedata.com/account/add-ons”&gt;Data add-ons</a> section
intervalstringYesInterval between two consecutive points in time series
outputsizeintegerNoNumber of data points to retrieve. Supports values in the range from 1 to 5000. Default 30 when no date parameters are set, otherwise set to maximum
exchangestringNoExchange where instrument is traded
mic_codestringNoMarket Identifier Code (MIC) under ISO 10383 standard
countrystringNoThe country where the instrument is traded, e.g., United States or US
typestringNoThe asset class to which the instrument belongs
timezonestringNoTimezone at which output datetime will be displayed. Supports: <ul> <li>1. <code>Exchange</code> for local exchange time</li> <li>2. <code>UTC</code> for datetime at universal UTC standard</li> <li>3. Timezone name according to the IANA Time Zone Database. E.g. <code>America/New_York</code>, <code>Asia/Singapore</code>. Full list of timezones can be found <a href=“https://en.wikipedia.org/wiki/List_of_tz_database_time_zones” target=“blank”>here</a></li> </ul> <i>Take note that the IANA Timezone name is case-sensitive</i>
start_datestringNoCan be used separately and together with end_date. Format 2006-01-02 or 2006-01-02T15:04:05 Default location: <ul> <li>Forex and Cryptocurrencies - <code>UTC</code></li> <li>Stocks - where exchange is located (e.g. for AAPL it will be <code>America/New_York</code>)</li> </ul> Both parameters take into account if <code>timezone</code> parameter is provided.<br/> If <code>timezone</code> is given then, <code>start_date</code> and <code>end_date</code> will be used in the specified location Examples: <ul> <li>1. <code>&symbol=AAPL&start_date=2019-08-09T15:50:00&…</code><br/> Returns all records starting from 2019-08-09T15:50:00 New York time up to current date</li> <li>2. <code>&symbol=EUR/USD&timezone=Asia/Singapore&start_date=2019-08-09T15:50:00&…</code><br/> Returns all records starting from 2019-08-09T15:50:00 Singapore time up to current date</li> <li>3. <code>&symbol=ETH/BTC&timezone=Europe/Zurich&start_date=2019-08-09T15:50:00&end_date=2019-08-09T15:55:00&…</code><br/> Returns all records starting from 2019-08-09T15:50:00 Zurich time up to 2019-08-09T15:55:00</li> </ul>
end_datestringNoThe ending date and time for data selection, see start_date description for details.
datestringNoSpecifies the exact date to get the data for. Could be the exact date, e.g. 2021-10-27, or in human language today or yesterday
orderstringNoSorting order of the output
prepostbooleanNoReturns quotes that include pre-market and post-market data. Only for the Pro plan (individual) and Venture plan (business) and above. Available at the 1min, 5min, 15min, and 30min intervals for US equities. Open, high, low, close values are supplied without volume
formatstringNoThe format of the response data
delimiterstringNoThe separator used in the CSV response data
dpintegerNoSpecifies the number of decimal places for floating values. Should be in range [0, 11] inclusive. By default, the number of decimal places is automatically determined based on the values provided
previous_closebooleanNoA boolean parameter to include the previous closing price in the time_series data. If true, adds previous bar close price value to the current object
adjuststringNoAdjusting mode for prices

twelvedata_market_data_get_time_series_cross

Time series cross Parameters:
ParameterTypeRequiredDefaultDescription
basestringYesBase currency symbol
base_typestringNoBase instrument type according to the /instrument_type endpoint
base_exchangestringNoBase exchange
base_mic_codestringNoBase MIC code
quotestringYesQuote currency symbol
quote_typestringNoQuote instrument type according to the /instrument_type endpoint
quote_exchangestringNoQuote exchange
quote_mic_codestringNoQuote MIC code
intervalstringYesInterval between two consecutive points in time series
outputsizeintegerNoNumber of data points to retrieve. Supports values in the range from 1 to 5000. Default 30 when no date parameters are set, otherwise set to maximum
formatstringNoFormat of the response data
delimiterstringNoDelimiter used in CSV file
prepostbooleanNoOnly for the Pro plan (individual) and Venture plan (business) and above. Available at the 1min, 5min, 15min, and 30min intervals for US equities. Open, high, low, close values are supplied without volume.
start_datestringNoStart date for the time series data
end_datestringNoEnd date for the time series data
adjustbooleanNoSpecifies if there should be an adjustment
dpintegerNoSpecifies the number of decimal places for floating values. Should be in range [0, 11] inclusive.
timezonestringNoTimezone at which output datetime will be displayed. Supports: <ul> <li>1. <code>Exchange</code> for local exchange time</li> <li>2. <code>UTC</code> for datetime at universal UTC standard</li> <li>3. Timezone name according to the IANA Time Zone Database. E.g. <code>America/New_York</code>, <code>Asia/Singapore</code>. Full list of timezones can be found <a href=“https://en.wikipedia.org/wiki/List_of_tz_database_time_zones” target=“blank”>here</a>.</li> </ul> <i>Take note that the IANA Timezone name is case-sensitive</i>