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.BTC-PERPETUAL.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.(instrument_name).(interval)
User trade notifications for a specific combo instrument.
Trades include a legs field describing the underlying legs of the combo. The interval controls aggregation frequency.
Messages
{
"jsonrpc": "2.0",
"method": "public/subscribe",
"id": 42,
"params": {
"channels": [
"user.combo_trades.BTC-PERPETUAL.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
}
]
}instrument_name
type:string
required
The name of the instrument
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