Messages
{
"jsonrpc": "2.0",
"method": "public/subscribe",
"id": 42,
"params": {
"channels": [
"instrument.creation.(kind).(currency)"
]
}
}{
"data": {
"tick_size": 0.0005,
"tick_size_steps": [
{
"above_price": 120,
"tick_size": 0.001
}
],
"taker_commission": 0.0003,
"strike": 16000,
"settlement_period": "week",
"settlement_currency": "BTC",
"quote_currency": "BTC",
"price_index": "btc_usd",
"index_id": 1000033,
"product_group": "BTC",
"option_type": "put",
"min_trade_amount": 0.1,
"maker_commission": 0.0003,
"kind": "option",
"is_active": true,
"instrument_name": "BTC-13JAN23-16000-P",
"instrument_id": 144613,
"expiration_timestamp": 1673596800000,
"creation_timestamp": 1671696002000,
"timestamp": 1671696002000,
"counter_currency": "USD",
"contract_size": 1,
"lot_size": 1,
"block_trade_tick_size": 0.0001,
"block_trade_min_trade_amount": 25,
"block_trade_commission": 0.00015,
"base_currency": "BTC",
"state": "open"
}
}Market Data
instrument.creation.(kind).(currency)
Notification published once when an instrument is created, carrying full instrument data in the same format as public/get_instruments.
The notification fires exactly once at creation time, regardless of the instrumentβs initial state.
Subscription examples:
| Channel | Description |
|---|---|
instrument.creation.any.any | All instruments |
instrument.creation.future.BTC | BTC futures only |
instrument.creation.option.any | All options |
π Related Article: Options Data Collection Best Practices
Messages
{
"jsonrpc": "2.0",
"method": "public/subscribe",
"id": 42,
"params": {
"channels": [
"instrument.creation.(kind).(currency)"
]
}
}{
"data": {
"tick_size": 0.0005,
"tick_size_steps": [
{
"above_price": 120,
"tick_size": 0.001
}
],
"taker_commission": 0.0003,
"strike": 16000,
"settlement_period": "week",
"settlement_currency": "BTC",
"quote_currency": "BTC",
"price_index": "btc_usd",
"index_id": 1000033,
"product_group": "BTC",
"option_type": "put",
"min_trade_amount": 0.1,
"maker_commission": 0.0003,
"kind": "option",
"is_active": true,
"instrument_name": "BTC-13JAN23-16000-P",
"instrument_id": 144613,
"expiration_timestamp": 1673596800000,
"creation_timestamp": 1671696002000,
"timestamp": 1671696002000,
"counter_currency": "USD",
"contract_size": 1,
"lot_size": 1,
"block_trade_tick_size": 0.0001,
"block_trade_min_trade_amount": 25,
"block_trade_commission": 0.00015,
"base_currency": "BTC",
"state": "open"
}
}kind
type:enum
required
Instrument kind
Allowed values: future, option, spot, future_combo, option_combo
Available options:
future, option, spot, future_combo, option_combocurrency
type:enum
required
Currency code or any for all
Allowed values: BTC, ETH, USDC, USDT, EURR, any
Available options:
BTC, ETH, USDC, USDT, EURR, anySubscription Request
type:object
Client sends subscription request to subscribe to notification channel. Please refer to Notification page for more information.
Subscription Notification Data
type:object
Server sends subscription notification data
data
type:object
required
The actual notification data
Related topics
Options Data CollectionSpot Trading: Deribit and Coinbase-Routed InstrumentsJSON-RPC API Changelogpublic/get_instrumentspublic/get_instrumentWas this page helpful?