LogoLogo
  • Kaiko Knowledge Hub
  • General
    • 👋Introduction
    • 🏎️Getting Started
      • API input
      • API output
        • "taker_side_sell" Explained
        • Market open and close
        • Timestamp
      • Authentication
      • Data versioning
      • Envelope
      • Error codes
      • Pagination
      • Rate limiting
  • Data Feeds
    • Introduction
    • Level 1 & Level 2 Data
      • Level 1 Aggregations
        • Trade Count, OHLCV, & VWAP
          • OHLCV only
          • VWAP only
      • Level 1 Tick-Level
        • All trades
        • Derivative liquidation events
        • Borrows, repayments, liquidations, and withdrawals
      • Level 2 Aggregations
        • Market depth (snapshot)
        • Market depth (aggregation)
        • Price slippage (snapshot)
        • Price slippage (aggregation)
        • Bid-ask spread (aggregation)
        • Tokens in a liquidity pool
          • Tokens in a liquidity pool (Uniswap v3)
        • Interest rates, borrowed and deposited amounts
        • Raw order book snapshot
          • Raw order book snapshot + market depth, bid/ask spread & price slippage
      • Level 2 Tick-Level
        • Mints and burns
    • Reference Data
      • Free tier
        • Asset codes
        • Exchange codes
        • Exchange trading pair codes (instruments)
        • Lending protocol codes
        • Blockchain codes
      • Advanced tier
        • Derivatives contract details
        • Derivatives price details
      • Premium tier
        • Market capitalization and circulating supply (BETA)
  • ANALYTICS Solutions
    • Introduction
    • Kaiko Fair Market Value
      • Kaiko Fair Market Value (Direct prices for high liquidity pairs)
      • Kaiko Fair Market Value (Synthetic prices for low liquidity pairs)
        • Convert with Oanda FX Rates
    • Kaiko Derivatives Risk Indicators
      • Exchange-provided metrics
      • Token-level liquidation volumes
      • Implied volatility calculation - smile
      • Implied volatility calculation - surface
    • Kaiko Portfolio Risk & Performance
      • Value at risk calculation
      • Custom valuation
  • Monitoring Solutions
    • Kaiko Market Explorer
      • Assets
      • Exchanges
    • Kaiko Blockchain Monitoring
      • Ethereum Wallets
        • Balances and transactions
      • Bitcoin Wallets
        • Balances
        • Transaction
      • Solana Wallets
        • Balances and transactions
      • Provenance Wallets
        • Balances and transactions
  • Misc & Legacy endpoints
    • CME
Powered by GitBook
On this page
  • What is this endpoint for?
  • Endpoint
  • Parameters
  • Fields
  • Request example
  • Response example

Was this helpful?

Export as PDF
  1. Data Feeds
  2. Reference Data
  3. Free tier

Exchange trading pair codes (instruments)

PreviousExchange codesNextLending protocol codes

Last updated 2 days ago

Was this helpful?

You can explore all exchanges, assets, and get codes for them using our . 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 instruments (exchange trading pairs) and their associated codes.

Endpoint

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

Parameters

Field
Required?
Description

exchange_code

No

base_asset

No

quote_asset

No

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

page_size

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_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

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

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

Response example

{
  "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
    },
    /* ... */
  ]
}

Exchange code. See

The desired base asset code. See

The desired quote asset code. See

See

Exchange code. See

Legacy slug for the exchange. See

instrument explorer
Exchange codes
Asset codes
Asset codes
Pagination
Exchange codes