Twelve Data

Twelve Data Reference Data API

Catalogs of instruments, exchanges, and supporting metadata.

GitHub OpenAPI

Operations 19

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /bonds List available bonds · Fixed income #
Ask an LLM
“Which bonds and fixed income instruments are available?”
“Can I filter the bond list by country?”
Tell an agent
List available bonds.
Show fixed income instruments in {country}.
GET /commodities List available commodity pairs · Commodities #
Ask an LLM
“What commodities can I get prices for, like gold or wheat?”
“Which commodity pairs fall under the precious metals category?”
Tell an agent
List all commodity pairs.
Show commodities in the {category} category.
GET /countries List countries with ISO codes and currencies · Countries #
Ask an LLM
“What ISO country codes and currencies are supported?”
“Where can I get a list of countries with their capitals?”
Tell an agent
List all countries with their ISO codes.
Show each country's official name, capital and currency.
GET /cross_listings Find other exchanges where a security is listed · Cross listings #
Ask an LLM
“On which other exchanges is this stock also traded?”
“Is this security cross-listed outside its home market?”
Tell an agent
Find cross-listings for {symbol}.
List every exchange where {symbol} from {exchange} also trades.
GET /cryptocurrencies List available cryptocurrency pairs · Cryptocurrency pairs #
Ask an LLM
“Which crypto pairs quoted in USD are available?”
“What cryptocurrencies are supported on a given exchange?”
Tell an agent
List all cryptocurrency pairs.
Show crypto pairs with base {currency_base} and quote {currency_quote}.
GET /cryptocurrency_exchanges List supported cryptocurrency exchanges · Cryptocurrency exchanges #
Ask an LLM
“Which crypto exchanges does the data come from?”
“Can I get the list of cryptocurrency exchanges as CSV?”
Tell an agent
List the supported cryptocurrency exchanges.
Export the crypto exchanges list in {format} format.
GET /earliest_timestamp Find how far back data goes for an instrument · Earliest timestamp #
Ask an LLM
“How far back does 1-minute history go for this stock?”
“What is the first date available for an instrument's daily data?”
Tell an agent
Find the earliest {interval} timestamp for {symbol}.
Tell me when {interval} history starts for {symbol} on {exchange}.
GET /etfs List all available ETFs · ETFs #
Ask an LLM
“Which ETFs are tradable on a particular exchange?”
“Can I include delisted ETFs in the reference list?”
Tell an agent
List all ETFs on {exchange}.
Show ETFs in {country} including delisted ones set to {include_delisted}.
GET /exchange_schedule Get exchange trading hours and days · Exchanges schedule #
Ask an LLM
“What are the trading hours of an exchange?”
“Is a given exchange open on a particular date?”
Tell an agent
Show the trading schedule for {mic_code}.
Get exchange hours in {country} on {date}.
GET /exchanges List available equity exchanges · Exchanges #
Ask an LLM
“Which stock exchanges are covered, with their codes and timezones?”
“What equity exchanges are available in a given country?”
Tell an agent
List all equity exchanges.
Show equity exchanges in {country}.
GET /forex_pairs List available forex currency pairs · Forex pairs #
Ask an LLM
“Which currency pairs can I query?”
“Are pairs with the Japanese yen as the quote currency available?”
Tell an agent
List all forex pairs.
Show forex pairs with base currency {currency_base}.
GET /funds List available investment funds · Funds #
Ask an LLM
“What investment funds are in the reference catalog?”
“Can I look up a fund by CIK or ISIN in the funds list?”
Tell an agent
List investment funds in {country}.
Find the fund with CIK {cik}.
GET /instrument_type List financial instrument types · Instrument type #
Ask an LLM
“What instrument types are supported, like stocks, ETFs or crypto?”
“Which asset class values can I use as a type filter?”
Tell an agent
List all instrument types.
Show the available asset class categories.
GET /intervals List supported time intervals · Intervals List #
Ask an LLM
“Which bar intervals can I request, like 1min or 1day?”
“Is a 45-minute interval supported for time series?”
Tell an agent
List the supported time intervals.
Show every interval I can use when querying price data.
GET /market_state Check which exchanges are open and time to next session · Market state #
Ask an LLM
“How long until a stock exchange opens?”
“Which exchanges in a country are trading at this moment?”
Tell an agent
Show the market state for {exchange}.
List open and closed exchanges in {country}.
GET /stocks List available stock symbols · Stocks #
Ask an LLM
“Which stock symbols trade on a given exchange?”
“Can I get the full list of tickers including delisted ones?”
Tell an agent
List stocks on {exchange}.
Show stock symbols in {country} of type {type}.
GET /symbol_search Search instruments by name or ticker · Symbol search #
Ask an LLM
“What ticker does a company I only know by name trade under?”
“Can I search for instruments that match a partial name?”
Tell an agent
Search for instruments matching {symbol}.
Find the top {outputsize} symbols matching {symbol}.
GET /technical_indicators List the technical indicator catalog · Technical indicators #
Ask an LLM
“Which technical analysis indicators are offered?”
“Where do I see each indicator's inputs and outputs?”
Tell an agent
List the available technical indicators.
Show each indicator and its configurable parameters.
GET /indices List available market indices · List indices #
Ask an LLM
“Which market indices are covered?”
“Can I get the catalog of stock indices?”
Tell an agent
List all available market indices.
Show the index catalog.

Documentation

📖
Documentation
https://twelvedata.com/docs#time-series
📖
Documentation
https://twelvedata.com/docs#core-data
📖
Documentation
https://twelvedata.com/docs#technical-indicators
📖
Documentation
https://twelvedata.com/docs#reference-data
📖
Documentation
https://twelvedata.com/docs#fundamentals

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/twelvedata/refs/heads/main/openapi/twelvedata-reference-data-api-openapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/twelvedata/refs/heads/main/overlays/twelvedata-reference-data-api-overlay.yaml
🔗
PostmanCollection
https://raw.githubusercontent.com/api-evangelist/twelvedata/refs/heads/main/collections/twelvedata.postman_collection.json
🔗
OpenCollection
https://raw.githubusercontent.com/api-evangelist/twelvedata/refs/heads/main/collections/twelvedata.opencollection.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/twelvedata:twelvedata-reference-data-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

twelvedata-reference-data-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Twelvedata Reference Data API
  version: '1.0'
  description: 'Operations tagged reference_data across 2 of this provider''s published API definitions: twelvedata-openapi-original.json, twelvedata-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.twelvedata.com/
- url: https://api.twelvedata.com
  description: Twelve Data REST base URL
tags:


# --- truncated at 32 KB (127 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/twelvedata/refs/heads/main/openapi/twelvedata-reference-data-api-openapi.yml