v3

latestOpenAPI 3.0.02026-07-311784111.3 MB
Market Data
Public

Retrieves available trading instruments. This method can be used to see which instruments are available for trading, or which instruments have recently expired.

Note - This method has distinct API rate limiting requirements: Sustained rate: 1 request/second. To avoid rate limits, we recommend using either the REST requests for server-cached data or the WebSocket subscription to instrument_state.{kind}.{currency} for real-time updates. For more information, see Rate Limits.

Results can be filtered by currency and instrument kind (future, option, etc.). Set the expired parameter to true to retrieve recently expired instruments instead of active ones. Each instrument includes the underlying_type field indicating the underlying asset class (such as crypto, equity, or commodity).

Try in API console

get/public/get_instruments

Query parameters

currency'BTC' | 'ETH' | 'USDC' | 'USDT' | 'EURR' | 'any' required

Currency name or "any" if don't care

The currency symbol or "any" for all

kind'future' | 'option' | 'spot' | 'future_combo' | 'option_combo'

Instrument kind: "future", "option", "spot", "future_combo", "option_combo"

Instrument kind, if not provided instruments of all kinds are considered

expiredboolean

Set to true to show recently expired instruments instead of active ones.

Response

Success response

jsonrpc'2.0' required

The JSON-RPC version (2.0)

idinteger

The id that was sent in the request

Example response

{
  "result": [
    {
      "min_trade_amount": 0.1,
      "instrument_name": "BTC-PERPETUAL",
      "creation_timestamp": 1536569522277,
      "tick_size": 0.0001,
      "contract_size": 1,
      "lot_size": 10,
      "maker_commission": 0.0001,
      "taker_commission": 0.0005,
      "max_liquidation_commission": 0.001,
      "block_trade_commission": 0.0005,
      "block_trade_tick_size": 0.01,
      "block_trade_min_trade_amount": 25,
      "max_leverage": 100,
      "price_index": "btc_usdc",
      "base_currency_uuid": "5b71fc48-3dd3-540c-809b-f8c94d0e68b5",
      "quote_currency_uuid": "2b92315d-eab7-5bef-84fa-089a131333f5",
      "qty_tick_size": 1,
      "index_id": 2000033,
      "product_group": "ETH"
    }
  ]
}