# Bitget API
> Live market data from Bitget, a top-tier centralised crypto exchange. The ticker endpoint returns a spot or USDT-perpetual symbol's last price, bid/ask, 24h high/low, volume and change. The tickers endpoint returns the top symbols by 24h volume for the spot or futures market. The funding endpoint returns a perpetual contract's current funding rate, funding interval, next funding time and open interest — the derivatives data traders watch. Read live from Bitget, nothing stored. This is Bitget's own spot and USDT-perpetual ticker, funding-rate and open-interest layer — a distinct centralised-exchange venue, separate from other exchange feeds and from DEX, lending and oracle APIs.

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

## Pricing
- **Free** (Free) — 2,600 calls/Mo, 3 req/s
- **Starter** ($9/Mo) — 70,000 calls/Mo, 15 req/s
- **Pro** ($24/Mo) — 360,000 calls/Mo, 40 req/s
- **Scale** ($56/Mo) — 2,300,000 calls/Mo, 120 req/s

## Endpoints

### Ticker

#### `GET /v1/ticker` — A spot or futures symbol ticker

**Parameters:**
- `symbol` (query, required, string) — Symbol (BTCUSDT or BTC) Example: `BTCUSDT`
- `market` (query, optional, string) — spot (default) or futures Example: `spot`

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

**Response:**
```json
{
    "data": {
        "ask": 61431.14,
        "bid": 61431.13,
        "last": 61431.14,
        "time": "2026-06-10T22:56:56.168Z",
        "market": "spot",
        "source": "Bitget",
        "symbol": "BTCUSDT",
        "low_24h": 60727.6,
        "high_24h": 62860,
        "change_24h_pct": -0.457,
        "base_volume_24h": 5025.629155,
        "quote_volume_24h": 309867513.37
    },
    "meta": {
        "timestamp": "2026-06-10T22:56:56.752Z",
        "request_id": "c6b7c36e-4cfd-4fe8-869a-dd380adb914d"
    },
    "status": "ok",
    "message": "Ticker retrieved successfully",
    "success": true
}
```

### Tickers

#### `GET /v1/tickers` — Top symbols by 24h volume

**Parameters:**
- `market` (query, optional, string) — spot (default) or futures Example: `spot`
- `limit` (query, optional, string) — Max results (1-200) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bitget-api/v1/tickers?market=spot&limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "market": "spot",
        "source": "Bitget",
        "tickers": [
            {
                "ask": 870.68,
                "bid": 870.5,
                "last": 870.59,
                "time": "2026-06-10T22:56:55.542Z",
                "market": "spot",
                "symbol": "RMUUSDT",
                "low_24h": 870.23,
                "high_24h": 913.97,
                "change_24h_pct": -4.976,
                "base_volume_24h": 55286403.27411,
                "quote_volume_24h": 50266491843.7
            },
            {
                "ask": 689.65,
                "bid": 689.52,
                "last": 689.68,
                "time": "2026-06-10T22:56:56.148Z",
                "market": "spot",
                "symbol": "RQQQUSDT",
                "low_24h": 689.67,
                "high_24h": 702.61,
                "change_24h_pct": -2.256,
                "base_volume_24h": 64751224.9245,
                "quote_volume_24h": 45334404608.77
            },
            {
                "ask": 722.92,
                "bid": 722.73,
                "last": 722.88,
                "time": "2026-06-10T22:56:55.543Z",
                "market": "spot",
                "symbol": "RSPYUSDT",
                "low_24h": 722.78,
                "high_24h": 732.51,
                "change_24h_pct": -1.63,
                "base_volume_24h": 60022160.3169,
                "quote_volume_24h": 43833631475.55
            },
        
…(truncated, see openapi.json for full schema)
```

### Funding

#### `GET /v1/funding` — A perpetual's funding rate, next time and open interest

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

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

**Response:**
```json
{
    "data": {
        "market": "futures",
        "source": "Bitget",
        "symbol": "BTCUSDT",
        "open_interest": 31607.1322,
        "funding_apr_pct": 4.161,
        "funding_rate_pct": 0.0038,
        "next_funding_time": "2026-06-11T00:00:00.000Z",
        "funding_interval_hours": 8
    },
    "meta": {
        "timestamp": "2026-06-10T22:56:57.531Z",
        "request_id": "dbf11e65-fee1-483b-ba1c-bb82bcdac95d"
    },
    "status": "ok",
    "message": "Funding retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata

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

**Response:**
```json
{
    "data": {
        "source": "Bitget API v2 (api.bitget.com, live)",
        "service": "bitget-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/ticker": "A symbol's ticker (symbol=BTCUSDT, market=spot|futures).",
            "GET /v1/funding": "A perpetual's funding rate, interval, next funding time and open interest (symbol=BTCUSDT).",
            "GET /v1/tickers": "Top symbols by 24h volume (market=spot|futures, limit=25)."
        },
        "description": "Live market data from Bitget, a top-tier centralised crypto exchange. The ticker endpoint returns a spot or USDT-perpetual symbol's last price, bid/ask, 24h high/low, volume and change; the tickers endpoint returns the top symbols by 24h volume for the spot or futures market; the funding endpoint returns a perpetual contract's current funding rate, funding interval, next funding time and open interest. Live, no key, nothing stored. Distinct centralised-exchange venue — separate from other exchange feeds and from DEX, lending and oracle APIs — this is Bitget's own spot and USDT-perpetual ticker, funding-rate and open-interest layer.",
        "upstream_status": "ok",
        "spot_symbol_count": 1002
    },
    "meta": {
        "timestamp": "2026-06-10T22:56:57.989Z",
        "request_id": "d04f1f09-2cc1-446f-ade5-f436455cab1f"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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