Sign in

v1

latestOpenAPI 3.0.32026-07-2613529376.3 KB
Public API V4

Recent Trades

The endpoint retrieves the trades that have been executed recently on the requested market.

<Note> The API caches the response for 1 second </Note> <Note> Public trade data can include executions that originate from RPI orders. Public order book feeds (`depth`, `bookTicker`) exclude RPI orders. RPI orders appear only in private active orders and in the exchange UI order book (web and mobile). </Note> <Warning> Rate limit 2000 requests/10 sec. </Warning>
get/api/v4/public/trades/{market}

Path parameters

marketstring required
Example:BTC_USDT

Market pair name

Query parameters

type'buy' | 'sell'
Example:sell

Filter by trade side. Omit to return both buy and sell trades.

Response

Successful response

tradeIDinteger required

A unique ID associated with the trade for the currency pair transaction Note: Unix timestamp does not qualify as trade_id.

pricestring required

Transaction price in quote pair volume.

quote_volumestring required

Transaction amount in the quote (stock) currency. In a BTC_USDT market, the value is the BTC amount. Note: WhiteBIT uses a reversed naming convention compared to standard exchange terminology — the stock/asset currency is called 'quote' here.

base_volumestring required

Transaction amount in the base (money) currency. In a BTC_USDT market, the value is the USDT amount. Note: WhiteBIT uses a reversed naming convention compared to standard exchange terminology — the settlement/pricing currency is called 'base' here.

trade_timestampinteger required

Unix timestamp in seconds (UTC). Identifies when the transaction occurred.

type'buy' | 'sell' required

Used to determine whether or not the transaction originated as a buy or sell. Buy – Identifies an ask that was removed from the order book. Sell – Identifies a bid that was removed from the order book.

rpiboolean

Indicates that the trade originates from a Retail Price Improvement (RPI) order.

Example response

[
  {
    "tradeID": 158056419,
    "price": "9186.13",
    "quote_volume": "0.0021",
    "base_volume": "9186.13",
    "trade_timestamp": 1594391747,
    "type": "sell",
    "rpi": true
  }
]