Skip to main content
A market on the Busha exchange is a tradable currency pair plus the rules every order against it must satisfy. Before you place an order, read the market so your price and quantity are valid and you know the minimum and maximum size.
What You’ll Achieve:
  1. List every market available on the exchange.
  2. Retrieve the rules for a single market by symbol.
  3. Understand each trading rule so you can format valid orders.

Prerequisites

Before you begin, ensure you have:
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:
FieldDescription
symbolThe market’s canonical identifier, BASE-QUOTE.
statusWhat 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_tickThe price increment. A price off this tick is refused with price_off_tick.
quantity_stepThe quantity increment. A quantity off this step is refused with quantity_off_step.
min_quantity / max_quantityThe size bounds in the base asset. A null max_quantity means no upper bound.
min_notionalThe minimum order value in the quote asset.
price_decimals / quantity_decimalsThe display precision for prices and quantities on this market.
A client that mirrors these values locally can reject a bad order before spending a round trip on it. When you receive a 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 are BASE-QUOTE and uppercase (for example, USDT-NGN, not usdt-ngn or USDTNGN).
  • price_off_tick: Your price is not a multiple of price_tick. Re-read the market and round accordingly.
  • quantity_off_step: Your quantity is not a multiple of quantity_step. Re-read the market and round accordingly.
  • 401 Unauthorized: Ensure your Authorization header is correct. Market data is read-only and needs exchange:read (or api:read) when authenticated.

What’s Next?

Now that you know which markets exist and their rules, read their live data: