Skip to main content

Trades

Real-time trade updates for specific symbols.

tip

The side field indicates the taker side of the trade. A buy side means a buyer matched an existing sell order, and vice versa.

Subscribe Request:

{
  "id": "12345",
  "method": "subscribe",
  "params": {
    "channel": "trades",
    "symbol": "BTC-USDT"
  }
}

Request parameters​

ParameterDescription
symbol (required)Trading pair symbol. Specify trading pair to get updates. See Get /api/v1/symbols for all currently available trading pairs.

Response​

Subscribe Response:

{
  "id": "12345",
  "result": {
    "success": true
  }
}

Subscription Push Example:

{
  "method": "subscription",
  "params": {
    "channel": "trades",
    "symbol": "BTC-USDT",
    "data": {
      "trades": [
        {
          "tradeId": "3262786978",
          "price": "51200.00",
          "side": "buy",
          "time": "2024-12-19T10:44:17.347Z",
          "size": "0.15000000"
        }
      ]
    }
  }
}

Response Parameters​

ParameterDescription
tradeId (required)Trade ID. Type: string.
price (required)The execution price of the trade in the quote currency. Type: string.
side (required)The taker side of the trade. Available values: buy, sell.
time (required)Timestamp of the trade. Type: string.
size (required)The quantity of base currency that was traded (executed amount). Type: string.