instruments Channel

Subscribe to real-time updates when the list of available trading instruments changes (new expirations added, instruments expired and removed).

Parameter	Required	Description
`market`	No	Base token filter: `"BTC"`, `"ETH"`, or `"ARB"`. If omitted, subscribes to all markets.

Single market:

{
  "type": "subscribe",
  "subscriptions": [
    {
      "channel": "instruments",
      "query": {
        "market": "BTC"
      }
    }
  ]
}

All markets:

{
  "type": "subscribe",
  "subscriptions": [
    {
      "channel": "instruments",
      "query": {}
    }
  ]
}

Event: instruments

Emitted when the list of available trading instruments is updated.

{
  "kind": "event",
  "type": "instruments",
  "timestamp_ms": 1677721600000,
  "data": {
    "updated_at": 1677721600000,
    "instruments": [
      "BTC_USDC-PERPETUAL",
      "BTC_USDC-31OCT25-130000-C",
      "BTC_USDC-31OCT25-130000-P",
      "BTC_USDC-31OCT25-135000-C",
      "BTC_USDC-31OCT25-135000-P",
      "BTC_USDC-30NOV25-140000-C",
      "BTC_USDC-30NOV25-140000-P"
    ]
  },
  "subscription": {
    "channel": "instruments",
    "query": {
      "market": "BTC"
    }
  }
}

Field	Type	Description
`data.updated_at`	number	Unix timestamp in milliseconds of when the instrument list was last updated
`data.instruments`	string[]	Array of instrument names currently available for trading

Notes

Initial subscription provides a snapshot of all current instruments for the specified market(s)
Subsequent events are sent only when the instrument list changes
The instruments array includes both options and perpetuals for the specified market
If no market is specified in the query, you'll receive separate events for each market (BTC, ETH, ARB)

Use Cases

Monitor when new option expirations become available
Track when instruments expire and are removed
Keep your trading application's instrument list synchronized with the exchange
Receive immediate notification when new trading instruments become available