> ## Documentation Index
> Fetch the complete documentation index at: https://docs.busha.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Understanding the Exchange

> Learn how the Busha order-book exchange works, how market symbols are named, and what markets, order books, tickers, trades, candles, orders, and fills mean.

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](https://docs.busha.io/guides/balance/convert-balance-to-balance.md). 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

<table>
  <thead>
    <tr>
      <th>Concept</th>
      <th>What it is</th>
      <th>You use it to…</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>**Market**</td>
      <td>A tradable currency pair plus the rules an order must satisfy (price tick, quantity step, minimum and maximum size, decimals).</td>
      <td>Know what you can trade and how to format a valid order.</td>
    </tr>

    <tr>
      <td>**Order book**</td>
      <td>The list of open `bids` (buyers) and `asks` (sellers), each level a price and the total size resting at it.</td>
      <td>See available depth and decide where to place an order.</td>
    </tr>

    <tr>
      <td>**Ticker**</td>
      <td>A one-glance summary: last price, best bid and ask, and 24-hour high, low, volume, and change.</td>
      <td>Show a price headline or monitor movement without reading the full book.</td>
    </tr>

    <tr>
      <td>**Trade**</td>
      <td>A completed match between a buyer and a seller (a "print"), with price, quantity, and which side crossed the spread.</td>
      <td>See the actual prices the market is transacting at.</td>
    </tr>

    <tr>
      <td>**Candle**</td>
      <td>An OHLCV bar summarizing one interval: open, high, low, close, volume, and trade count.</td>
      <td>Chart price history over time.</td>
    </tr>

    <tr>
      <td>**Order**</td>
      <td>Your instruction to buy or sell: a `limit` order rests at a price, a `market` order takes whatever the book offers.</td>
      <td>Act on the market.</td>
    </tr>

    <tr>
      <td>**Fill**</td>
      <td>One execution against one of your orders, with the fee actually charged and whether you were maker or taker.</td>
      <td>Reconcile what actually traded and what it cost.</td>
    </tr>

    <tr>
      <td>**Fee rate**</td>
      <td>Your maker and taker rates as decimal fractions (0.002 means 0.2%), settled in the quote currency.</td>
      <td>Know your cost before trading.</td>
    </tr>
  </tbody>
</table>

## How the guides are organized

* [Exchange Markets](https://docs.busha.io/guides/exchange/markets.md) — list markets and read their trading rules.

* [Reading Market Data](https://docs.busha.io/guides/exchange/market-data.md) — tickers, order book, trades, and candles.

* [Placing and Managing Orders](https://docs.busha.io/guides/exchange/orders.md) — place, list, fetch, and cancel orders.

* [Fills and Fee Rates](https://docs.busha.io/guides/exchange/fills-and-fees.md) — reconcile executions and check your rates.

## What's Next?

Start with the markets you can trade:

* [Exchange Markets](https://docs.busha.io/guides/exchange/markets.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.