# Bitunix Perpetual Futures Exchange API
> Live market data for the Bitunix perpetual-futures exchange, with no key. List every trading pair with contract specs; pull a 24h ticker (last/mark price, 24h high/low/open, base & quote volume); read the live order book; fetch OHLC candles across many intervals; and get the latest funding rate with the next funding time and interval. Symbols are Binance-style ids (BTCUSDT, ETHUSDT) — ideal for derivatives dashboards, funding-rate monitors and charting across 600+ markets.

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

## Pricing
- **Free** (Free) — 1,820 calls/Mo, 4 req/s
- **Basic** ($15/Mo) — 52,400 calls/Mo, 9 req/s
- **Pro** ($42/Mo) — 209,000 calls/Mo, 21 req/s
- **Business** ($91/Mo) — 852,000 calls/Mo, 51 req/s

## Endpoints

### Markets

#### `GET /v1/candles` — OHLC candles

**Parameters:**
- `symbol` (query, required, string) — Bitunix symbol Example: `BTCUSDT`
- `interval` (query, optional, string) — Candle interval (1m,5m,15m,1h,4h,1d) Example: `1h`
- `limit` (query, optional, string) — Candles (1-200) Example: `100`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bitunix-api/v1/candles?symbol=BTCUSDT&interval=1h&limit=100"
```

**Response:**
```json
{
    "data": {
        "count": 100,
        "symbol": "BTCUSDT",
        "candles": [
            {
                "low": 65545.2,
                "high": 65934.3,
                "open": 65559.9,
                "time": "1781517600000",
                "close": 65884.7,
                "base_volume": 60004403.89796,
                "quote_volume": 912.4388
            },
            {
                "low": 65469,
                "high": 65740.1,
                "open": 65620,
                "time": "1781514000000",
                "close": 65559.9,
                "base_volume": 37500754.41149,
                "quote_volume": 571.8092
            },
            {
                "low": 65580.4,
                "high": 65768.1,
                "open": 65642.4,
                "time": "1781510400000",
                "close": 65620,
                "base_volume": 43722527.80195,
                "quote_volume": 665.8039
            },
            {
                "low": 65594,
                "high": 65978.1,
                "open": 65773,
                "time": "1781506800000",
                "close": 65642.4,
                "base_volume": 60568528.72275,
                "quote_volume": 921.1458
            },
            {
                "low": 65738.4,
                "high": 65933,
                "open": 65828,
                "time": "1781503200000",
                "close": 65773,
                "base_volume": 46591577.86411,
                "quote_volume": 70
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/funding` — Latest funding rate with next funding time

**Parameters:**
- `symbol` (query, required, string) — Bitunix symbol Example: `BTCUSDT`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bitunix-api/v1/funding?symbol=BTCUSDT"
```

**Response:**
```json
{
    "data": {
        "symbol": "BTCUSDT",
        "mark_price": 65896,
        "funding_rate": -0.002023,
        "max_funding_rate": 0.3,
        "min_funding_rate": -0.3,
        "next_funding_time": "1781539200000",
        "funding_interval_hours": 8
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:34.228Z",
        "request_id": "f8d8cf14-9388-497e-b7a2-aa9ab45d89b9"
    },
    "status": "ok",
    "message": "Funding retrieved successfully",
    "success": true
}
```

#### `GET /v1/instruments` — List every trading pair with specs

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

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

**Response:**
```json
{
    "data": {
        "count": 608,
        "venue": "bitunix",
        "instruments": [
            {
                "base": "BTC",
                "quote": "USDT",
                "symbol": "BTCUSDT",
                "min_trade_volume": 0.0001,
                "max_limit_order_volume": 1200,
                "max_market_order_volume": 120
            },
            {
                "base": "ETH",
                "quote": "USDT",
                "symbol": "ETHUSDT",
                "min_trade_volume": 0.003,
                "max_limit_order_volume": 100000,
                "max_market_order_volume": 10000
            },
            {
                "base": "BNB",
                "quote": "USDT",
                "symbol": "BNBUSDT",
                "min_trade_volume": 0.01,
                "max_limit_order_volume": 100000,
                "max_market_order_volume": 2000
            },
            {
                "base": "XRP",
                "quote": "USDT",
                "symbol": "XRPUSDT",
                "min_trade_volume": 2,
                "max_limit_order_volume": 10000000,
                "max_market_order_volume": 2000000
            },
            {
                "base": "ADA",
                "quote": "USDT",
                "symbol": "ADAUSDT",
                "min_trade_volume": 15,
                "max_limit_order_volume": 3000000,
                "max_market_order_volume": 1000000
            },
            {
                "base": "LTC",
         
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/orderbook` — Live order book

**Parameters:**
- `symbol` (query, required, string) — Bitunix symbol Example: `ETHUSDT`
- `limit` (query, optional, string) — Levels: 1, 5, 15, 50 or max Example: `15`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bitunix-api/v1/orderbook?symbol=ETHUSDT&limit=15"
```

**Response:**
```json
{
    "data": {
        "asks": [
            {
                "size": 29.543,
                "price": 1740.66
            },
            {
                "size": 10.696,
                "price": 1740.67
            },
            {
                "size": 16.917,
                "price": 1740.68
            },
            {
                "size": 29.06,
                "price": 1740.69
            },
            {
                "size": 35.451,
                "price": 1740.7
            },
            {
                "size": 16.101,
                "price": 1740.72
            },
            {
                "size": 34.763,
                "price": 1740.73
            },
            {
                "size": 37.06,
                "price": 1740.74
            },
            {
                "size": 16.918,
                "price": 1740.75
            },
            {
                "size": 12.584,
                "price": 1740.76
            },
            {
                "size": 17.909,
                "price": 1740.77
            },
            {
                "size": 45.334,
                "price": 1740.78
            },
            {
                "size": 40.521,
                "price": 1740.79
            },
            {
                "size": 31.922,
                "price": 1740.8
            },
            {
                "size": 19.167,
                "price": 1740.81
            }
        ],
        "bids": [
            {
                "s
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/ticker` — 24h ticker for a trading pair

**Parameters:**
- `symbol` (query, required, string) — Bitunix symbol Example: `BTCUSDT`

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

**Response:**
```json
{
    "data": {
        "last": 65898.5,
        "symbol": "BTCUSDT",
        "low_24h": 63650.9,
        "high_24h": 65989.9,
        "open_24h": 64528.9,
        "mark_price": 65896,
        "base_volume_24h": 25632.5234,
        "quote_volume_24h": 1666559311.28045
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:35.040Z",
        "request_id": "db3b72a1-cf7a-4761-b5a4-88ccb0c6c0a6"
    },
    "status": "ok",
    "message": "Ticker retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Venue metadata & endpoint guide

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

**Response:**
```json
{
    "data": {
        "venue": "Bitunix",
        "source": "Bitunix public futures REST (fapi.bitunix.com/api/v1/futures/market), keyless",
        "examples": {
            "ticker": "/v1/ticker?symbol=BTCUSDT",
            "candles": "/v1/candles?symbol=BTCUSDT&interval=1h&limit=100",
            "funding": "/v1/funding?symbol=BTCUSDT",
            "orderbook": "/v1/orderbook?symbol=ETHUSDT&limit=15",
            "instruments": "/v1/instruments?quote=USDT"
        },
        "endpoints": {
            "/v1/ticker": "24h ticker: last/mark price, high/low/open, volume (symbol=BTCUSDT)",
            "/v1/candles": "OHLC candles (symbol, interval, limit)",
            "/v1/funding": "latest funding rate with next funding time (symbol)",
            "/v1/orderbook": "live order book (symbol, limit in 1/5/15/50/max)",
            "/v1/instruments": "list every trading pair with contract specs (filter quote)"
        },
        "intervals": [
            "1m",
            "3m",
            "5m",
            "15m",
            "30m",
            "1h",
            "2h",
            "4h",
            "6h",
            "8h",
            "12h",
            "1d",
            "1w"
        ],
        "instrument": "perpetual futures",
        "cache_ttl_ms": 5000,
        "depth_levels": [
            "1",
            "5",
            "15",
            "50",
            "max"
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:35.154Z",
        "request_id": "d8aa5eb0
…(truncated, see openapi.json for full schema)
```


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