How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Twelve Data Reference Data API

Catalogs of instruments, exchanges, and supporting metadata.

Twelve Data Reference Data API is one of 15 APIs that Twelve Data publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Reference Data. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 19 operations across 19 paths, and defines 55 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against 2 base URLs: https://api.twelvedata.com/, https://api.twelvedata.com.

19 operations 19 paths 55 schemas 19 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://api.twelvedata.com
Authentication
API Key, API Key, API Key, API Key
Resource Areas
1

Authentication & Security 4

Twelve Data Reference Data API declares 4 security schemes for authenticating requests. An API key is passed in the header as Authorization (authorizationHeader). An API key is passed in the query as apikey (queryParameter). An API key is passed in the query as apikey (apikeyQuery). An API key is passed in the header as Authorization (apikeyHeader).

  • authorizationHeader — Enter the token with the apikey prefix, e.g. "apikey abcde12345".
  • apikeyQuery — API key supplied as the apikey query parameter.
  • apikeyHeader — API key supplied as Authorization: apikey .

Paths & Operations 19

Across 19 paths, the API surfaces 19 operations — 19 GET. Each is listed below with its method, path, parameters, and response codes.

reference_data 19
GET
/bonds
Fixed income
GetBonds 8 params → 200400401403404414429500
GET
/commodities
Commodities
GetCommodities 6 params → 200400401403404414429500
GET
/countries
Countries
GetCountries → 200400401403404414429500
GET
/cross_listings
Cross listings
GetCrossListings 4 params → 200400401403404414429500
GET
/cryptocurrencies
Cryptocurrency pairs
GetCryptocurrencies 8 params → 200400401403404414429500
GET
/cryptocurrency_exchanges
Cryptocurrency exchanges
GetCryptocurrencyExchanges 2 params → 200400401403404414429500
GET
/earliest_timestamp
Earliest timestamp
GetEarliestTimestamp 8 params → 200400401403404414429500
GET
/etfs
ETFs
GetEtf 14 params → 200400401403404414429500
GET
/exchange_schedule
Exchanges schedule
GetExchangeSchedule 4 params → 200400401403404414429500
GET
/exchanges
Exchanges
GetExchanges 7 params → 200400401403404414429500
GET
/forex_pairs
Forex pairs
GetForexPairs 7 params → 200400401403404414429500
GET
/funds
Funds
GetFunds 12 params → 200400401403404414429500
GET
/instrument_type
Instrument type
GetInstrumentType → 200400401403404414429500
GET
/intervals
Intervals List
GetIntervals → 200400401403404414429500
GET
/market_state
Market state
GetMarketState 3 params → 200400401403404414429500
GET
/stocks
Stocks
GetStocks 15 params → 200400401403404414429500
GET
/symbol_search
Symbol search
GetSymbolSearch 3 params → 200400401403404414429500
GET
/technical_indicators
Technical indicators
GetTechnicalIndicators → 200400401403404414429500
GET
/indices
List indices
listIndices 1 param → 200

Schemas 55

The contract defines 55 schemas that model the data the API accepts and returns. The most detailed are FundResponseItem (12 properties), StocksResponseItem (12 properties), EtfResponseItem (11 properties), SymbolSearchResponseItem (9 properties). Each schema is shown below with its type and property counts.

ExchangesResponseItemAccess
object
Info on which plan symbol is available (displayed then showplan is true)
3 properties 3 required
TypeEnum
string
ExchangeScheduleResponseItem
object
ExchangeScheduleResponseItem represents details of an exchange schedule
6 properties 6 required
GetTechnicalIndicators_200_response
object
2 properties 2 required
ExchangeScheduleSession
object
ExchangeScheduleSession represents a trading session
4 properties 4 required
BondsResponseItemAccess
object
Info on which plan symbol is available (displayed then showplan is true)
3 properties 3 required
GetCountries_200_response
object
1 property 1 required
ApiInternalServerErrorResponseBody
object
3 properties 3 required
GetCryptocurrencies_200_response
object
3 properties 3 required
TechnicalIndicatorsResponseMacdOutputValues
object
An array of output values
1 property
GetFunds_200_response
object
2 properties 2 required
ApiParameterTooLongErrorResponseBody
object
3 properties 3 required
TechnicalIndicatorsResponseMacdParameter
object
Input parameter name. Example values: seriestype , fastperiod , slowperiod , timeperiod , signalperiod
5 properties
GetEarliestTimestamp_200_response
object
2 properties 2 required
ApiForbiddenErrorResponseBody
object
3 properties 3 required
TechnicalIndicatorsResponseMacdOutputValue
object
Output parameter name. Example values: ad , add , adxr , aroonosc , macd , macdsignal , macdhist , etc
4 properties
CryptocurrencyExchangesResponseItem
object
1 property 1 required
EtfResponseItem_access
object
Info on which plan symbol is available (displayed then showplan is true)
3 properties 3 required
GetExchanges_200_response
object
2 properties 2 required
GetIntervals_200_response
object
2 properties 2 required
TechnicalIndicatorsResponseMacdTinting
object
An array of tinting values used for proper indicator coloring
5 properties
GetBonds_200_response_result
object
2 properties 2 required
IntervalEnum
string
EtfResponseItem
object
EtfResponseItem represents details of an ETF
11 properties 10 required
FormatEnum
string
ForexResponseItem
object
ForexResponseItem represents details of a forex pair
4 properties 4 required
GetBonds_200_response
object
2 properties 2 required
GetFunds_200_response_result
object
2 properties 2 required
CommoditiesResponseItem
object
CommoditiesResponseItem represents details of a commodity
4 properties 4 required
GetExchangeSchedule_200_response
object
1 property 1 required
ApiNotFoundErrorResponseBody
object
3 properties 3 required
GetCrossListings_200_response
object
1 property
GetForexPairs_200_response
object
3 properties 3 required
ApiTooManyRequestsErrorResponseBody
object
3 properties 3 required
BondResponseItem
object
BondResponseItem represents details of a bond
8 properties 7 required
ExchangesResponseItem
object
ExchangesResponseItem represents details of an exchange
6 properties 5 required
GetStocks_200_response
object
3 properties 3 required
GetEtf_200_response
object
3 properties 3 required
GetInstrumentType_200_response
object
2 properties 2 required
SymbolSearchResponseItem
object
SymbolSearchResponseItem represents details of a symbol search result
9 properties 8 required
GetSymbolSearch_200_response
object
2 properties 2 required
GetCryptocurrencyExchanges_200_response
object
2 properties 2 required
ApiBadRequestErrorResponseBody
object
3 properties 3 required
CryptocurrencyResponseItem
object
CryptocurrencyResponseItem represents details of a cryptocurrency
4 properties 4 required
CrossListingsResult
object
Represents the result of cross listings
2 properties 2 required
GetTechnicalIndicators_200_response_data_value
object
8 properties 5 required
SymbolSearchResponseItemAccess
object
Info on which plan symbol is available (displayed then showplan is true)
3 properties 3 required
MarketStateResponseItem
object
7 properties 7 required
TechnicalIndicatorsResponseMacdParameters
object
An array of input parameters for the indicator
1 property
StocksResponseItem
object
StocksResponseItem represents details of a stock instrument
12 properties 11 required
FundResponseItem
object
FundResponseItem represents details of a fund
12 properties 11 required
GetCommodities_200_response
object
3 properties 3 required
ApiUnauthorizedErrorResponseBody
object
3 properties 3 required
CountryResponseItem
object
CountryResponseItem represents details of a country
7 properties 7 required
CrossListingsItem
object
Represents details of a cross listing
4 properties 4 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

twelvedata-reference-data-api-openapi.yml Raw ↑

Other APIs Twelve Data publishes across the network.

Twelve Data WebSocket Streaming API
Twelve Data Core Data API
Twelve Data Fundamentals API
Twelve Data Technical Indicators API
Twelve Data Time Series API
Twelve Data Advanced API
Twelve Data Analysis API
Twelve Data Currencies API
Twelve Data Etfs API
Twelve Data Market Data API
Twelve Data Money Market Funds API
Twelve Data Mutual Funds API
Where this information came from

This is an independent, third-party profile of Twelve Data Reference Data API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.