# BingX Exchange API
> Live spot market data from BingX, a global crypto exchange, served straight from its public spot API with no key and nothing cached. The ticker endpoint returns a market's last price, open, 24-hour high and low, 24-hour change, best bid and ask 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 order-size and notional limits and tick/step size. 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 BingX on each request, nothing stored. A distinct global venue, separate from the other exchange feeds on the marketplace. Markets are written BASE-QUOTE; BTC_USDT is also accepted. 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/bingx-api/..."
```

## Pricing
- **Free** (Free) — 5,350 calls/Mo, 2 req/s
- **Starter** ($9/Mo) — 95,000 calls/Mo, 6 req/s
- **Pro** ($26/Mo) — 502,000 calls/Mo, 18 req/s
- **Business** ($62/Mo) — 3,060,000 calls/Mo, 45 req/s

## Endpoints

### Market

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

**Parameters:**
- `market` (query, required, string) — Market BASE-QUOTE or BASE_QUOTE 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/bingx-api/v1/book?market=BTC-USDT&limit=20"
```

**Response:**
```json
{
    "data": {
        "asks": [
            {
                "price": 62714.01,
                "amount": 0.00702
            },
            {
                "price": 62716.7,
                "amount": 3.245687
            },
            {
                "price": 62716.71,
                "amount": 0.464389
            },
            {
                "price": 62716.72,
                "amount": 0.00013
            },
            {
                "price": 62716.96,
                "amount": 0.003394
            },
            {
                "price": 62717.58,
                "amount": 0.002688
            },
            {
                "price": 62718.17,
                "amount": 0.000151
            },
            {
                "price": 62718.18,
                "amount": 0.040551
            },
            {
                "price": 62718.53,
                "amount": 0.006172
            },
            {
                "price": 62719.23,
                "amount": 0.432655
            },
            {
                "price": 62719.37,
                "amount": 0.000203
            },
            {
                "price": 62719.38,
                "amount": 0.180009
            },
            {
                "price": 62719.78,
                "amount": 0.026882
            },
            {
                "price": 62719.79,
                "amount": 0.064754
            },
            {
                "price": 62719.84,
                "amount": 8.0e-5
 
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/markets` — Tradable pairs with size and notional limits

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

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

**Response:**
```json
{
    "data": {
        "count": 2160,
        "quote": "USDT",
        "source": "BingX",
        "markets": [
            {
                "base": "WLKN",
                "quote": "USDT",
                "market": "WLKN-USDT",
                "status": 0,
                "max_qty": 4951,
                "min_qty": 123.7,
                "step_size": 0.1,
                "tick_size": 1.0e-5,
                "max_notional": 20000,
                "min_notional": 5
            },
            {
                "base": "EVDC",
                "quote": "USDT",
                "market": "EVDC-USDT",
                "status": 1,
                "max_qty": 848176420.7,
                "min_qty": 42409,
                "step_size": 0.01,
                "tick_size": 1.0e-8,
                "max_notional": 20000,
                "min_notional": 1
            },
            {
                "base": "ELA",
                "quote": "USDT",
                "market": "ELA-USDT",
                "status": 1,
                "max_qty": 346.37,
                "min_qty": 0.246,
                "step_size": 0.001,
                "tick_size": 0.0001,
                "max_notional": 790,
                "min_notional": 1
            },
            {
                "base": "IRYNA",
                "quote": "USDT",
                "market": "IRYNA-USDT",
                "status": 0,
                "max_qty": 414421.89,
                "min_qty": 41.5,
                "step_size": 0.01,
      
…(truncated, see openapi.json for full schema)
```

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

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

**Response:**
```json
{
    "data": {
        "ask": 62714.01,
        "bid": 62714,
        "base": "BTC",
        "last": 62714,
        "quote": "USDT",
        "market": "BTC-USDT",
        "source": "BingX",
        "spread": 0.01,
        "low_24h": 60782.15,
        "high_24h": 62989.75,
        "open_24h": 61719.71,
        "timestamp": 1781164138339,
        "change_24h": 994.29,
        "change_24h_pct": 1.61,
        "base_volume_24h": 3225.05,
        "quote_volume_24h": 199677979.2
    },
    "meta": {
        "timestamp": "2026-06-11T07:48:58.442Z",
        "request_id": "d720fa73-476d-4998-9f93-92eee94ec09e"
    },
    "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/bingx-api/v1/tickers?quote=USDT&limit=50"
```

**Response:**
```json
{
    "data": {
        "count": 50,
        "quote": "USDT",
        "source": "BingX",
        "tickers": [
            {
                "ask": 62714.01,
                "bid": 62714,
                "base": "BTC",
                "last": 62714,
                "quote": "USDT",
                "market": "BTC-USDT",
                "spread": 0.01,
                "low_24h": 60782.15,
                "high_24h": 62989.75,
                "open_24h": 61719.71,
                "timestamp": 1781164138630,
                "change_24h": 994.29,
                "change_24h_pct": 1.61,
                "base_volume_24h": 3225.05,
                "quote_volume_24h": 199677979.2
            },
            {
                "ask": 1653.92,
                "bid": 1653.91,
                "base": "ETH",
                "last": 1653.91,
                "quote": "USDT",
                "market": "ETH-USDT",
                "spread": 0.01,
                "low_24h": 1604.62,
                "high_24h": 1667.74,
                "open_24h": 1640.09,
                "timestamp": 1781164138630,
                "change_24h": 13.82,
                "change_24h_pct": 0.84,
                "base_volume_24h": 61262.93,
                "quote_volume_24h": 100225535.64
            },
            {
                "ask": 1.00094,
                "bid": 1.00093,
                "base": "USDC",
                "last": 1.00093,
                "quote": "USDT",
                "market": "USDC-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/bingx-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "Markets are BASE-QUOTE (e.g. BTC-USDT); BTC_USDT is also accepted. change_24h_pct is the 24h change; quote_volume_24h is in the quote currency.",
        "source": "BingX API (open-api.bingx.com/openApi/spot/v1, live)",
        "service": "bingx-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 order-size and notional limits (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 BingX, a global crypto exchange. The ticker endpoint returns a market's last price, open, 24h high/low, 24h change, best bid/ask 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 order-size and notional limits; the book endpoint returns live order-book depth. Live, no key, nothing stored. A distinct global venue, separate from other exchange feeds.",
        "market_count": 882,
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-11T07:48:59.598Z",
        "request_id": "98d75771-aa44-4fb3-80b4-af34cd4cda5c"
  
…(truncated, see openapi.json for full schema)
```


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