Sign in
latestSwagger 2.02026-08-12187723.0 MB

c4a12725cdb5

reference_data

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.

get/stocks

Query parameters

symbolstring

The ticker symbol of an instrument for which data is requested

figistring

Filter by financial instrument global identifier (FIGI). This parameter is available on the <a href="https://twelvedata.com/pricing">Ultra</a> plan (individual) and the <a href="https://twelvedata.com/pricing-business">Enterprise</a> plan (business) and above.

isinstring

Filter by international securities identification number (ISIN). ISIN access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section

cusipstring

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section

cikstring

The CIK of an instrument for which data is requested

exchangestring

Filter by exchange name

mic_codestring

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

countrystring

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

type'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'

The asset class to which the instrument belongs

format'JSON' | 'CSV'

The format of the response data

delimiterstring

The separator used in the CSV response data

show_planboolean

Adds info on which plan symbol is available

include_delistedboolean

Include delisted identifiers

pageinteger

Page number of the results to fetch

outputsizeinteger

Determines the number of data points returned in the output

Response

countinteger required

Count

statusstring required

Response status

Example 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"
}