Skip to main content
The Busha Exchange is an order-book marketplace where you can place and manage your own buy and sell orders, and read public market data such as prices, depth, and recent activity. It lives under the /v1/exchange endpoints and is distinct from the quote-and-transfer conversion flow used elsewhere in Busha. This page introduces the concepts you will meet across the Exchange guides. If a term is unfamiliar, come back here.

What is the Exchange?

An exchange lets buyers and sellers meet on a shared market. Each market is a single currency pair, and its order book collects every open order waiting to be matched. When a new buy order crosses a resting sell order (or vice versa), the two trade, and each participant’s order records a fill. Placing an order on the exchange means you are either:
  • A maker — your order rests in the book and adds liquidity (typically the lower fee), or
  • A taker — your order immediately matches a resting order and removes liquidity.

Exchange vs. Conversion

Busha has two ways to move between currencies. They serve different needs. Use the exchange (/v1/exchange) when you want to trade on a live order book. You set the terms yourself: name a price on a limit order, or take whatever the book offers with a market order. Orders can rest, fill partially over time, and be cancelled or replaced. You also get full market data — tickers, order book depth, trades, and candles — plus your own orders and fills. Use conversion (/v1/quotes + /v1/transfers) when you want an instant swap at a guaranteed price. Busha quotes you a rate and fees, you lock them in with a single quote_id, and the transfer settles it. There is no book to read and no order to manage. If you simply want to convert one balance to another at a quoted price, see Convert Between Balances. If you want to trade on a live order book, continue here.

Market symbols

A market is always identified by a symbol of the form BASE-QUOTE, uppercase with a hyphen.
  • BASE is the asset being bought or sold.
  • QUOTE is the asset it is priced in.
For example, USDT-NGN means USDT priced in NGN: a buy order acquires USDT and spends NGN, while a sell order gives up USDT and receives NGN. The same string is used in paths, query parameters, and request bodies — there is no second spelling of a market.

Key concepts

ConceptWhat it isYou use it to…
MarketA tradable currency pair plus the rules an order must satisfy (price tick, quantity step, minimum and maximum size, decimals).Know what you can trade and how to format a valid order.
Order bookThe list of open bids (buyers) and asks (sellers), each level a price and the total size resting at it.See available depth and decide where to place an order.
TickerA one-glance summary: last price, best bid and ask, and 24-hour high, low, volume, and change.Show a price headline or monitor movement without reading the full book.
TradeA completed match between a buyer and a seller (a “print”), with price, quantity, and which side crossed the spread.See the actual prices the market is transacting at.
CandleAn OHLCV bar summarizing one interval: open, high, low, close, volume, and trade count.Chart price history over time.
OrderYour instruction to buy or sell: a limit order rests at a price, a market order takes whatever the book offers.Act on the market.
FillOne execution against one of your orders, with the fee actually charged and whether you were maker or taker.Reconcile what actually traded and what it cost.
Fee rateYour maker and taker rates as decimal fractions (0.002 means 0.2%), settled in the quote currency.Know your cost before trading.

How the guides are organized

What’s Next?

Start with the markets you can trade: