Skip to main content
Use orderbooks, trades, and candles after resolving a tradingPairId from Markets. REST gives you snapshots or history. WebSockets keep market views live.

Surface Map

Candles

Candles are historical over REST and live over WebSocket. Use REST to backfill charts, then subscribe to the matching OHLCV channel for updates.

Orderbooks

Use REST for an initial snapshot. Use WebSocket for live depth. magnitude controls price grouping and denomination controls whether quantities are shown in base or quote units.

Trades

Use REST for recent historical trades. Use WebSocket for live executions. The trades listing is cursor paged: omit pageToken to start at the newest trade, then follow nextPageToken until it comes back empty. There is no page parameter — sending one returns 400.

Builder Notes

  • Treat REST as snapshot or history and WebSocket as live state.
  • Reconcile WebSocket streams against periodic REST refreshes when correctness matters.
  • Public market data does not require authentication.
  • All WebSocket channel parameters use trading pair IDs, not symbols.