Prerequisites
Before you begin, ensure you have:- A Busha Business Account and Secret API Key (from the Quick Start Tutorial).
- An understanding of the API Environments (Sandbox vs. Production) and their base URLs (from the Make Your First Request Guide).
- An understanding of market symbols (from Understanding the Exchange).
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:| Field | Description |
|---|---|
last_price | The most recent trade price. |
best_bid / best_ask | The highest buy price and lowest sell price resting in the book (the spread). |
open_24h / high_24h / low_24h | The opening, highest, and lowest prices over the last 24 hours. |
volume_24h / quote_volume_24h | Total 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 areBASE-QUOTEand uppercase (for example,USDT-NGN). -
Invalid
depth: The value must be one of1,5,10,20,50,100, or500. 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’sstatuswithGET /v1/exchange/markets/{symbol}.