Asset catalogs

Asset Catalog endpoints are your starting point. They return the complete inventory of tradeable instruments available through Twelve Data — over 1,000,000 symbols across 50+ countries. You query a catalog first to discover which symbols exist, then pass those symbols to price, fundamental, or indicator endpoints.

Stocks

The stocks endpoint provides a daily updated list of all available stock symbols. It returns an array containing the symbols, which can be used to identify and access specific stock data across various services. This endpoint is essential for users needing to retrieve the latest stock symbol information for further data requests or integration into financial applications.

Route

/stocks

API credits cost

1 per request

Parameters Response

symbol

string

The ticker symbol of an instrument for which data is requested

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: 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

cik

string

The CIK of an instrument for which data is requested

Example: 95953

exchange

string

Filter by exchange name

Example: NASDAQ

mic_code

string

Filter by market identifier code (MIC) under ISO 10383 standard

Example: XNGS

country

string

Filter by country name or alpha code, 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

format

string

The format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

The separator used in the CSV response data

Default: ;

show_plan

boolean

Adds info on which plan symbol is available

Default: false

include_delisted

boolean

Include delisted identifiers

Default: false

page

integer

Page number of the results to fetch

Default: 1

outputsize

integer

Determines the number of data points returned in the output. If not specified, all available records are returned

Example: 50

count

integer

Count

data

array of object

List of stock instruments

Attributes

symbol

string

Instrument symbol (ticker)

name

string

Full name of instrument

currency

string

Currency of the instrument according to the ISO 4217 standard

exchange

string

Exchange where instrument is traded

mic_code

string

Market identifier code (MIC) under ISO 10383 standard

country

string

Country where exchange is located

type

string

Common issue type

figi_code

string

Financial instrument global identifier (FIGI)

cfi_code

string

Classification of Financial Instruments (CFI)

isin

string

International securities identification number (ISIN), available by individual request to support

cusip

string

A unique nine-character alphanumeric code used to identify financial securities, ensuring accurate data retrieval for the specified asset

access

object

Info on which plan symbol is available (displayed then show_plan is true)

Attributes

global

string

Level of access to the symbol

plan

string

The individual plan name for the symbol

plan_business

string

The business plan name for the symbol

status

string

Response status

Copy for LLM

View as Markdown

Request example

https://api.twelvedata.com/stocks?apikey=demo

Response

{
    "count": 100,
    "data": [
        {
            "symbol": "AAPL",
            "name": "Apple Inc",
            "currency": "USD",
            "exchange": "NASDAQ",
            "mic_code": "XNGS",
            "country": "United States",
            "type": "Common Stock",
            "figi_code": "BBG000B9Y5X2",
            "cfi_code": "ESVUFR",
            "isin": "US0378331005",
            "cusip": "037833100",
            "access": {
                "global": "Basic",
                "plan": "Basic",
                "plan_business": "Basic"
            }
        }
    ],
    "status": "ok"
}

Forex pairs

The forex pairs endpoint provides a comprehensive list of all available foreign exchange currency pairs. It returns an array of forex pairs, which is updated daily.

Route

/forex_pairs

API credits cost

1 per request

Parameters Response

symbol

string

The ticker symbol of an instrument for which data is requested

Example: EUR/USD

currency_base

string

Filter by currency base

Example: EUR

currency_quote

string

Filter by currency quote

Example: USD

format

string

The format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

The separator used in the CSV response data

Default: ;

page

integer

Page number of the results to fetch

Default: 1

outputsize

integer

Determines the number of data points returned in the output. If not specified, all available records are returned

Example: 50

Copy for LLM

View as Markdown

Request example

https://api.twelvedata.com/forex_pairs?apikey=demo

Response

{
    "count": 100,
    "data": [
        {
            "symbol": "EUR/USD",
            "currency_group": "Major",
            "currency_base": "EUR",
            "currency_quote": "USD"
        }
    ],
    "status": "ok"
}

Cryptocurrency pairs

The cryptocurrencies endpoint provides a daily updated list of all available cryptos. It returns an array containing detailed information about each cryptocurrency, including its symbol, name, and other relevant identifiers. This endpoint is useful for retrieving a comprehensive catalog of cryptocurrencies for applications that require up-to-date market listings or need to display available crypto assets to users.

Route

/cryptocurrencies

API credits cost

1 per request

Parameters Response

symbol

string

The ticker symbol of an instrument for which data is requested

Example: BTC/USD

exchange

string

Filter by exchange name. E.g. Binance, Coinbase, etc.

Example: Binance

currency_base

string

Filter by currency base

Example: BTC

currency_quote

string

Filter by currency quote

Example: USD

format

string

The format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

The separator used in the CSV response data

Default: ;

page

integer

Page number of the results to fetch

Default: 1

outputsize

integer

Determines the number of data points returned in the output. If not specified, all available records are returned

Example: 50

Copy for LLM

View as Markdown

Request example

https://api.twelvedata.com/cryptocurrencies?apikey=demo

Response

{
    "count": 100,
    "data": [
        {
            "symbol": "BTC/USD",
            "available_exchanges": [
                "ABCC",
                "Allcoin",
                "BTC-Alpha",
                "BTCTurk",
                "Bibox",
                "n.exchange",
                "p2pb2b",
                "xBTCe"
            ],
            "currency_base": "Bitcoin",
            "currency_quote": "US Dollar"
        }
    ],
    "status": "ok"
}

ETFs

The ETFs endpoint provides a daily updated list of all available Exchange-Traded Funds. It returns an array containing detailed information about each ETF, including its symbol, name, and other relevant identifiers. This endpoint is useful for retrieving a comprehensive catalog of ETFs for portfolio management, investment tracking, or financial analysis.

Route

/etfs

API credits cost

1 per request

Parameters Response

symbol

string

The ticker symbol of an instrument for which data is requested

Example: SPY

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: BBG000BDTF76

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

cik

string

The CIK of an instrument for which data is requested

Example: 95953

exchange

string

Filter by exchange name

Example: NYSE

mic_code

string

Filter by market identifier code (MIC) under ISO 10383 standard

Example: XNYS

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

format

string

The format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

The separator used in the CSV response data

Default: ;

show_plan

boolean

Adds info on which plan symbol is available

Default: false

include_delisted

boolean

Include delisted identifiers

Default: false

page

integer

Page number of the results to fetch

Default: 1

outputsize

integer

Determines the number of data points returned in the output. If not specified, all available records are returned

Example: 50

count

integer

Count

data

array of object

List of ETFs

Attributes

symbol

string

Instrument symbol (ticker)

name

string

Full name of the ETF

currency

string

Currency of the ETF according to the ISO 4217 standard

exchange

string

Exchange where the ETF is traded

mic_code

string

Market identifier code (MIC) under ISO 10383 standard

country

string

Country where the ETF is located

figi_code

string

Financial instrument global identifier (FIGI)

cfi_code

string

Classification of Financial Instruments (CFI)

isin

string

International securities identification number (ISIN)

cusip

string

A unique nine-character alphanumeric code used to identify financial securities, ensuring accurate data retrieval for the specified asset

access

object

Info on which plan symbol is available (displayed then show_plan is true)

Attributes

global

string

Level of access to the symbol

plan

string

The individual plan name for the symbol

plan_business

string

The business plan name for the symbol

status

string

Response status

Copy for LLM

View as Markdown

Request example

https://api.twelvedata.com/etfs?apikey=demo

Response

{
    "count": 100,
    "data": [
        {
            "symbol": "SPY",
            "name": "SPDR S&P 500 ETF Trust",
            "currency": "USD",
            "exchange": "NYSE",
            "mic_code": "ARCX",
            "country": "United States",
            "figi_code": "BBG000BDTF76",
            "cfi_code": "CECILU",
            "isin": "US78462F1030",
            "cusip": "037833100",
            "access": {
                "global": "Basic",
                "plan": "Basic",
                "plan_business": "Basic"
            }
        }
    ],
    "status": "ok"
}

Funds

The funds endpoint provides a daily updated list of available investment funds. It returns an array containing detailed information about each fund, including identifiers, names, and other relevant attributes.

Route

/funds

API credits cost

1 per request

Parameters Response

symbol

string

The ticker symbol of an instrument for which data is requested

Example: FXAIX

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

cik

string

The CIK of an instrument for which data is requested

Example: 95953

exchange

string

Filter by exchange name

Example: Nasdaq

mic_code

string

Filter by market identifier code (MIC) under ISO 10383 standard

Example: ARCX

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

format

string

The format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

The separator used in the CSV response data

Default: ;

show_plan

boolean

Adds info on which plan symbol is available

Default: false

page

integer

Page number of the results to fetch

Default: 1

outputsize

integer

Determines the number of data points returned in the output. If not specified, all available records are returned

Example: 50

result

object

Attributes

count

integer

Total number of matching instruments

list

array of object

List of funds

Attributes

symbol

string

Instrument symbol (ticker)

name

string

Full name of the fund

country

string

Country where the fund is located

currency

string

Currency of the fund according to the ISO 4217 standard

exchange

string

Exchange where the fund is traded

mic_code

string

Market identifier code (MIC) under ISO 10383 standard

type

string

Type of the fund

figi_code

string

Financial instrument global identifier (FIGI)

cfi_code

string

Classification of Financial Instruments (CFI)

isin

string

International securities identification number (ISIN)

cusip

string

A unique nine-character alphanumeric code used to identify financial securities, ensuring accurate data retrieval for the specified asset

access

object

Info on which plan symbol is available (displayed then show_plan is true)

Attributes

global

string

Level of access to the symbol

plan

string

The individual plan name for the symbol

plan_business

string

The business plan name for the symbol

status

string

Status of the response

Copy for LLM

View as Markdown

Request example

https://api.twelvedata.com/funds?apikey=demo

Response

{
    "result": {
        "count": 84799,
        "list": [
            {
                "symbol": "DIVI",
                "name": "AdvisorShares Athena High Dividend ETF",
                "country": "United States",
                "currency": "USD",
                "exchange": "NYSE",
                "mic_code": "ARCX",
                "type": "ETF",
                "figi_code": "BBG00161BCW4",
                "cfi_code": "CECILU",
                "isin": "GB00B65TLW28",
                "cusip": "35473P108",
                "access": {
                    "global": "Basic",
                    "plan": "Basic",
                    "plan_business": "Basic"
                }
            }
        ]
    },
    "status": "ok"
}

Commodities

The commodities endpoint provides a daily updated list of available commodity pairs, across precious metals, livestock, softs, grains, etc.

Route

/commodities

API credits cost

1 per request

Parameters Response

symbol

string

The ticker symbol of an instrument for which data is requested

Example: XAU/USD

Fixed income

The fixed income endpoint provides a daily updated list of available bonds. It returns an array containing detailed information about each bond, including identifiers, names, and other relevant attributes.

Route

/bonds

API credits cost

1 per request

Parameters Response

symbol

string

The ticker symbol of an instrument for which data is requested

Example: US2Y

exchange

string

Filter by exchange name

Example: NYSE

mic_code

string

Filter by market identifier code (MIC) under ISO 10383 standard

Example: XNYS

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

format

string

The format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

The separator used in the CSV response data

Default: ;

show_plan

boolean

Adds info on which plan symbol is available

Default: false

page

integer

Page number of the results to fetch

Default: 1

outputsize

integer

Determines the number of data points returned in the output. If not specified, all available records are returned

Example: 50

result

object

Attributes

count

integer

Total number of matching instruments

list

array of object

List of bonds

Attributes

symbol

string

Bond symbol

name

string

Full name of the bond

country

string

Country where the bond is located

currency

string

Currency of the bond according to the ISO 4217 standard

exchange

string

Exchange where the bond is traded

mic_code

string

Market identifier code (MIC) under ISO 10383 standard

type

string

Type of the bond

access

object

Info on which plan symbol is available (displayed then show_plan is true)

Attributes

global

string

Level of access to the symbol

plan

string

The individual plan name for the symbol

plan_business

string

The business plan name for the symbol

status

string

Response status

Copy for LLM

View as Markdown

Request example

https://api.twelvedata.com/bonds?apikey=demo

Response

{
    "result": {
        "count": 6,
        "list": [
            {
                "symbol": "US2Y",
                "name": "US Treasury Yield 2 Years",
                "country": "United States",
                "currency": "USD",
                "exchange": "NYSE",
                "mic_code": "XNYS",
                "type": "Bond",
                "access": {
                    "global": "Basic",
                    "plan": "Basic",
                    "plan_business": "Basic"
                }
            }
        ]
    },
    "status": "ok"
}