> ## 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.

# Exchange Markets

> List the markets available on the Busha exchange and read the trading rules each one enforces: price tick, quantity step, and size limits.

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.

> [!TIP]
>
> **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:

* A **Busha Business Account** and **Secret API Key** (from the [Quick Start Tutorial](https://docs.busha.io/guides/getting-started/quick-start.md)).

* An understanding of the API Environments (Sandbox vs. Production) and their base URLs (from the [Make Your First Request Guide](https://docs.busha.io/guides/getting-started/make-first-request.md)).

* A basic understanding of market symbols (from [Understanding the Exchange](https://docs.busha.io/guides/exchange/introduction.md)).

> [!NOTE]
>
> 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:

```bash theme={null}
$ curl -i -X GET \
  https://YOUR_BASE_URL/v1/exchange/markets \
  -H 'Authorization: Bearer YOUR_SECRET_TOKEN'
```

**Expected Response:**

```json theme={null}
{
  "status": "success",
  "message": "Markets retrieved",
  "data": [
    {
      "symbol": "USDT-NGN",
      "base_currency": "USDT",
      "quote_currency": "NGN",
      "status": "trading",
      "price_tick": "0.01",
      "quantity_step": "0.01",
      "min_quantity": "0.1",
      "max_quantity": null,
      "min_notional": "100",
      "price_decimals": 2,
      "quantity_decimals": 8
    }
  ]
}
```

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:

```bash theme={null}
$ curl -i -X GET \
  "https://YOUR_BASE_URL/v1/exchange/markets?status=halted" \
  -H 'Authorization: Bearer YOUR_SECRET_TOKEN'
```

**2. Retrieve a Single Market**

One market by symbol, carrying the same trading rules as the list.

```bash theme={null}
$ curl -i -X GET \
  https://YOUR_BASE_URL/v1/exchange/markets/USDT-NGN \
  -H 'Authorization: Bearer YOUR_SECRET_TOKEN'
```

**Expected Response:**

```json theme={null}
{
  "status": "success",
  "message": "Market retrieved",
  "data": {
    "symbol": "USDT-NGN",
    "base_currency": "USDT",
    "quote_currency": "NGN",
    "status": "trading",
    "price_tick": "0.01",
    "quantity_step": "0.01",
    "min_quantity": "0.1",
    "max_quantity": null,
    "min_notional": "100",
    "price_decimals": 2,
    "quantity_decimals": 8
  }
}
```

An unknown symbol returns `not_found`:

```json theme={null}
{
  "error": {
    "name": "not_found",
    "message": "Market not found"
  }
}
```

**3. Understand the Trading Rules**

Each market field tells you how to format a valid order:

<table>
  <thead>
    <tr>
      <th>Field</th>
      <th>Description</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`symbol`</td>
      <td>The market's canonical identifier, `BASE-QUOTE`.</td>
    </tr>

    <tr>
      <td>`status`</td>
      <td>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).</td>
    </tr>

    <tr>
      <td>`price_tick`</td>
      <td>The price increment. A price off this tick is refused with `price_off_tick`.</td>
    </tr>

    <tr>
      <td>`quantity_step`</td>
      <td>The quantity increment. A quantity off this step is refused with `quantity_off_step`.</td>
    </tr>

    <tr>
      <td>`min_quantity` / `max_quantity`</td>
      <td>The size bounds in the base asset. A `null` `max_quantity` means no upper bound.</td>
    </tr>

    <tr>
      <td>`min_notional`</td>
      <td>The minimum order value in the quote asset.</td>
    </tr>

    <tr>
      <td>`price_decimals` / `quantity_decimals`</td>
      <td>The display precision for prices and quantities on this market.</td>
    </tr>
  </tbody>
</table>

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:

* [Reading Market Data](https://docs.busha.io/guides/exchange/market-data.md)

* [Placing and Managing Orders](https://docs.busha.io/guides/exchange/orders.md)


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