Introduction
Websockets
- WSSuser.mmp_trigger.(index_name)
- WSSuser.portfolio.(currency)
- WSSuser.trades.(instrument_name).(interval)
- WSSuser.trades.(kind).(currency).(interval)
- WSSuser.combo_trades.(instrument_name).(interval)
- WSSuser.combo_trades.(kind).(currency).(interval)
- WSSuser.orders.(instrument_name).raw
- WSSuser.orders.(instrument_name).(interval)
- WSSuser.orders.(kind).(currency).raw
- WSSuser.orders.(kind).(currency).(interval)
- WSSuser.changes.(instrument_name).(interval)
- WSSuser.changes.(kind).(currency).(interval)
- WSSuser.access_log
- WSSuser.lock
- WSS
Messages
{
"jsonrpc": "2.0",
"method": "public/subscribe",
"id": 42,
"params": {
"channels": [
"user.combo_trades.(kind).(currency).100ms"
]
}
}{
"data": [
{
"trade_seq": 39,
"trade_id": "1154",
"timestamp": 1661867454334,
"tick_direction": 2,
"state": "filled",
"risk_reducing": false,
"reduce_only": false,
"profit_loss": null,
"price": 1191.82,
"post_only": false,
"order_type": "limit",
"order_id": "720074",
"mmp": false,
"matching_id": null,
"mark_price": 767.6,
"liquidity": "T",
"legs": [
{
"trade_seq": 179,
"trade_id": "1156",
"timestamp": 1661867454335,
"tick_direction": 2,
"state": "filled",
"risk_reducing": false,
"reduce_only": false,
"profit_loss": 0,
"price": 20008.5,
"post_only": false,
"order_type": "limit",
"order_id": "720078",
"mmp": false,
"matching_id": null,
"mark_price": 20220.61,
"liquidity": "T",
"instrument_name": "BTC-PERPETUAL",
"index_price": 20332.44,
"fee_currency": "BTC",
"fee": 5e-8,
"direction": "buy",
"combo_trade_id": "1154",
"combo_id": "BTC-FS-2SEP22_PERP",
"api": false,
"amount": 10
},
{
"trade_seq": 159,
"trade_id": "1155",
"timestamp": 1661867454335,
"tick_direction": 0,
"state": "filled",
"risk_reducing": false,
"reduce_only": false,
"profit_loss": 0,
"price": 21200.32,
"post_only": false,
"order_type": "limit",
"order_id": "720077",
"mmp": false,
"matching_id": null,
"mark_price": 20988.21,
"liquidity": "T",
"instrument_name": "BTC-2SEP22",
"index_price": 20332.44,
"fee_currency": "BTC",
"fee": 5e-8,
"direction": "sell",
"combo_trade_id": "1154",
"combo_id": "BTC-FS-2SEP22_PERP",
"api": false,
"amount": 10
}
],
"instrument_name": "BTC-FS-2SEP22_PERP",
"index_price": 20332.44,
"fee_currency": "BTC",
"fee": 0,
"direction": "sell",
"api": false,
"amount": 10
}
]
}User
user.combo_trades.(kind).(currency).(interval)
User trade notifications across all combo instruments for a given kind and currency.
Trades include a legs field describing the underlying legs. The interval controls aggregation frequency.
Messages
{
"jsonrpc": "2.0",
"method": "public/subscribe",
"id": 42,
"params": {
"channels": [
"user.combo_trades.(kind).(currency).100ms"
]
}
}{
"data": [
{
"trade_seq": 39,
"trade_id": "1154",
"timestamp": 1661867454334,
"tick_direction": 2,
"state": "filled",
"risk_reducing": false,
"reduce_only": false,
"profit_loss": null,
"price": 1191.82,
"post_only": false,
"order_type": "limit",
"order_id": "720074",
"mmp": false,
"matching_id": null,
"mark_price": 767.6,
"liquidity": "T",
"legs": [
{
"trade_seq": 179,
"trade_id": "1156",
"timestamp": 1661867454335,
"tick_direction": 2,
"state": "filled",
"risk_reducing": false,
"reduce_only": false,
"profit_loss": 0,
"price": 20008.5,
"post_only": false,
"order_type": "limit",
"order_id": "720078",
"mmp": false,
"matching_id": null,
"mark_price": 20220.61,
"liquidity": "T",
"instrument_name": "BTC-PERPETUAL",
"index_price": 20332.44,
"fee_currency": "BTC",
"fee": 5e-8,
"direction": "buy",
"combo_trade_id": "1154",
"combo_id": "BTC-FS-2SEP22_PERP",
"api": false,
"amount": 10
},
{
"trade_seq": 159,
"trade_id": "1155",
"timestamp": 1661867454335,
"tick_direction": 0,
"state": "filled",
"risk_reducing": false,
"reduce_only": false,
"profit_loss": 0,
"price": 21200.32,
"post_only": false,
"order_type": "limit",
"order_id": "720077",
"mmp": false,
"matching_id": null,
"mark_price": 20988.21,
"liquidity": "T",
"instrument_name": "BTC-2SEP22",
"index_price": 20332.44,
"fee_currency": "BTC",
"fee": 5e-8,
"direction": "sell",
"combo_trade_id": "1154",
"combo_id": "BTC-FS-2SEP22_PERP",
"api": false,
"amount": 10
}
],
"instrument_name": "BTC-FS-2SEP22_PERP",
"index_price": 20332.44,
"fee_currency": "BTC",
"fee": 0,
"direction": "sell",
"api": false,
"amount": 10
}
]
}kind
type:string
required
Instrument kind
Allowed values: future, option, spot, future_combo, option_combo
currency
type:string
required
Currency code or any for all
Allowed values: BTC, ETH, USDC, USDT, EURR, any
interval
type:string
required
Frequency of notifications. Events will be aggregated over this interval. The value raw means no aggregation will be applied (Please note that raw interval is only available to authorized users)
Allowed values: raw, 100ms, agg2
Subscription 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
Was this page helpful?
⌘I