# Bitrue Exchange API
> Live spot market data from Bitrue, a global crypto exchange, served straight from its public API with no key and nothing cached. The ticker endpoint returns a market's last price, best bid and ask, 24-hour high and low, 24-hour 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 pairs with their base and quote currency and precision. 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 Bitrue on each request, nothing stored. A distinct global venue, separate from the other exchange feeds on the marketplace. Markets accept either BTC_USDT or BTCUSDT. Ideal for trading bots, price tickers, arbitrage scanners, portfolio trackers and market dashboards. Live, no key. 4 spot endpoints. For candles or perpetuals use an OHLC or derivatives 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/bitrue-api/..."
```

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

## Endpoints

### Market

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

**Parameters:**
- `market` (query, required, string) — Market BTC_USDT or BTCUSDT 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/bitrue-api/v1/book?market=BTC_USDT&limit=20"
```

**Response:**
```json
{
    "data": {
        "asks": [
            {
                "price": 62716.53,
                "amount": 11.7068
            },
            {
                "price": 62716.54,
                "amount": 1.8016
            },
            {
                "price": 62716.55,
                "amount": 0.0005
            },
            {
                "price": 62718.01,
                "amount": 0.165
            },
            {
                "price": 62718.36,
                "amount": 0.0222
            },
            {
                "price": 62718.37,
                "amount": 1.9355
            },
            {
                "price": 62719.2,
                "amount": 0.0002
            },
            {
                "price": 62719.21,
                "amount": 0.6
            },
            {
                "price": 62719.7,
                "amount": 3.3706
            },
            {
                "price": 62719.71,
                "amount": 1.1001
            },
            {
                "price": 62719.72,
                "amount": 15.087
            },
            {
                "price": 62719.93,
                "amount": 0.0132
            },
            {
                "price": 62720.09,
                "amount": 0.0005
            },
            {
                "price": 62720.45,
                "amount": 0.0003
            },
            {
                "price": 62720.73,
                "amount": 0.0947
            },
            {
  
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/markets` — Tradable pairs with base/quote and precision

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

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

**Response:**
```json
{
    "data": {
        "count": 1393,
        "quote": "USDT",
        "source": "Bitrue",
        "markets": [
            {
                "base": "LQTY3S",
                "quote": "USDT",
                "market": "LQTY3SUSDT",
                "status": "TRADING",
                "base_precision": 7,
                "quote_precision": 10
            },
            {
                "base": "FUN",
                "quote": "USDT",
                "market": "FUNUSDT",
                "status": "TRADING",
                "base_precision": 1,
                "quote_precision": 5
            },
            {
                "base": "LIT",
                "quote": "USDT",
                "market": "LITUSDT",
                "status": "TRADING",
                "base_precision": 2,
                "quote_precision": 3
            },
            {
                "base": "BCH3L",
                "quote": "USDT",
                "market": "BCH3LUSDT",
                "status": "TRADING",
                "base_precision": 8,
                "quote_precision": 9
            },
            {
                "base": "D3S",
                "quote": "USDT",
                "market": "D3SUSDT",
                "status": "HALT",
                "base_precision": 0,
                "quote_precision": 10
            },
            {
                "base": "ALICE",
                "quote": "USDT",
                "market": "ALICEUSDT",
                "status": "TRADING",
                "
…(truncated, see openapi.json for full schema)
```

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

**Parameters:**
- `market` (query, required, string) — Market BTC_USDT or BTCUSDT 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/bitrue-api/v1/ticker?market=BTC_USDT&symbol=BTC&quote=USDT"
```

**Response:**
```json
{
    "data": {
        "ask": 62714.01,
        "bid": 62714,
        "base": "BTC",
        "last": 62716.52,
        "quote": "USDT",
        "market": "BTCUSDT",
        "source": "Bitrue",
        "spread": 0.01,
        "low_24h": 60787.88,
        "high_24h": 62996,
        "open_24h": 61706.01,
        "change_24h": 1010.51,
        "change_24h_pct": 1.63,
        "base_volume_24h": 15688.5676,
        "quote_volume_24h": 972526432.18
    },
    "meta": {
        "timestamp": "2026-06-11T07:48:56.020Z",
        "request_id": "00f7a94f-c9ee-4c16-8825-78f6bb23f76a"
    },
    "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/bitrue-api/v1/tickers?quote=USDT&limit=50"
```

**Response:**
```json
{
    "data": {
        "count": 50,
        "quote": "USDT",
        "source": "Bitrue",
        "tickers": [
            {
                "ask": 62714.01,
                "bid": 62714,
                "base": "BTC",
                "last": 62716.52,
                "quote": "USDT",
                "market": "BTCUSDT",
                "spread": 0.01,
                "low_24h": 60787.88,
                "high_24h": 62996,
                "open_24h": 61706.01,
                "change_24h": 1010.51,
                "change_24h_pct": 1.63,
                "base_volume_24h": 15688.5676,
                "quote_volume_24h": 972526432.18
            },
            {
                "ask": 0.1913,
                "bid": 0.1901,
                "base": "XLM",
                "last": 0.1906,
                "quote": "USDT",
                "market": "XLMUSDT",
                "spread": 0.0012,
                "low_24h": 0.1805,
                "high_24h": 0.1948,
                "open_24h": 0.1863,
                "change_24h": 0.0043,
                "change_24h_pct": 2.3,
                "base_volume_24h": 2129971224,
                "quote_volume_24h": 393850982.24
            },
            {
                "ask": 1.1149,
                "bid": 1.114,
                "base": "XRP",
                "last": 1.1145,
                "quote": "USDT",
                "market": "XRPUSDT",
                "spread": 0.0009,
                "low_24h": 1.09,
                "high_24h": 1.13
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "note": "Pass markets as BTC_USDT or BTCUSDT. Symbols are concatenated; base/quote come from exchangeInfo. quote_volume_24h is in the quote currency.",
        "source": "Bitrue API (openapi.bitrue.com/api/v1, live)",
        "service": "bitrue-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 market (market=BTC_USDT or symbol=BTC&quote=USDT).",
            "GET /v1/markets": "Tradable pairs with base/quote and precision (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 Bitrue, a global crypto exchange. The ticker endpoint returns a market's last price, best bid/ask, 24h high/low, 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 pairs with base/quote and precision; the book endpoint returns live order-book depth. Live, no key, nothing stored. A distinct global venue, separate from other exchange feeds.",
        "market_count": 1671,
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-11T07:48:56.481Z",
        "request_id": "4a3c0962-e154-4ced-905c-1926288e8735"
    },
    "status": "ok",
 
…(truncated, see openapi.json for full schema)
```


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