Messages

{
  "data": [
    {
      "amount": 20,
      "direction": "sell",
      "fee": 0.00000168,
      "fee_currency": "BTC",
      "index_price": 8956.73,
      "instrument_name": "BTC-PERPETUAL",
      "liquidity": "T",
      "mark_price": 8952.86,
      "matching_id": null,
      "order_id": "4008965646",
      "order_type": "market",
      "post_only": false,
      "price": 8954,
      "reduce_only": false,
      "state": "filled",
      "tick_direction": 0,
      "timestamp": 1590484156350,
      "trade_id": "48079254",
      "trade_seq": 30289432
    },
    {
      "amount": 20,
      "direction": "sell",
      "fee": 0.00000168,
      "fee_currency": "BTC",
      "index_price": 8956.73,
      "instrument_name": "BTC-PERPETUAL",
      "liquidity": "T",
      "mark_price": 8952.86,
      "matching_id": null,
      "order_id": "4008965646",
      "order_type": "market",
      "post_only": false,
      "price": 8954,
      "reduce_only": false,
      "state": "filled",
      "tick_direction": 1,
      "timestamp": 1590484156350,
      "trade_id": "48079255",
      "trade_seq": 30289433
    }
  ]
}

User

user.trades.(instrument_name).(interval)

User trade notifications for a specific instrument.

Receive private trade events for your account for the given instrument. The interval controls how frequently events are aggregated.

Block RFQ trades: Trades resulting from Block RFQ execution are included in this channel. These trades carry the following additional fields:

block_rfq_id — ID of the Block RFQ.
block_trade_id — ID of the resulting block trade.
block_rfq_quote_id — ID of the accepted quote (present on the maker side only).
order_id — always present for direct trade participants (makers and takers).

WSS

user.trades.

{instrument_name}

{interval}

Messages

{
  "data": [
    {
      "amount": 20,
      "direction": "sell",
      "fee": 0.00000168,
      "fee_currency": "BTC",
      "index_price": 8956.73,
      "instrument_name": "BTC-PERPETUAL",
      "liquidity": "T",
      "mark_price": 8952.86,
      "matching_id": null,
      "order_id": "4008965646",
      "order_type": "market",
      "post_only": false,
      "price": 8954,
      "reduce_only": false,
      "state": "filled",
      "tick_direction": 0,
      "timestamp": 1590484156350,
      "trade_id": "48079254",
      "trade_seq": 30289432
    },
    {
      "amount": 20,
      "direction": "sell",
      "fee": 0.00000168,
      "fee_currency": "BTC",
      "index_price": 8956.73,
      "instrument_name": "BTC-PERPETUAL",
      "liquidity": "T",
      "mark_price": 8952.86,
      "matching_id": null,
      "order_id": "4008965646",
      "order_type": "market",
      "post_only": false,
      "price": 8954,
      "reduce_only": false,
      "state": "filled",
      "tick_direction": 1,
      "timestamp": 1590484156350,
      "trade_id": "48079255",
      "trade_seq": 30289433
    }
  ]
}

instrument_name

type:string

required

The name of the instrument

interval

type:enum

required

Frequency of notifications. Events will be aggregated over this interval. The value raw selects the finest granularity - events are aggregated over a 1 millisecond interval (Please note that raw interval is only available to authorized users)

Allowed values: raw, 100ms, agg2

Available options: 100ms, agg2, raw

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

Get Started

Spot & US Derivatives - REST

Spot & US Derivatives - WS Streams

Global Derivatives - REST / WS

Global Derivatives - WS Streams

user.trades.(instrument_name).(interval)