# Bitkub API
> Live spot market data from Bitkub, Thailand's largest crypto exchange — served straight from its public API, no key, nothing cached. Get a pair's last price, best bid/ask, 24h change, high/low and base/quote volume (in Thai baht, USDT or Bitcoin); rank every pair for a quote currency by 24h quote volume; and list Bitkub's trading pairs. A distinct South-East-Asian venue with baht pricing, separate from other exchange feeds. Symbols are QUOTE_BASE (e.g. THB_BTC).

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

## Pricing
- **Free** (Free) — 3,550 calls/Mo, 2 req/s
- **Starter** ($8/Mo) — 80,000 calls/Mo, 6 req/s
- **Pro** ($22/Mo) — 418,000 calls/Mo, 15 req/s
- **Business** ($52/Mo) — 2,580,000 calls/Mo, 40 req/s

## Endpoints

### Bitkub

#### `GET /v1/meta` — Service metadata and endpoint list

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

**Response:**
```json
{
    "data": {
        "note": "Symbols are QUOTE_BASE, uppercase (e.g. THB_BTC). quoteVolume is in the quote currency.",
        "source": "Bitkub API (api.bitkub.com, live)",
        "service": "bitkub-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/ticker": "Ticker for one pair (sym=THB_BTC or symbol=BTC&quote=THB).",
            "GET /v1/symbols": "List trading pairs (quote=THB optional).",
            "GET /v1/tickers": "All pairs for a quote ranked by 24h volume (quote=THB, limit=50)."
        },
        "description": "Live spot market data from Bitkub, Thailand's largest crypto exchange. The ticker endpoint returns a pair's last price, best bid/ask, 24h change, high/low and base/quote volume (in Thai baht, USDT or Bitcoin); the tickers endpoint ranks every pair for a quote currency by 24h quote volume; the symbols endpoint lists trading pairs. Live, no key, nothing stored. A distinct South-East-Asian venue with baht pricing, separate from other exchange feeds.",
        "symbol_count": 438,
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-10T22:56:09.596Z",
        "request_id": "98bd1fb3-ebd7-4b81-a0bc-583ce3dd8d1e"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```

#### `GET /v1/symbols` — List trading pairs

**Parameters:**
- `quote` (query, optional, string) — Filter by quote currency e.g. THB (omit for all) Example: `THB`

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

**Response:**
```json
{
    "data": {
        "count": 368,
        "quote": "THB",
        "source": "Bitkub",
        "symbols": [
            {
                "base": "BTC",
                "info": "Thai Baht to Bitcoin",
                "quote": "THB",
                "symbol": "THB_BTC"
            },
            {
                "base": "ETH",
                "info": "Thai Baht to Ethereum",
                "quote": "THB",
                "symbol": "THB_ETH"
            },
            {
                "base": "ADA",
                "info": "Thai Baht to Cardano",
                "quote": "THB",
                "symbol": "THB_ADA"
            },
            {
                "base": "BCH",
                "info": "Thai Baht to Bitcoin Cash",
                "quote": "THB",
                "symbol": "THB_BCH"
            },
            {
                "base": "USDT",
                "info": "Thai Baht to Tether",
                "quote": "THB",
                "symbol": "THB_USDT"
            },
            {
                "base": "XRP",
                "info": "Thai Baht to XRP",
                "quote": "THB",
                "symbol": "THB_XRP"
            },
            {
                "base": "ZIL",
                "info": "Thai Baht to Zilliqa",
                "quote": "THB",
                "symbol": "THB_ZIL"
            },
            {
                "base": "SNT",
                "info": "Thai Baht to Status",
                "quote": "THB",
                "symbol": "THB
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/ticker` — Ticker for one pair

**Parameters:**
- `sym` (query, required, string) — Symbol QUOTE_BASE (or use symbol & quote) Example: `THB_BTC`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bitkub-api/v1/ticker?sym=THB_BTC"
```

**Response:**
```json
{
    "data": {
        "ask": 2022074.45,
        "bid": 2021439.84,
        "base": "BTC",
        "last": 2021439.84,
        "quote": "THB",
        "source": "Bitkub",
        "spread": 634.61,
        "symbol": "THB_BTC",
        "low_24h": 1998861,
        "high_24h": 2065000,
        "change_24h_pct": -0.38,
        "base_volume_24h": 75.04635592,
        "quote_volume_24h": 151959729.99
    },
    "meta": {
        "timestamp": "2026-06-10T22:56:10.518Z",
        "request_id": "58090f9e-e57e-4558-8067-c829511e6e5d"
    },
    "status": "ok",
    "message": "Ticker retrieved successfully",
    "success": true
}
```

#### `GET /v1/tickers` — All pairs for a quote ranked by 24h volume

**Parameters:**
- `quote` (query, optional, string) — Quote currency e.g. THB, USDT (default THB) Example: `THB`
- `limit` (query, optional, string) — Max results 1-300 (default 50) Example: `50`

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

**Response:**
```json
{
    "data": {
        "count": 50,
        "quote": "THB",
        "source": "Bitkub",
        "tickers": [
            {
                "ask": 32.9,
                "bid": 32.89,
                "base": "USDT",
                "last": 32.89,
                "quote": "THB",
                "spread": 0.01,
                "symbol": "THB_USDT",
                "low_24h": 32.81,
                "high_24h": 32.92,
                "change_24h_pct": 0.09,
                "base_volume_24h": 22429475.19,
                "quote_volume_24h": 737145522.69
            },
            {
                "ask": 2022074.45,
                "bid": 2021439.84,
                "base": "BTC",
                "last": 2021439.84,
                "quote": "THB",
                "spread": 634.61,
                "symbol": "THB_BTC",
                "low_24h": 1998861,
                "high_24h": 2065000,
                "change_24h_pct": -0.38,
                "base_volume_24h": 75.04635592,
                "quote_volume_24h": 151959729.99
            },
            {
                "ask": 53262.31,
                "bid": 53219.63,
                "base": "ETH",
                "last": 53262.31,
                "quote": "THB",
                "spread": 42.68,
                "symbol": "THB_ETH",
                "low_24h": 52800,
                "high_24h": 54785.57,
                "change_24h_pct": -1.32,
                "base_volume_24h": 763.97813408,
                "quote_volume_24h": 409508
…(truncated, see openapi.json for full schema)
```


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