price and quantity are valid and you know the minimum and maximum size.
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).
- A basic understanding of market symbols (from Understanding the Exchange).
Market data accepts an optional bearer token, so you can keep one code path for
public and private calls.
How to Read Exchange Markets
1
List Available Markets
The market list is small and unpaginated. Reading it needs no credential; a bearer token is accepted so a client can keep one code path for public and private calls.To list markets:Expected Response:By default only markets that accept new orders are returned (
trading, post_only, and limit_only). To also load halted, cancel_only, and delisted markets, pass include_inactive=true, or use an explicit status filter:2
Retrieve a Single Market
One market by symbol, carrying the same trading rules as the list.Expected Response:An unknown symbol returns
not_found:3
Understand the Trading Rules
Each market field tells you how to format a valid order:
A client that mirrors these values locally can reject a bad order before spending a round trip on it. When you receive a
| Field | Description |
|---|---|
symbol | The market’s canonical identifier, BASE-QUOTE. |
status | What the market currently admits: trading (normal two-sided trading), post_only (resting orders only), limit_only (no market orders), cancel_only (no new orders), halted (nothing accepted), or delisted (permanent). |
price_tick | The price increment. A price off this tick is refused with price_off_tick. |
quantity_step | The quantity increment. A quantity off this step is refused with quantity_off_step. |
min_quantity / max_quantity | The size bounds in the base asset. A null max_quantity means no upper bound. |
min_notional | The minimum order value in the quote asset. |
price_decimals / quantity_decimals | The display precision for prices and quantities on this market. |
market_halted, price_off_tick, or quantity_off_step rejection, re-read the market — your copy has gone stale.Troubleshooting Common Issues
-
not_found: The symbol does not exist. Symbols areBASE-QUOTEand uppercase (for example,USDT-NGN, notusdt-ngnorUSDTNGN). -
price_off_tick: Your price is not a multiple ofprice_tick. Re-read the market and round accordingly. -
quantity_off_step: Your quantity is not a multiple ofquantity_step. Re-read the market and round accordingly. -
401 Unauthorized: Ensure yourAuthorizationheader is correct. Market data is read-only and needsexchange:read(orapi:read) when authenticated.