# Exchange trading pair codes (instruments) {% hint style="info" %} You can explore all exchanges, assets, and get codes for them using our [instrument explorer](https://instruments.kaiko.com/#/instruments). Alternatively, if you want to obtain the data in a more programmatic way, use this endpoint. {% endhint %} ### 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 [exchange-codes](https://docs.kaiko.com/rest-api/data-feeds/reference-data/basic-tier/exchange-codes "mention") | | `base_asset` | No | The desired base asset `code`. See [asset-codes](https://docs.kaiko.com/rest-api/data-feeds/reference-data/basic-tier/asset-codes "mention") | | `quote_asset` | No | The desired quote asset `code`. See [asset-codes](https://docs.kaiko.com/rest-api/data-feeds/reference-data/basic-tier/asset-codes "mention") | | `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 [pagination](https://docs.kaiko.com/rest-api/general/getting-started/pagination "mention") | | `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. | {% hint style="info" %} **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` {% endhint %} ### 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-codes](https://docs.kaiko.com/rest-api/data-feeds/reference-data/basic-tier/exchange-codes "mention") | | `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 [Broken link](https://docs.kaiko.com/rest-api/data-feeds/reference-data/basic-tier/broken-reference "mention") | | `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). | {% hint style="warning" %} 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. {% endhint %} ### Request example {% tabs %} {% tab title="cURL" %} {% code overflow="wrap" %} ```url curl --compressed -H 'Accept: application/json' 'https://reference-data-api.kaiko.io/v1/instruments' ``` {% endcode %} {% endtab %} {% endtabs %} ### Response example {% tabs %} {% tab title="JSON" %} {% code fullWidth="false" %} ```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 }, /* ... */ ] } ``` {% endcode %} {% endtab %} {% endtabs %}