Skip to main content
This guide will walk you through the public market data available on the Busha exchange: tickers, order book, trades, and candles. Each answers a different question — a ticker is a one-glance price summary, the order book shows resting depth, trades show what actually executed, and candles summarize price movement over time.
What You’ll Achieve:
  1. Read a ticker for a quick price summary.
  2. Retrieve order book depth for a single market.
  3. List recent public trades.
  4. Fetch OHLCV candles for charting.

Prerequisites

Before you begin, ensure you have:
All market data endpoints are public and accept an optional bearer token. The only unauthenticated endpoint in this guide is the same pattern — no token is required, but including one keeps a single code path.

How to Read Market Data

1

Read a Ticker

A ticker merges the 24-hour summary with the top of book in one read, so you can show a price headline without reading the whole order book.To read the ticker for a single market:
To read every market’s ticker at once, use GET /v1/exchange/tickers — the same payload per symbol, unpaginated.Expected Response:
FieldDescription
last_priceThe most recent trade price.
best_bid / best_askThe highest buy price and lowest sell price resting in the book (the spread).
open_24h / high_24h / low_24hThe opening, highest, and lowest prices over the last 24 hours.
volume_24h / quote_volume_24hTotal base and quote asset traded over 24 hours.
2

Read the Order Book

The order book shows aggregated depth: how much rests at each price on the buy side (bids) and sell side (asks). Each level is a positional [price, quantity] pair, both decimal strings.To read the order book:
depth names how many levels a side returns and must be one of 1, 5, 10, 20, 50, 100, or 500; omitting it returns 50.Expected Response:
bids are best-first and descending (the highest buy price first); asks are best-first and ascending (the lowest sell price first). The quantity at a level is the total resting size, not one order’s.
sequence counts accepted orders, not book changes, so do not use it to decide whether the depth has moved. For a live book, subscribe to the order_book stream channel instead; this REST read is for clients that want depth without holding a socket open.
3

List Public Trades

Trades are the market’s public tape — the price and quantity of every completed match, most recent first. taker_side is the side that crossed the spread.To list trades:
limit defaults to 50 and is capped at 500. Results are cursor-paginated via next_cursor, and you can bound the window with from and to (RFC3339).Expected Response:
4

Fetch Candles

A candle (OHLCV) summarizes one interval: the opening, highest, lowest, and closing price, plus volume and trade count. Rows come back oldest first.To fetch candles:
interval is required and is one of 1m, 5m, 15m, 30m, 1h, 4h, 1d, or 1w. limit defaults to 200 and is capped at 1000.Expected Response:
time is the instant the interval opened, so a 1h candle covers time up to one hour after it. The bar that is still forming is included and moves as the market trades. There is no history ceiling — page back with end_time.

Troubleshooting Common Issues

  • not_found: The symbol does not exist. Symbols are BASE-QUOTE and uppercase (for example, USDT-NGN).
  • Invalid depth: The value must be one of 1, 5, 10, 20, 50, 100, or 500. Any other value is a validation error.
  • Empty data: []: The market may be inactive or have no recent activity (for example, no trades in the window). Check the market’s status with GET /v1/exchange/markets/{symbol}.

What’s Next?

Now that you can read market data, act on it: