# BitoPro Exchange API
> Live market data from BitoPro, Taiwan's largest regulated retail crypto exchange, straight from its public v3 REST API. This is the single-venue New-Taiwan-Dollar (TWD) order-flow view. The ticker endpoint returns the last price, 24h change, 24h high/low and 24h base volume for any listed pair (BTC_TWD, ETH_TWD, USDT_TWD …), or every pair at once ranked by volume. The orderbook endpoint returns the live aggregated bid/ask depth with per-level price, size and order count, plus the resulting best bid/ask and spread. The trades endpoint returns the most recent executed trades with price, amount, side and time. The pairs endpoint lists every tradable market with its base/quote, precision and order limits, and which markets are in maintenance. Together they answer "what does BTC cost in New Taiwan Dollars on BitoPro right now, how deep is the book, and what just traded" — a single-venue TWD-denominated exchange view, distinct from the aggregated cross-exchange market, whole-market overview and other regional exchange APIs in the catalogue. Live, no key on the upstream, nothing stored.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/bitopro-api/..."
```

## Pricing
- **Free** (Free) — 30,000 calls/Mo, 5 req/s
- **Starter** ($7/Mo) — 360,000 calls/Mo, 15 req/s
- **Pro** ($21/Mo) — 1,550,000 calls/Mo, 40 req/s
- **Scale** ($50/Mo) — 5,600,000 calls/Mo, 120 req/s

## Endpoints

### Market

#### `GET /v1/orderbook` — Live bid/ask depth for a pair

**Parameters:**
- `pair` (query, required, string) — Pair in base_quote form Example: `btc_twd`
- `limit` (query, optional, string) — Depth per side (max 100) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bitopro-api/v1/orderbook?pair=btc_twd&limit=20"
```

#### `GET /v1/ticker` — Ticker for a pair (or all pairs)

**Parameters:**
- `pair` (query, optional, string) — Pair in base_quote form; omit for all pairs Example: `btc_twd`
- `quote` (query, optional, string) — Filter all-pairs by quote currency Example: `twd`
- `limit` (query, optional, string) — Max pairs when listing all Example: `100`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bitopro-api/v1/ticker?pair=btc_twd&quote=twd&limit=100"
```

#### `GET /v1/trades` — Most recent executed trades for a pair

**Parameters:**
- `pair` (query, required, string) — Pair in base_quote form Example: `btc_twd`
- `limit` (query, optional, string) — Max trades (max 200) Example: `30`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bitopro-api/v1/trades?pair=btc_twd&limit=30"
```

### Reference

#### `GET /v1/pairs` — All tradable markets with precision & limits

**Parameters:**
- `quote` (query, optional, string) — Filter by quote currency Example: `twd`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bitopro-api/v1/pairs?quote=twd"
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bitopro-api/v1/meta"
```


---
Marketplace page: https://www.oanor.com/api/bitopro-api
OpenAPI spec: https://www.oanor.com/api/bitopro-api/openapi.json