Market data

Access real-time and historical market prices—time series and exchange rates—for equities, forex, cryptocurrencies, ETFs, and more. These endpoints form the foundation for any trading or data-driven application.

Time series High demand

The time series endpoint provides detailed historical data for a specified financial instrument. It returns two main components: metadata, which includes essential information about the instrument, and a time series dataset. The time series consists of chronological entries with Open, High, Low, and Close prices, and for applicable instruments, it also includes trading volume. This endpoint is ideal for retrieving comprehensive historical price data for analysis or visualization purposes.

Route

/time_series

API credits cost

1 per symbol

Parameters Response

✱ One of these parameters is required

symbol

string

Symbol ticker of the instrument. E.g. AAPL, EUR/USD, ETH/BTC, ...

Example: AAPL

figi

string

The FIGI of an instrument for which data is requested. This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000B9Y5X2

isin

string

Look up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.

Example: US0378331005

cusip

string

Look up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.

Example: 594918104

✱ interval

string

Interval between two consecutive points in time series

Supports: 1min, 5min, 15min, 30min, 45min, 1h, 2h, 4h, 8h, 1day, 1week, 1month

Example: 1min

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

The country where the instrument is traded, e.g., United States or US

Example: United States

type

string

The asset class to which the instrument belongs

Supports: American Depositary Receipt, Bond, Bond Fund, Closed-end Fund, Common Stock, Depositary Receipt, Digital Currency, ETF, Exchange-Traded Note, Global Depositary Receipt, Limited Partnership, Mutual Fund, Physical Currency, Preferred Stock, REIT, Right, Structured Product, Trust, Unit, Warrant

Example: Common Stock

outputsize

integer

Number 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

Default: 30

format

string

The format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

The separator used in the CSV response data

Default: ;

prepost

boolean

Returns 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

Default: false

integer

Specifies 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

Default: -1

order

string

Sorting order of the output

Supports: asc, desc

Default: desc

timezone

string

Timezone at which output datetime will be displayed. Supports:

1. Exchange for local exchange time
2. UTC for datetime at universal UTC standard
3. Timezone name according to the IANA Time Zone Database. E.g. America/New_York, Asia/Singapore. Full list of timezones can be found here

Interval Limitation: The timezone parameter is only applicable for intraday intervals (less than 1 day). For intervals of 1day, 1week, or 1month, the timezone parameter is ignored, and data is strictly returned in the Exchange local time.

Take note that the IANA Timezone name is case-sensitive

Default: Exchange

date

string

Specifies 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

Example: 2021-10-27

start_date

string

Can be used separately and together with end_date. Format 2006-01-02 or 2006-01-02T15:04:05

Default location:

Forex and Cryptocurrencies - UTC
Stocks - where exchange is located (e.g. for AAPL it will be America/New_York)

Both parameters take into account if timezone parameter is provided.
If timezone is given then, start_date and end_date will be used in the specified location

Examples:

1. &symbol=AAPL&start_date=2019-08-09T15:50:00&…
Returns all records starting from 2019-08-09T15:50:00 New York time up to current date
2. &symbol=EUR/USD&timezone=Asia/Singapore&start_date=2019-08-09T15:50:00&…
Returns all records starting from 2019-08-09T15:50:00 Singapore time up to current date
3. &symbol=ETH/BTC&timezone=Europe/Zurich&start_date=2019-08-09T15:50:00&end_date=2019-08-09T15:55:00&...
Returns all records starting from 2019-08-09T15:50:00 Zurich time up to 2019-08-09T15:55:00

Example: 2024-08-22T15:04:05

end_date

string

The ending date and time for data selection, see start_date description for details.

Example: 2024-08-22T16:04:05

previous_close

boolean

A 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

Default: false

adjust

string

Adjusting mode for prices

Supports: all, splits, dividends, none

Default: splits

Time series cross

The Time Series Cross endpoint calculates and returns historical cross-rate data for exotic forex pairs, cryptocurrencies, or stocks (e.g., Apple Inc. price in Indian Rupees) on the fly. It provides metadata about the requested symbol and a time series array with Open, High, Low, and Close prices, sorted descending by time, enabling analysis of price history and market trends.

Route

/time_series/cross

API credits cost

5 per request

Parameters Response

✱ base

string

Base currency symbol

Example: JPY

base_type

string

Base instrument type according to the /instrument_type endpoint

Example: Physical Currency

base_exchange

string

Base exchange

Example: Binance

base_mic_code

string

Base MIC code

Example: XNGS

✱ quote

string

Quote currency symbol

Example: BTC

quote_type

string

Quote instrument type according to the /instrument_type endpoint

Example: Digital Currency

quote_exchange

string

Quote exchange

Example: Coinbase

quote_mic_code

string

Quote MIC code

Example: XNYS

✱ interval

string

Interval between two consecutive points in time series

Supports: 1min, 5min, 15min, 30min, 45min, 1h, 2h, 4h, 8h, 1day, 1week, 1month

Example: 1min

outputsize

integer

Number 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

Example: 30

format

string

Format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

Delimiter used in CSV file

Default: ;

prepost

boolean

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.

Default: false

start_date

string

Start date for the time series data

Example: 2025-01-01

end_date

string

End date for the time series data

Example: 2025-01-31

adjust

boolean

Specifies if there should be an adjustment

Default: true

integer

Specifies the number of decimal places for floating values. Should be in range [0, 11] inclusive.

Default: 5

timezone

string

Timezone at which output datetime will be displayed. Supports:

1. Exchange for local exchange time
2. UTC for datetime at universal UTC standard
3. Timezone name according to the IANA Time Zone Database. E.g. America/New_York, Asia/Singapore. Full list of timezones can be found here.

Take note that the IANA Timezone name is case-sensitive

Example: UTC

Quote High demand

The quote endpoint provides real-time data for a selected financial instrument, returning essential information such as the latest price, open, high, low, close, volume, and price change. This endpoint is ideal for users needing up-to-date market data to track price movements and trading activity for specific stocks, ETFs, or other securities.

Route

/quote

API credits cost

1 per symbol

Parameters Response

✱ One of these parameters is required

symbol

string

Symbol ticker of the instrument

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000BHTMY7

isin

string

Look up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.

Example: US0378331005

cusip

string

Look up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.

Example: 594918104

interval

string

Interval of the quote

Supports: 1min, 5min, 15min, 30min, 45min, 1h, 2h, 4h, 8h, 1day, 1week, 1month

Default: 1day

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Country where instrument is traded, e.g., United States or US

Example: United States

volume_time_period

integer

Number of periods for Average Volume

Default: 9

type

string

The asset class to which the instrument belongs

Example: ETF

format

string

Value can be JSON or CSV Default JSON

Supports: JSON, CSV

Default: JSON

delimiter

string

Specify the delimiter used when downloading the CSV file

Default: ;

prepost

boolean

Parameter 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.

Default: false

eod

boolean

If true, then return data for closed day

Supports: true, false

Default: false

rolling_period

integer

Number of hours for calculate rolling change at period. By default set to 24, it can be in range [1, 168].

Default: 24

integer

Specifies the number of decimal places for floating values Should be in range [0,11] inclusive

Default: 5

timezone

string

Timezone at which output datetime will be displayed. Supports:

1. Exchange for local exchange time
2. UTC for datetime at universal UTC standard
3. Timezone name according to the IANA Time Zone Database. E.g. America/New_York, Asia/Singapore. Full list of timezones can be found here.

Take note that the IANA Timezone name is case-sensitive

Default: Exchange

object

Attributes

symbol

string

Symbol passed

name

string

Name of the instrument

exchange

string

Exchange where instrument is traded

mic_code

string

Market identifier code (MIC) under ISO 10383 standard. Available for stocks, ETFs, mutual funds, bonds

currency

string

Currency in which the equity is denominated. Available for stocks, ETFs, mutual funds, bonds

datetime

string

Datetime in defined timezone referring to when the bar with specified interval was opened

timestamp

integer

Unix timestamp representing the opening candle of the specified interval

last_quote_at

integer

Unix timestamp of last minute candle

open

string

Price at the opening of current bar

high

string

Highest price which occurred during the current bar

low

string

Lowest price which occurred during the current bar

string

Close price at the end of the bar

volume

string

Trading volume during the bar. Available not for all instrument types

previous_close

string

Close price at the end of the previous bar

change

string

Close - previous_close

percent_change

string

(Close - previous_close) / previous_close * 100

average_volume

string

Average volume of the specified period. Available not for all instrument types

rolling_1d_change

string

Percent change in price between the current and the backward one, where period is 1 day. Available for crypto

rolling_7d_change

string

Percent change in price between the current and the backward one, where period is 7 days. Available for crypto

rolling_change

string

Percent change in price between the current and the backward one, where period specified in request param rolling_period. Available for crypto

is_market_open

boolean

True if market is open; false if closed

fifty_two_week

object

Collection of 52-week metrics

Attributes

low

string

52-week low price

high

string

52-week high price

low_change

string

Current price - 52-week low

high_change

string

Current price - 52-week high

low_change_percent

string

Percentage change from 52-week low

high_change_percent

string

Percentage change from 52-week high

range

string

Range between 52-week low and high

extended_change

string

Diff between the regular close price and the latest extended price. Displayed only if prepost is true

extended_percent_change

string

Percent change in price between the regular close price and the latest extended price. Displayed only if prepost is true

extended_price

string

Latest extended price. Displayed only if prepost is true

extended_timestamp

integer

Unix timestamp of the last extended price. Displayed only if prepost is true

Copy for LLM

View as Markdown

Request example

https://api.twelvedata.com/quote?symbol=AAPL&apikey=demo

Response

{
    "symbol": "AAPL",
    "name": "Apple Inc",
    "exchange": "NASDAQ",
    "mic_code": "XNAS",
    "currency": "USD",
    "datetime": "2021-09-16",
    "timestamp": 1631772000,
    "last_quote_at": 1631772000,
    "open": "148.44000",
    "high": "148.96840",
    "low": "147.22099",
    "close": "148.85001",
    "volume": "67903927",
    "previous_close": "149.09000",
    "change": "-0.23999",
    "percent_change": "-0.16097",
    "average_volume": "83571571",
    "rolling_1d_change": "123.123",
    "rolling_7d_change": "123.123",
    "rolling_change": "123.123",
    "is_market_open": false,
    "fifty_two_week": {
        "low": "103.10000",
        "high": "157.25999",
        "low_change": "45.75001",
        "high_change": "-8.40999",
        "low_change_percent": "44.37440",
        "high_change_percent": "-5.34782",
        "range": "103.099998 - 157.259995"
    },
    "extended_change": "0.09",
    "extended_percent_change": "0.05",
    "extended_price": "125.22",
    "extended_timestamp": 1649845281
}

Latest price High demand

The latest price endpoint provides the latest market price for a specified financial instrument. It returns a single data point representing the current (or the most recently available) trading price.

Route

/price

API credits cost

1 per symbol

Parameters Response

✱ One of these parameters is required

symbol

string

Symbol ticker of the instrument

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000BHTMY7

isin

string

Look up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.

Example: US0378331005

cusip

string

Look up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.

Example: 594918104

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Country where instrument is traded, e.g., United States or US

Example: United States

type

string

The asset class to which the instrument belongs

Example: ETF

format

string

Value can be JSON or CSV

Supports: JSON, CSV

Default: JSON

delimiter

string

Specify the delimiter used when downloading the CSV file

Default: ;

prepost

boolean

Parameter 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.

Default: false

integer

Specifies the number of decimal places for floating values. Should be in range [0,11] inclusive

Default: 5

Copy for LLM

View as Markdown

Request example

https://api.twelvedata.com/price?symbol=AAPL&apikey=demo

Response

{
    "price": "200.99001"
}

End of day price

The End of Day (EOD) Prices endpoint provides the closing price and other relevant metadata for a financial instrument at the end of a trading day. This endpoint is useful for retrieving daily historical data for stocks, ETFs, or other securities, allowing users to track performance over time and compare daily market movements.

Route

/eod

API credits cost

1 per symbol

Parameters Response

✱ One of these parameters is required

symbol

string

Symbol ticker of the instrument

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000BHTMY7

isin

string

Look up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.

Example: US0378331005

cusip

string

Look up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.

Example: 594918104

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Country where instrument is traded, e.g., United States or US

Example: United States

type

string

The asset class to which the instrument belongs

Example: ETF

date

string

If not null, then return data from a specific date

Example: 2006-01-02

prepost

boolean

Default: false

integer

Specifies the number of decimal places for floating values Should be in range [0,11] inclusive

Default: 5

Copy for LLM

View as Markdown

Request example

https://api.twelvedata.com/eod?symbol=AAPL&apikey=demo

Response

{
    "symbol": "AAPL",
    "exchange": "NASDAQ",
    "mic_code": "XNAS",
    "currency": "USD",
    "datetime": "2021-09-16",
    "close": "148.79"
}

Market movers

The market movers endpoint provides a ranked list of the top-gaining and losing assets for the current trading day. It returns detailed data on the highest percentage price increases and decreases since the previous day's close. This endpoint supports international equities, forex, and cryptocurrencies, enabling users to quickly identify significant market movements across various asset classes.

Route

/market_movers/{market}

API credits cost

100 per request

This API endpoint is available on the Pro plan (individual) and the Venture plan (business) and above.

Parameters Response

✱ market

string

Market type

Supports: stocks, etf, mutual_funds, forex, crypto

Example: stocks

direction

string

Specifies direction of the snapshot gainers or losers

Supports: gainers, losers

Default: gainers

outputsize

integer

Specifies the size of the snapshot. Can be in a range from 1 to 50

Default: 30

country

string

Country of the snapshot, applicable to non-currencies only. Takes country name or alpha code

Default: USA

price_greater_than

string

Takes values with price grater than specified value

Example: 175.5

string

Specifies the number of decimal places for floating values. Should be in range [0,11] inclusive

Default: 5

values

array of object

Market movers list

Attributes

symbol

string

The exchange symbol ticker

name

string

The official name of the instrument

exchange

string

Exchange where instrument is traded

mic_code

string

Market identifier code (MIC) under ISO 10383 standard

datetime

string

The last updated datetime timestamp

last

double

The latest available price for the symbol today

high

double

The highest price for the symbol today

low

double

The lowest price for the symbol today

volume

integer

The trading volume of the symbol today

change

double

The value of the change since the previous day

percent_change

double

The percentage change since the previous day

status

string

Response status

Copy for LLM

View as Markdown

Request example

https://api.twelvedata.com/market_movers/stocks?apikey=your_api_key

Response

{
    "values": [
        {
            "symbol": "BSET",
            "name": "Bassett Furniture Industries Inc",
            "exchange": "NASDAQ",
            "mic_code": "XNAS",
            "datetime": "2023-10-01 12:00:00Z",
            "last": 17.25,
            "high": 18,
            "low": 16.5,
            "volume": 108297,
            "change": 3.31,
            "percent_change": 23.74462
        }
    ],
    "status": "ok"
}