Twelve Data Reference Data API

Catalogs of instruments, exchanges, and supporting metadata.

Operations 19

GET /bonds Fixed income #
GET /commodities Commodities #
GET /countries Countries #
GET /cross_listings Cross listings #
GET /cryptocurrencies Cryptocurrency pairs #
GET /cryptocurrency_exchanges Cryptocurrency exchanges #
GET /earliest_timestamp Earliest timestamp #
GET /etfs ETFs #
GET /exchange_schedule Exchanges schedule #
GET /exchanges Exchanges #
GET /forex_pairs Forex pairs #
GET /funds Funds #
GET /instrument_type Instrument type #
GET /intervals Intervals List #
GET /market_state Market state #
GET /stocks Stocks #
GET /symbol_search Symbol search #
GET /technical_indicators Technical indicators #
GET /indices List indices #

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-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 email required.

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-reference-data-api-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:
- name: reference_data
paths:
  /bonds:
    get:
      description: 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.
      operationId: GetBonds
      parameters:
      - description: The ticker symbol of an instrument for which data is requested
        in: query
        name: symbol
        schema:
          type: string
          x-go-name: Symbol
        x-go-name: Symbol
        example: US2Y
      - description: Filter by exchange name
        in: query
        name: exchange
        schema:
          type: string
          x-go-name: Exchange
        x-go-name: Exchange
        example: NYSE
      - description: Filter by country name or alpha code, e.g., `United States` or `US`
        in: query
        name: country
        schema:
          type: string
          x-go-name: Country
        x-go-name: Country
        example: United States
      - description: The format of the response data
        in: query
        name: format
        schema:
          $ref: '#/components/schemas/FormatEnum'
        x-go-name: Format
      - description: The separator used in the CSV response data
        in: query
        name: delimiter
        schema:
          default: ;
          type: string
          x-go-name: Delimiter
        x-go-name: Delimiter
      - description: Adds info on which plan symbol is available
        in: query
        name: show_plan
        schema:
          default: false
          type: boolean
          x-go-name: ShowPlan
        x-go-name: ShowPlan
      - description: Page number of the results to fetch
        in: query
        name: page
        schema:
          default: 1
          format: int64
          type: integer
          x-go-name: Page
        x-go-name: Page
      - description: Determines the number of data points returned in the output
        in: query
        name: outputsize
        schema:
          default: 5000
          format: int64
          type: integer
          x-go-name: PageSize
        x-go-name: PageSize
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetBonds_200_response'
          description: ''
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiBadRequestErrorResponseBody'
          description: ''
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiUnauthorizedErrorResponseBody'
          description: ''
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiForbiddenErrorResponseBody'
          description: ''
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiNotFoundErrorResponseBody'
          description: ''
        '414':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiParameterTooLongErrorResponseBody'
          description: ''
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiTooManyRequestsErrorResponseBody'
          description: ''
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiInternalServerErrorResponseBody'
          description: ''
      summary: Fixed income
      tags:
      - reference_data
      x-api-credits-cost: '1'
      x-api-credits-type: request
      x-group: Reference data/Asset catalogs
      x-order: '70'
      x-url-hash: bonds-list
      security:
      - authorizationHeader:
        - '[]'
      - queryParameter:
        - '[]'
    servers:
    - url: https://api.twelvedata.com/
  /commodities:
    get:
      description: The commodities endpoint provides a daily updated list of available commodity pairs, across precious metals, livestock, softs, grains, etc.
      operationId: GetCommodities
      parameters:
      - description: The ticker symbol of an instrument for which data is requested
        in: query
        name: symbol
        schema:
          type: string
          x-go-name: Symbol
          x-order: '10'
        x-go-name: Symbol
        x-order: '10'
        example: XAU/USD
      - description: Filter by category of commodity
        in: query
        name: category
        schema:
          type: string
          x-go-name: Category
          x-order: '20'
        x-go-name: Category
        x-order: '20'
        example: Precious Metal
      - description: The format of the response data
        in: query
        name: format
        schema:
          $ref: '#/components/schemas/FormatEnum'
        x-go-name: Format
        x-order: '30'
      - description: The separator used in the CSV response data
        in: query
        name: delimiter
        schema:
          default: ;
          type: string
          x-go-name: Delimiter
          x-order: '40'
        x-go-name: Delimiter
        x-order: '40'
      - description: Page number of the results to fetch
        in: query
        name: page
        schema:
          default: 1
          format: int64
          type: integer
          x-go-name: Page
          x-order: '50'
        x-go-name: Page
        x-order: '50'
      - description: Determines the number of data points returned in the output
        in: query
        name: outputsize
        schema:
          format: int64
          type: integer
          x-go-name: PageSize
          x-order: '60'
        x-go-name: PageSize
        x-order: '60'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCommodities_200_response'
          description: ''
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiBadRequestErrorResponseBody'
          description: ''
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiUnauthorizedErrorResponseBody'
          description: ''
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiForbiddenErrorResponseBody'
          description: ''
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiNotFoundErrorResponseBody'
          description: ''
        '414':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiParameterTooLongErrorResponseBody'
          description: ''
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiTooManyRequestsErrorResponseBody'
          description: ''
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiInternalServerErrorResponseBody'
          description: ''
      summary: Commodities
      tags:
      - reference_data
      x-api-credits-cost: '1'
      x-api-credits-type: request
      x-group: Reference data/Asset catalogs
      x-order: '60'
      x-url-hash: commodities-list
      security:
      - authorizationHeader:
        - '[]'
      - queryParameter:
        - '[]'
    servers:
    - url: https://api.twelvedata.com/
  /countries:
    get:
      description: The countries endpoint provides a comprehensive list of countries, including their ISO codes, official names, capitals, and currencies. This data is essential for applications requiring accurate country information for tasks such as localization, currency conversion, or geographic analysis.
      operationId: GetCountries
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCountries_200_response'
          description: ''
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiBadRequestErrorResponseBody'
          description: ''
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiUnauthorizedErrorResponseBody'
          description: ''
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiForbiddenErrorResponseBody'
          description: ''
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiNotFoundErrorResponseBody'
          description: ''
        '414':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiParameterTooLongErrorResponseBody'
          description: ''
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiTooManyRequestsErrorResponseBody'
          description: ''
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiInternalServerErrorResponseBody'
          description: ''
      summary: Countries
      tags:
      - reference_data
      x-api-credits-cost: '1'
      x-api-credits-type: request
      x-group: Reference data/Supporting metadata
      x-order: '10'
      x-url-hash: countries
      security:
      - authorizationHeader:
        - '[]'
      - queryParameter:
        - '[]'
    servers:
    - url: https://api.twelvedata.com/
  /cross_listings:
    get:
      description: The cross_listings endpoint provides a daily updated list of cross-listed symbols for a specified financial instrument. Cross-listed symbols represent the same security available on multiple exchanges. This endpoint is useful for identifying all the exchanges where a particular security is traded, allowing users to access comprehensive trading information across different markets.
      operationId: GetCrossListings
      parameters:
      - description: The ticker symbol of an instrument for which data is requested
        in: query
        name: symbol
        required: true
        schema:
          type: string
          x-go-name: Symbol
          x-order: '10'
        x-go-name: Symbol
        x-order: '10'
        example: AAPL
      - description: Exchange where instrument is traded
        in: query
        name: exchange
        schema:
          type: string
          x-go-name: Exchange
          x-order: '20'
        x-go-name: Exchange
        x-order: '20'
        example: NASDAQ
      - description: Market identifier code (MIC) under ISO 10383 standard
        in: query
        name: mic_code
        schema:
          type: string
          x-go-name: MicCode
          x-order: '30'
        x-go-name: MicCode
        x-order: '30'
        example: XNGS
      - description: Country to which stock exchange belongs to
        in: query
        name: country
        schema:
          type: string
          x-go-name: Country
          x-order: '40'
        x-go-name: Country
        x-order: '40'
        example: United States
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCrossListings_200_response'
          description: ''
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiBadRequestErrorResponseBody'
          description: ''
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiUnauthorizedErrorResponseBody'
          description: ''
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiForbiddenErrorResponseBody'
          description: ''
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiNotFoundErrorResponseBody'
          description: ''
        '414':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiParameterTooLongErrorResponseBody'
          description: ''
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiTooManyRequestsErrorResponseBody'
          description: ''
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiInternalServerErrorResponseBody'
          description: ''
      summary: Cross listings
      tags:
      - reference_data
      x-api-credits-cost: '40'
      x-api-credits-type: request
      x-group: Reference data/Discovery
      x-order: '20'
      x-starting-plan: grow,venture
      x-url-hash: cross-listings
      security:
      - authorizationHeader:
        - '[]'
      - queryParameter:
        - '[]'
    servers:
    - url: https://api.twelvedata.com/
  /cryptocurrencies:
    get:
      description: 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.
      operationId: GetCryptocurrencies
      parameters:
      - description: The ticker symbol of an instrument for which data is requested
        in: query
        name: symbol
        schema:
          type: string
          x-go-name: Symbol
        x-go-name: Symbol
        example: BTC/USD
      - description: Filter by exchange name. E.g. `Binance`, `Coinbase`, etc.
        in: query
        name: exchange
        schema:
          type: string
          x-go-name: Exchange
        x-go-name: Exchange
        example: Binance
      - description: Filter by currency base
        in: query
        name: currency_base
        schema:
          type: string
          x-go-name: CurrencyBase
        x-go-name: CurrencyBase
        example: BTC
      - description: Filter by currency quote
        in: query
        name: currency_quote
        schema:
          type: string
          x-go-name: CurrencyQuote
        x-go-name: CurrencyQuote
        example: USD
      - description: The format of the response data
        in: query
        name: format
        schema:
          $ref: '#/components/schemas/FormatEnum'
        x-go-name: Format
      - description: The separator used in the CSV response data
        in: query
        name: delimiter
        schema:
          default: ;
          type: string
          x-go-name: Delimiter
        x-go-name: Delimiter
      - description: Page number of the results to fetch
        in: query
        name: page
        schema:
          default: 1
          format: int64
          type: integer
          x-go-name: Page
        x-go-name: Page
      - description: Determines the number of data points returned in the output
        in: query
        name: outputsize
        schema:
          format: int64
          type: integer
          x-go-name: PageSize
        x-go-name: PageSize
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCryptocurrencies_200_response'
          description: ''
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiBadRequestErrorResponseBody'
          description: ''
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiUnauthorizedErrorResponseBody'
          description: ''
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiForbiddenErrorResponseBody'
          description: ''
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiNotFoundErrorResponseBody'
          description: ''
        '414':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiParameterTooLongErrorResponseBody'
          description: ''
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiTooManyRequestsErrorResponseBody'
          description: ''
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiInternalServerErrorResponseBody'
          description: ''
      summary: Cryptocurrency pairs
      tags:
      - reference_data
      x-api-credits-cost: '1'
      x-api-credits-type: request
      x-group: Reference data/Asset catalogs
      x-order: '30'
      x-url-hash: cryptocurrencies-list
      security:
      - authorizationHeader:
        - '[]'
      - queryParameter:
        - '[]'
    servers:
    - url: https://api.twelvedata.com/
  /cryptocurrency_exchanges:
    get:
      description: The cryptocurrency exchanges endpoint provides a daily updated list of available cryptocurrency exchanges. It returns an array containing details about each exchange, such as exchange names and identifiers.
      operationId: GetCryptocurrencyExchanges
      parameters:
      - description: The format of the response data
        in: query
        name: format
        schema:
          $ref: '#/components/schemas/FormatEnum'
        x-go-name: Format
        x-order: '10'
      - description: Specify the delimiter used when downloading the CSV file
        in: query
        name: delimiter
        schema:
          default: ;
          type: string
          x-go-name: Delimiter
          x-order: '20'
        x-go-name: Delimiter
        x-order: '20'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCryptocurrencyExchanges_200_response'
          description: ''
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiBadRequestErrorResponseBody'
          description: ''
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiUnauthorizedErrorResponseBody'
          description: ''
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiForbiddenErrorResponseBody'
          description: ''
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiNotFoundErrorResponseBody'
          description: ''
        '414':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiParameterTooLongErrorResponseBody'
          description: ''
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiTooManyRequestsErrorResponseBody'
          description: ''
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiInternalServerErrorResponseBody'
          description: ''
      summary: Cryptocurrency exchanges
      tags:
      - reference_data
      x-api-credits-cost: '1'
      x-api-credits-type: request
      x-group: Reference data/Markets
      x-order: '30'
      security:
      - authorizationHeader:
        - '[]'
      - queryParameter:
        - '[]'
    servers:
    - url: https://api.twelvedata.com/
  /earliest_timestamp:
    get:
      description: The earliest_timestamp endpoint provides the earliest available date and time for a specified financial instrument at a given data interval. This endpoint is useful for determining the starting point of historical data availability for various assets, such as stocks or currencies, allowing users to understand the time range covered by the data.
      operationId: GetEarliestTimestamp
      parameters:
      - description: Symbol ticker of the instrument.
        in: query
        name: symbol
        schema:
          type: string
          x-go-name: Symbol
          x-order: '10'
          x-required-group: symbol
        x-go-name: Symbol
        x-order: '10'
        x-required-group: symbol
        example: AAPL
      - description: 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.
        in: query
        name: figi
        schema:
          type: string
          x-go-name: Figi
          x-order: '20'
          x-required-group: symbol
        x-go-name: Figi
        x-order: '20'
        x-required-group: symbol
        example: BBG000B9XRY4
      - description: 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
        in: query
        name: isin
        schema:
          type: string
          x-go-name: Isin
          x-order: '25'
          x-required-group: symbol
        x-go-name: Isin
        x-order: '25'
        x-required-group: symbol
        example: US0378331005
      - description: 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
        in: query
        name: cusip
        schema:
          type: string
          x-go-name: Cusip
          x-order: '26'
          x-required-group: symbol
        x-go-name: Cusip
        x-order: '26'
        x-required-group: symbol
        example: '594918104'
      - description: Interval between two consecutive points in time series.
        in: query
        name: interval
        required: true
        schema:
          $ref: '#/components/schemas/IntervalEnum'
        x-go-name: Interval
        x-order: '30'
        example: 1day
      - description: Exchange where instrument is traded.
        in: query
        name: exchange
        schema:
          type: string
          x-go-name: Exchange
          x-order: '40'
        x-go-name: Exchange
        x-order: '40'
        example: Nasdaq
      - description: Market Identifier Code (MIC) under ISO 10383 standard.
        in: query
        name: mic_code
        schema:
          type: string
          x-go-name: MicCode
          x-order: '50'
        x-go-name: MicCode
        x-order: '50'
        example: XNAS
      - description: 'Timezone at which output datetime will be displayed. Supports:

          <ul>

          <li>1. <code>Exchange</code> for local exchange time</li>

          <li>2. <code>UTC</code> for datetime at universal UTC standard</li>

          <li>3. Timezone name according to the IANA Time Zone Database. E.g. <code>America/New_York</code>, <code>Asia/Singapore</code>. Full list of timezones can be found <a href="https://en.wikipedia.org/wiki/List_of_tz_database_time_zones" target="blank">here</a>.</li>

          </ul>

          <p>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.</p>

          <i>Take note that the IANA Timezone name is case-sensitive</i>'
        in: query
        name: timezone
        schema:
          default: Exchange
          type: string
          x-go-name: Timezone
        x-go-name: Timezone
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetEarliestTimestamp_200_response'
          description: ''
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiBadRequestErrorResponseBody'
          description: ''
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiUnauthorizedErrorResponseBody'
          description: ''
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiForbiddenErrorResponseBody'
          description: ''
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiNotFoundErrorResponseBody'
          description: ''
        '414':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiParameterTooLongErrorResponseBody'
          description: ''
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiTooManyRequestsErrorResponseBody'
          description: ''
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiInternalServerErrorResponseBody'
          description: ''
      summary: Earliest timestamp
      tags:
      - reference_data
      x-api-credits-cost: '1'
      x-api-credits-type: request
      x-group: Reference data/Discovery
      x-order: '30'
      x-required:
        anyOf:
        - required:
          - symbol
          - figi
          - isin
          - cusip
      security:
      - authorizationHeader:
        - '[]'
      - queryParameter:
        - '[]'
    servers:
    - url: https://api.twelvedata.com/
  /etfs:
    get:
      description: 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.
      operationId: GetEtf
      parameters:
      - description: The ticker symbol of an instrument for which data is requested
        in: query
        name: symbol
        schema:
          type: string
          x-go-name: Symbol
        x-go-name: Symbol
        example: SPY
      - description: 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.
        in: query
        name: figi
        schema:
          type: string
          x-go-name: Figi
        x-go-name: Figi
        example: BBG000BDTF76
      - description: 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
        in: query
        name: isin
        schema:
          type: string
          x-go-name: Isin
        x-go-name: Isin
        example: US0378331005
      - description: 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
        in: query
        name: cusip
        schema:
          type: string
          x-go-name: Cusip
        x-go-name: Cusip
        example: '594918104'
      - description: The CIK of an instrument for which data is requested
        in: query
        name: cik
        schema:
          type: string
          x-go-name: Cik
        x-go-name: Cik
        example: '95953'
      - description: Filter by exchange name
        in: query
        name: exchange
        schema:
          type: string
          x-go-name: Exchange
        x-go-name: Exchange
        example: NYSE
      - description: Filter by market identifier code (MIC) under ISO 10383 standard
        in: query
        name: mic_code
        schema:
          type: string
          x-go-name: MicCode
        x-go-name: MicCode
        example: XNYS
      - description: Filter by country name or alpha code, e.g., `United States` or `US`
        in: query
        name: country
        schema:
          type: string
          x-go-name: Country
        x-go-name: Country
        example: United States
      - description: The format of the response data
        in: query
        name: format
        schema:
          $ref: '#/components/schemas/FormatEnum'
        x-go-name: Format
      - description: The separator used in the CSV response data
        in: query
        name: delimiter
        schema:
          default: ;
          type: string
          x-go-name: Delimiter
        x-go-name: Delimiter
      - description: Adds info on which plan symbol is available
        in: query
        name: show_plan
        schema:
          default: false
          type: boolean
          x-go-name: ShowPlan
        x-go-name: ShowPlan
      - description: Include delisted identifiers
        in: query
        name: include_delisted
        schema:
          default: false
          type: boolean
          x-go-name: IncludeDelisted
        x-go-name: IncludeDelisted
      - description: Page number of the results to fetch
        in: query
        name: page
        schema:
          default: 1
          format: int64
          type: integer
          x-go-name: Page
        x-go-name: Page
      - description: Determines the number of data points returned in the output
        in: query
        name: outputsize
        schema:
          format: int64
          type: integer
          x-go-name: PageSize
        x-go-name: PageSize
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetEtf_200_response'
          description: ''
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiBadRequestErrorResponseBody'
          description: ''
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiUnauthorizedErrorResponseBody'
          description: ''
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiForbiddenErrorResponseBody'
          description: ''
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiNotFoundErrorResponseBody'
          description: ''
        '414':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiParameterTooLongErrorResponseBody'
          description: ''
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiTooManyRequestsErrorResponseBody'
          description: ''
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiInternalServerErrorResponseBody'
          de

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