> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whitebit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Market Trades

> Subscribe to real-time trade execution updates for a trading pair via WhiteBIT WebSocket.

Subscribe to real-time trade execution updates for one or more markets. Each message delivers a batch of trade objects containing price, quantity, trade direction, and execution timestamp. The channel supports both targeted subscriptions for specific markets and a wildcard subscription for all available markets.

<Note>Connect to `wss://api.whitebit.com/ws` — see [WebSocket Overview](/websocket/overview) for protocol details and keepalive requirements.</Note>

## Rate limits

## Query recent trades (one-time)

Fetch recent trades for a market without subscribing.

**Request**

**Response**

## Subscribe to trades

<Warning>
  For each WebSocket connection, subscribe to either specific markets or all markets. **Every new subscription replaces the existing one.**
</Warning>

**Subscribe to all markets:**

## Update frequency

Updates are pushed in **real time** on each trade execution.

## Unsubscribe

Send `trades_unsubscribe` with an empty `params` array to stop receiving trade updates on the connection.

## Error codes

## RPI orders in trade updates

Trade updates can include executions originating from RPI orders:

* `rpi: true` — the trade involved a Retail Price Improvement (RPI) order
* `rpi: false` or absent — regular trade

<Note>
  Public market data feeds do not expose RPI orders as visible liquidity in `depth` or `bookTicker`. RPI orders remain visible only in private active orders and in the exchange UI order book (web and mobile).
</Note>

## Trade object

* [Recent trades](/api-reference/market-data/recent-trades) — latest executed trades via REST for polling use cases.