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.
What is this endpoint for?
This endpoint retrieves information on either all or specific supported instruments.
Endpoint
Parameters
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.
page_size
No
Maximum number of records to return in one response
orderBy
No
Order results by a specifit 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
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 Exchanges
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 Exchanges
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 od the "base_asset" as reported by the exchange.
Note: some exchanges reverse the ordering of base/quote in their pair codes.
Request example
Response example
Last updated