# Binance Market Data API
> Live Binance crypto exchange market data as an API — clean JSON, no key. Get the current price of any trading pair, full 24-hour ticker statistics (open, high, low, last, price change, weighted average, best bid/ask and volume), candlesticks (klines) for any interval from one minute to one month, the live order book (bids and asks with quantities), recent trades, the current average price, and the full list of trading pairs filtered by quote asset. Live data straight from Binance's public market endpoints. Distinct from aggregate coin-market data: this is exchange-native trading data — order book, candles and live ticks — ideal for trading bots, price feeds, charts, backtesting and crypto dashboards. 7 data endpoints. Authenticated with an x-oanor-key; fair-use rate limits per plan.

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

## Pricing
- **Free** (Free) — 3,000 calls/Mo, 5 req/s
- **Starter** ($10/Mo) — 55,000 calls/Mo, 15 req/s
- **Pro** ($39/Mo) — 320,000 calls/Mo, 30 req/s
- **Mega** ($139/Mo) — 1,500,000 calls/Mo, 80 req/s

## Endpoints

### Prices

#### `GET /v1/avg-price` — Current average price

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

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

**Response:**
```json
{
    "data": {
        "price": 63051.46947589,
        "symbol": "BTCUSDT",
        "minutes": 5
    },
    "meta": {
        "timestamp": "2026-06-08T01:20:12.841Z",
        "request_id": "3561df5e-fa18-4769-843b-ddb0868dbcaf"
    },
    "status": "ok",
    "message": "Average price retrieved successfully",
    "success": true
}
```

#### `GET /v1/price` — Current price

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

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

**Response:**
```json
{
    "data": {
        "price": 63026.53,
        "symbol": "BTCUSDT"
    },
    "meta": {
        "timestamp": "2026-06-08T01:20:13.181Z",
        "request_id": "6a22a041-c5fd-45e9-96cc-e7f0948c4d28"
    },
    "status": "ok",
    "message": "Price retrieved successfully",
    "success": true
}
```

#### `GET /v1/ticker` — 24-hour ticker statistics

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

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

**Response:**
```json
{
    "data": {
        "ticker": {
            "symbol": "BTCUSDT",
            "volume": 27038.75152,
            "ask_price": 63026.54,
            "bid_price": 63026.53,
            "low_price": 61184,
            "open_time": 1780795213003,
            "close_time": 1780881613003,
            "high_price": 64234.68,
            "last_price": 63026.53,
            "open_price": 61490,
            "trade_count": 4928950,
            "price_change": 1536.53,
            "quote_volume": 1686876898.3102756,
            "weighted_avg_price": 62387.38120222,
            "price_change_percent": 2.499
        }
    },
    "meta": {
        "timestamp": "2026-06-08T01:20:13.964Z",
        "request_id": "846bf6eb-6f0c-4c4a-8286-939ee3830d23"
    },
    "status": "ok",
    "message": "Ticker retrieved successfully",
    "success": true
}
```

### Charts

#### `GET /v1/klines` — Candlesticks (OHLCV)

**Parameters:**
- `symbol` (query, required, string) — Trading pair Example: `BTCUSDT`
- `interval` (query, optional, string) — 1m,5m,15m,1h,4h,1d,1w,1M … Example: `1h`
- `limit` (query, optional, string) — Max candles (1–1000) Example: `100`

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

**Response:**
```json
{
    "data": {
        "count": 100,
        "symbol": "BTCUSDT",
        "candles": [
            {
                "low": 64778.15,
                "high": 65841.23,
                "open": 65768.89,
                "close": 64912.98,
                "trades": 383759,
                "volume": 974.52056,
                "open_time": 1780524000000,
                "close_time": 1780527599999,
                "quote_volume": 63543702.2703344
            },
            {
                "low": 64092.49,
                "high": 64979.99,
                "open": 64912.97,
                "close": 64142.75,
                "trades": 371919,
                "volume": 1820.23083,
                "open_time": 1780527600000,
                "close_time": 1780531199999,
                "quote_volume": 117348881.7711745
            },
            {
                "low": 63000,
                "high": 64428,
                "open": 64142.75,
                "close": 63344.97,
                "trades": 657007,
                "volume": 3512.79677,
                "open_time": 1780531200000,
                "close_time": 1780534799999,
                "quote_volume": 223539486.9079594
            },
            {
                "low": 62100.01,
                "high": 63500,
                "open": 63344.98,
                "close": 62178.1,
                "trades": 774415,
                "volume": 4759.0413,
                "open_time": 1780534800000,
                "close_time": 1
…(truncated, see openapi.json for full schema)
```

### Trading

#### `GET /v1/depth` — Order book

**Parameters:**
- `symbol` (query, required, string) — Trading pair Example: `BTCUSDT`
- `limit` (query, optional, string) — Levels (1–500) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/binance-api/v1/depth?symbol=BTCUSDT&limit=50"
```

**Response:**
```json
{
    "data": {
        "asks": [
            {
                "qty": 1.36088,
                "price": 63035.88
            },
            {
                "qty": 0.00097,
                "price": 63035.89
            },
            {
                "qty": 8.0e-5,
                "price": 63035.9
            },
            {
                "qty": 9.0e-5,
                "price": 63035.99
            },
            {
                "qty": 0.02518,
                "price": 63036
            },
            {
                "qty": 0.00016,
                "price": 63036.65
            },
            {
                "qty": 0.00018,
                "price": 63036.73
            },
            {
                "qty": 0.02484,
                "price": 63037.14
            },
            {
                "qty": 9.0e-5,
                "price": 63037.2
            },
            {
                "qty": 0.02637,
                "price": 63037.21
            },
            {
                "qty": 0.07007,
                "price": 63037.22
            },
            {
                "qty": 9.0e-5,
                "price": 63037.44
            },
            {
                "qty": 9.0e-5,
                "price": 63037.79
            },
            {
                "qty": 0.01731,
                "price": 63037.8
            },
            {
                "qty": 9.0e-5,
                "price": 63037.99
            },
            {
                "qty": 0.02518,
       
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/trades` — Recent trades

**Parameters:**
- `symbol` (query, required, string) — Trading pair Example: `BTCUSDT`
- `limit` (query, optional, string) — Max trades (1–1000) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/binance-api/v1/trades?symbol=BTCUSDT&limit=50"
```

**Response:**
```json
{
    "data": {
        "count": 50,
        "symbol": "BTCUSDT",
        "trades": [
            {
                "id": 6385337393,
                "qty": 8.0e-5,
                "time": 1780881614164,
                "price": 63032,
                "quote_qty": 5.04256,
                "is_buyer_maker": false
            },
            {
                "id": 6385337394,
                "qty": 8.0e-5,
                "time": 1780881614164,
                "price": 63032,
                "quote_qty": 5.04256,
                "is_buyer_maker": false
            },
            {
                "id": 6385337395,
                "qty": 8.0e-5,
                "time": 1780881614164,
                "price": 63032.2,
                "quote_qty": 5.042576,
                "is_buyer_maker": false
            },
            {
                "id": 6385337396,
                "qty": 9.0e-5,
                "time": 1780881614164,
                "price": 63032.22,
                "quote_qty": 5.6728998,
                "is_buyer_maker": false
            },
            {
                "id": 6385337397,
                "qty": 9.0e-5,
                "time": 1780881614164,
                "price": 63032.22,
                "quote_qty": 5.6728998,
                "is_buyer_maker": false
            },
            {
                "id": 6385337398,
                "qty": 8.0e-5,
                "time": 1780881614164,
                "price": 63032.37,
                "quote_qty": 5.04
…(truncated, see openapi.json for full schema)
```

### Reference

#### `GET /v1/symbols` — Trading pairs

**Parameters:**
- `quote` (query, optional, string) — Filter by quote asset (e.g. USDT) Example: `USDT`
- `limit` (query, optional, string) — Max results Example: `500`

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

**Response:**
```json
{
    "data": {
        "count": 430,
        "quote": "USDT",
        "total": 430,
        "symbols": [
            {
                "symbol": "BTCUSDT",
                "is_spot": true,
                "base_asset": "BTC",
                "quote_asset": "USDT"
            },
            {
                "symbol": "ETHUSDT",
                "is_spot": true,
                "base_asset": "ETH",
                "quote_asset": "USDT"
            },
            {
                "symbol": "BNBUSDT",
                "is_spot": true,
                "base_asset": "BNB",
                "quote_asset": "USDT"
            },
            {
                "symbol": "NEOUSDT",
                "is_spot": true,
                "base_asset": "NEO",
                "quote_asset": "USDT"
            },
            {
                "symbol": "LTCUSDT",
                "is_spot": true,
                "base_asset": "LTC",
                "quote_asset": "USDT"
            },
            {
                "symbol": "QTUMUSDT",
                "is_spot": true,
                "base_asset": "QTUM",
                "quote_asset": "USDT"
            },
            {
                "symbol": "ADAUSDT",
                "is_spot": true,
                "base_asset": "ADA",
                "quote_asset": "USDT"
            },
            {
                "symbol": "XRPUSDT",
                "is_spot": true,
                "base_asset": "XRP",
                "quote_asset": "USDT"
            },

…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "service": "binance-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/depth": "Order book (symbol=, limit=).",
            "GET /v1/price": "Current price for a symbol (e.g. BTCUSDT).",
            "GET /v1/klines": "Candlesticks (symbol=, interval=, limit=).",
            "GET /v1/ticker": "24-hour ticker stats for a symbol.",
            "GET /v1/trades": "Recent trades (symbol=, limit=).",
            "GET /v1/symbols": "Trading pairs (quote= filter, e.g. USDT).",
            "GET /v1/avg-price": "Current average price for a symbol."
        },
        "description": "Binance crypto exchange market data: current prices, 24-hour ticker stats, candlesticks (klines), the order book (depth), recent trades, average price and trading pairs. Real live data, no key."
    },
    "meta": {
        "timestamp": "2026-06-08T01:20:16.021Z",
        "request_id": "378069da-e736-4608-9e0a-e6aebacf0da6"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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