# WhiteBIT Exchange API
> Live spot market data from WhiteBIT, one of the largest global crypto exchanges by spot volume and a major European venue, served straight from its public v4 API with no key and nothing cached. The ticker endpoint returns a market's last price, 24-hour percentage change and base and quote volume. The tickers endpoint returns every spot market for a quote currency ranked by 24-hour quote volume, so one call surfaces the most-traded pairs on the venue. The markets endpoint lists the tradable spot pairs with their base/quote precision, minimum and maximum order size and maker/taker fees. The book endpoint returns live order-book depth — every bid and ask level with price and amount, plus the best bid/ask and the spread. Everything is read live from WhiteBIT on each request, nothing stored; perpetual contracts are excluded so you get clean spot data. A distinct global venue, separate from the other exchange feeds on the marketplace. Ideal for trading bots, price tickers, arbitrage scanners, portfolio trackers and market dashboards. Live, no key. 4 spot endpoints. For perpetuals or candles use a derivatives or OHLC API.

## 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/whitebit-api/..."
```

## Pricing
- **Free** (Free) — 5,300 calls/Mo, 2 req/s
- **Starter** ($9/Mo) — 94,000 calls/Mo, 6 req/s
- **Pro** ($25/Mo) — 495,000 calls/Mo, 18 req/s
- **Business** ($58/Mo) — 3,000,000 calls/Mo, 45 req/s

## Endpoints

### Market

#### `GET /v1/book` — Live order-book depth

**Parameters:**
- `market` (query, required, string) — Spot market BASE_QUOTE Example: `BTC_USDT`
- `limit` (query, optional, string) — Levels per side (default 20) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/whitebit-api/v1/book?market=BTC_USDT&limit=20"
```

**Response:**
```json
{
    "data": {
        "asks": [
            {
                "price": 62728.32,
                "amount": 0.016749
            },
            {
                "price": 62730.15,
                "amount": 0.017323
            },
            {
                "price": 62733.17,
                "amount": 0.028692
            },
            {
                "price": 62735.9,
                "amount": 0.003187
            },
            {
                "price": 62738.17,
                "amount": 0.036559
            },
            {
                "price": 62739.84,
                "amount": 0.055307
            },
            {
                "price": 62741.43,
                "amount": 0.01417
            },
            {
                "price": 62741.48,
                "amount": 0.00797
            },
            {
                "price": 62741.52,
                "amount": 0.098794
            },
            {
                "price": 62743.19,
                "amount": 0.153699
            },
            {
                "price": 62744.86,
                "amount": 0.140286
            },
            {
                "price": 62746.54,
                "amount": 0.202545
            },
            {
                "price": 62748.21,
                "amount": 0.238741
            },
            {
                "price": 62749.89,
                "amount": 0.14188
            },
            {
                "price": 62750.77,
                "amount": 0.12639
 
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/markets` — Tradable spot pairs with fees and limits

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

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

**Response:**
```json
{
    "data": {
        "count": 340,
        "quote": "USDT",
        "source": "WhiteBIT",
        "markets": [
            {
                "base": "BNB",
                "quote": "USDT",
                "market": "BNB_USDT",
                "tradable": true,
                "max_total": 10000000000,
                "min_total": 1,
                "min_amount": 0.001,
                "maker_fee_pct": 0.1,
                "taker_fee_pct": 0.1,
                "base_precision": 3,
                "quote_precision": 2
            },
            {
                "base": "ZRX",
                "quote": "USDT",
                "market": "ZRX_USDT",
                "tradable": true,
                "max_total": 1000000000,
                "min_total": 1,
                "min_amount": 10,
                "maker_fee_pct": 0.1,
                "taker_fee_pct": 0.1,
                "base_precision": 2,
                "quote_precision": 4
            },
            {
                "base": "ZIL",
                "quote": "USDT",
                "market": "ZIL_USDT",
                "tradable": true,
                "max_total": 100000,
                "min_total": 1,
                "min_amount": 100,
                "maker_fee_pct": 0.1,
                "taker_fee_pct": 0.1,
                "base_precision": 4,
                "quote_precision": 6
            },
            {
                "base": "BAT",
                "quote": "USDT",
                "market": "BAT_USDT",
   
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/ticker` — Ticker for one spot market

**Parameters:**
- `market` (query, required, string) — Spot market BASE_QUOTE Example: `BTC_USDT`
- `symbol` (query, optional, string) — Base coin (alternative to market) Example: `BTC`
- `quote` (query, optional, string) — Quote currency for symbol Example: `USDT`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/whitebit-api/v1/ticker?market=BTC_USDT&symbol=BTC&quote=USDT"
```

**Response:**
```json
{
    "data": {
        "base": "BTC",
        "last": 62724.6,
        "quote": "USDT",
        "frozen": false,
        "market": "BTC_USDT",
        "source": "WhiteBIT",
        "change_24h_pct": 1.67,
        "base_volume_24h": 3129.628904,
        "quote_volume_24h": 194864402.9
    },
    "meta": {
        "timestamp": "2026-06-11T07:49:23.262Z",
        "request_id": "d76af4d0-7912-4309-88ab-2ea83eb0ea56"
    },
    "status": "ok",
    "message": "Ticker retrieved successfully",
    "success": true
}
```

#### `GET /v1/tickers` — All spot markets for a quote by volume

**Parameters:**
- `quote` (query, optional, string) — Quote currency (default USDT) Example: `USDT`
- `limit` (query, optional, string) — Max markets (default 50) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/whitebit-api/v1/tickers?quote=USDT&limit=50"
```

**Response:**
```json
{
    "data": {
        "count": 50,
        "quote": "USDT",
        "source": "WhiteBIT",
        "tickers": [
            {
                "base": "ETH",
                "last": 1653.91,
                "quote": "USDT",
                "frozen": false,
                "market": "ETH_USDT",
                "change_24h_pct": 0.91,
                "base_volume_24h": 129181.58625,
                "quote_volume_24h": 212185225.74
            },
            {
                "base": "BTC",
                "last": 62724.6,
                "quote": "USDT",
                "frozen": false,
                "market": "BTC_USDT",
                "change_24h_pct": 1.67,
                "base_volume_24h": 3129.628904,
                "quote_volume_24h": 194864402.9
            },
            {
                "base": "SOL",
                "last": 65.0427,
                "quote": "USDT",
                "frozen": false,
                "market": "SOL_USDT",
                "change_24h_pct": 0.73,
                "base_volume_24h": 1253171.6975,
                "quote_volume_24h": 80359735.03
            },
            {
                "base": "XRP",
                "last": 1.11532,
                "quote": "USDT",
                "frozen": false,
                "market": "XRP_USDT",
                "change_24h_pct": -0.29,
                "base_volume_24h": 51279489.54,
                "quote_volume_24h": 56875714.59
            },
            {
                "base": "WBT",
      
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "note": "Spot markets are BASE_QUOTE (e.g. BTC_USDT); perpetuals are excluded. change_24h_pct is the 24h percentage change; quote_volume_24h is in the quote currency.",
        "source": "WhiteBIT API (whitebit.com/api/v4/public, live)",
        "service": "whitebit-api",
        "endpoints": {
            "GET /v1/book": "Live order-book depth — best bid/ask and spread (market=BTC_USDT, limit=20).",
            "GET /v1/meta": "This document.",
            "GET /v1/ticker": "Ticker for one spot market (market=BTC_USDT or symbol=BTC&quote=USDT).",
            "GET /v1/markets": "Tradable spot pairs with precision, limits and fees (quote=USDT optional).",
            "GET /v1/tickers": "All spot markets for a quote ranked by 24h quote volume (quote=USDT, limit=50)."
        },
        "description": "Live spot market data from WhiteBIT, one of the largest global crypto exchanges by spot volume (a major European venue). The ticker endpoint returns a market's last price, 24h change and base/quote volume; the tickers endpoint ranks every spot market for a quote currency by 24h quote volume; the markets endpoint lists tradable spot pairs with precision, min/max order size and maker/taker fees; the book endpoint returns live order-book depth with best bid/ask and spread. Live, no key, nothing stored. A distinct global venue, separate from other exchange feeds.",
        "upstream_status": "ok",
        "spot_market_count": 787
    },
    "meta": {
        
…(truncated, see openapi.json for full schema)
```


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