Exchange trading pair codes (instruments)

You can explore all exchanges, assets, and get codes for them using our instrument explorer. Alternatively, if you want to obtain the data in a more programmatic way, use this endpoint.

This data is included in the following Kaiko packages:

• Reference Data [Basic Tier]
• Reference Data [Advanced Tier]

What is this endpoint for?

This endpoint retrieves information on instruments (exchange trading pairs) and their associated codes.

Endpoint

https://reference-data-api.kaiko.io/v1/instruments

Parameters

Field	Required?	Description
exchange_code	No	Exchange code. See
base_asset	No	The desired base asset code. See
quote_asset	No	The desired quote asset code. See
code	No	Kaiko identifier for the instrument. Always base_asset-quote_asset for spot instruments.
kaiko_legacy_symbol	No	Kaiko legacy instrument symbol.
class	No	spot, future, perpetual-future, option, etc.
base_asset_class	No	Base asset class.
quote_asset_class	No	Quote asset class.
trade_start_timestamp	No	Starting time in ISO 8601 (inclusive).
trade_end_timestamp	No	Ending time in ISO 8601 (inclusive). Can also use "ongoing" to get ongoing instruments.
trade_count_min	No	Minimum number of trades.
trade_count_max	No	Maximum number of trades.
with_list_pools	No	true or false. For pairs traded on DEXs, provides the list of underlying pools to each instrument.
continuation_token	No	See
limit	No	Maximum number of records to return in one response
orderBy	No	Order results by a specific field. See below for all possible values.
order	No	Return the data in ascending (1) or descending (-1) order
blockchain	No	Filter on a specific blockchain for on-chain instruments.

You can order your request by: exchange_code, class, kaiko_legacy_symbol, trade_start_timestamp, trade_end_timestamp, trade_count, base_asset, quote_asset, code, trade_count_min, trade_count_max

Repeated parameters All parameters, except for trade_count_min/max, trade_start/end_timestamp can be repeated in the URL to filter. For example to get instruments for coinbase & deribit, the request would be instruments?exchange_code=cbse&exchange_code=drbt

Fields

Field	Description
base_asset	Base asset.
class	spot, future, perpetual-future,...
code	Kaiko identifier for the instrument. Always base_asset-quote_asset for spot instruments.
exchange_code	Exchange code. See
exchange_pair_code	Identifier for the instrument used by the exchange. For perpetual futures pairs, the code may differ from the exchange's and include a _perp suffix (e.g., btcusdt_perp).
kaiko_legacy_exchange_slug	Legacy slug for the exchange. See
kaiko_legacy_symbol	Identifier used in past deliveries of historical market data and Data Feed.
quote_asset	Quote asset
trade_start_time	Time of the first available trade in Kaiko's data set.
trade_start_timestamp	Timestamp of the first available trade in Kaiko's data set.
trade_end_time	Time of the last available trade in Kaiko's data set. null if instrument is still active
trade_end_timestamp	Timestamp of the last available trade in Kaiko's data set. null if instrument is still active
trade_count	The total number of trades available through Kaiko Rest API and Kaiko Stream. For active pairs, this is an approximation.
trade_compressed_size	Approximate size in bytes of all available trades in Kaiko Stream.
list_pools	The list of the underlying pools to each instrument. (Only when arg with_list_pools=true is provided).

Some exchanges may refer to "base" and "quote" currencies differently.

• When we report the "price" of a trade, we're referring to the "base_asset" price as reported by the exchange.
• When we report the "volume" involved in a trade, we're referring to volume of the "base_asset" as reported by the exchange.

Note: some exchanges reverse the ordering of base/quote in their pair codes.

Request example

cURL

curl --compressed -H 'Accept: application/json' 'https://reference-data-api.kaiko.io/v1/instruments'

Response example

JSON

{
  "result": "success",
  "data": [
    {
      "kaiko_legacy_exchange_slug": "bf",
      "trade_start_time": "2017-08-09T23:36:33.0000000Z",
      "trade_end_time": null,
      "code": "xmr-btc",
      "exchange_code": "bfnx",
      "exchange_pair_code": "XMRBTC",
      "base_asset": "xmr",
      "quote_asset": "btc",
      "kaiko_legacy_symbol": "xmrbtc",
      "class": "spot",
      "trade_start_timestamp": 1502321793000,
      "trade_end_timestamp": null,
      "trade_count": 2439870,
      "trade_compressed_size": 35037071
    },
    {
      "kaiko_legacy_exchange_slug": "kk",
      "trade_start_time": "2017-08-08T20:10:04.0000000Z",
      "trade_end_time": null,
      "code": "gno-eth",
      "exchange_code": "krkn",
      "exchange_pair_code": "GNOETH",
      "base_asset": "gno",
      "quote_asset": "eth",
      "kaiko_legacy_symbol": "gnoeth",
      "class": "spot",
      "trade_start_timestamp": 1502223004345,
      "trade_end_timestamp": null,
      "trade_count": 380822,
      "trade_compressed_size": 21119034
    },
    /* ... */
  ]
}