{
"jsonrpc": "2.0",
"method": "public/subscribe",
"id": 42,
"params": {
"channels": [
"trades.BTC-PERPETUAL.100ms"
]
}
}{
"data": [
{
"trade_seq": 30289442,
"trade_id": "48079269",
"timestamp": 1590484512188,
"tick_direction": 2,
"price": 8950,
"mark_price": 8948.9,
"instrument_name": "BTC-PERPETUAL",
"index_price": 8955.88,
"direction": "sell",
"amount": 10,
"contracts": 1
},
{
"trade_seq": 30289443,
"trade_id": "48079270",
"timestamp": 1590484513004,
"tick_direction": 0,
"price": 8960,
"mark_price": 8948.9,
"instrument_name": "BTC-PERPETUAL",
"index_price": 8955.88,
"direction": "buy",
"amount": 20,
"contracts": 2,
"liquidation": "T"
}
]
}trades.(instrument_name).(interval)
Trade notifications for a specific instrument.
Use this channel to receive executed trades as they happen for the given instrument. The interval controls how frequently trade events are aggregated.
Note: Block RFQ trades with delayed publication are sent when they are published (block_delayed), with their original timestamp and trade_seq, so they can arrive out of sequence.
Note: For spot instruments routed to Coinbase Exchange, this channel is not supported. Use the matches channel for the full trade tape. For user trades, orders and changes, use the user channels.
📖 Related Article: Spot Trading: Deribit and Coinbase-Routed Instruments
{
"jsonrpc": "2.0",
"method": "public/subscribe",
"id": 42,
"params": {
"channels": [
"trades.BTC-PERPETUAL.100ms"
]
}
}{
"data": [
{
"trade_seq": 30289442,
"trade_id": "48079269",
"timestamp": 1590484512188,
"tick_direction": 2,
"price": 8950,
"mark_price": 8948.9,
"instrument_name": "BTC-PERPETUAL",
"index_price": 8955.88,
"direction": "sell",
"amount": 10,
"contracts": 1
},
{
"trade_seq": 30289443,
"trade_id": "48079270",
"timestamp": 1590484513004,
"tick_direction": 0,
"price": 8960,
"mark_price": 8948.9,
"instrument_name": "BTC-PERPETUAL",
"index_price": 8955.88,
"direction": "buy",
"amount": 20,
"contracts": 2,
"liquidation": "T"
}
]
}Instrument name
Notification interval. The raw interval selects unaggregated updates and is available only to authorized users.
agg2, 100ms, rawClient sends subscription request to subscribe to notification channel. Please refer to Notification page for more information.
2.0
public/subscribe, private/subscribeServer sends subscription notification data
Unique (per currency) trade identifier
The sequence number of the trade within instrument
Unique instrument identifier
The timestamp of the trade (milliseconds since the UNIX epoch)
Optional field: the Starbase causal timestamp of the trade, in nanoseconds since the UNIX epoch (present only for trades matched in Starbase)
Trade direction of the taker
buy, sellDirection of the "tick" (0 = Plus Tick, 1 = Zero-Plus Tick, 2 = Minus Tick, 3 = Zero-Minus Tick).
0, 1, 2, 3Index Price at the moment of trade
The price of the trade
Trade amount. For perpetual and inverse futures the amount is in USD units. For options and linear futures it is the underlying base currency coin.
Trade size in contract units (optional, may be absent in historical trades)
Option implied volatility for the price (Option only)
Optional field (only for trades caused by liquidation): "M" when maker side of trade was under liquidation, "T" when taker side was under liquidation, "MT" when both sides of trade were under liquidation
M, T, MTMark Price at the moment of trade
ID of the Block Trade or Block RFQ trade, when the trade was part of one
Number of legs in the Block Trade or Block RFQ trade, when the trade was part of one
Optional field (only for Block RFQ trades with delayed publication): the time the trade is published to public data feeds, in milliseconds since the UNIX epoch. Until then, the trade is returned only to its counterparties and is not included in public trades or the Block RFQ trade tape. The trade never updates the ticker last_price or tick direction, or the 24-hour high, low and price_change; its volume is reported in volume_delayed.
Optional field containing combo instrument name if the trade is a combo trade
Optional field containing combo trade identifier if the trade is a combo trade
Optional field containing the Starbase match identifier (present only for trades matched via Starbase)
ID of the Block RFQ - when trade was part of the Block RFQ
Leg trades, present when querying only combo trades.
Was this page helpful?