/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 formBASE-QUOTE, uppercase with a hyphen.
BASEis the asset being bought or sold.QUOTEis the asset it is priced in.
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
| Concept | What it is | You use it to… |
|---|---|---|
| Market | A 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 book | The 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. |
| Ticker | A 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. |
| Trade | A 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. |
| Candle | An OHLCV bar summarizing one interval: open, high, low, close, volume, and trade count. | Chart price history over time. |
| Order | Your instruction to buy or sell: a limit order rests at a price, a market order takes whatever the book offers. | Act on the market. |
| Fill | One 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 rate | Your 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
- Exchange Markets — list markets and read their trading rules.
- Reading Market Data — tickers, order book, trades, and candles.
- Placing and Managing Orders — place, list, fetch, and cancel orders.
- Fills and Fee Rates — reconcile executions and check your rates.