# Binance on Onekey

> 8 endpoints for Binance (8 stable, 0 beta), 1 to 5 credits each. Category: Finance & markets. One key, one JSON shape.

Base URL: https://api.onekey.dev
Auth: header `x-api-key: <key>`. Call shape: `GET /v1/{platform}/{endpoint}?{params}`.
Every response is `{success, data, metadata, error}`; check `success` first. Cost is in `metadata.credits_charged`. Free when served from cache (0.2 credit for a cached response over 100 KB). Failed and not-found calls are refunded.
Status: stable = verified against the live source; beta = not yet verified, fields may be missing.

Page: https://onekey.dev/platforms/binance
Reference (Markdown): https://onekey.dev/docs/api/binance.md
All docs: https://onekey.dev/llms.txt

## Canonical fields returned

Unified-schema fields (same names on every platform), with how many of the 8 mapped Binance endpoints return each:

- `entity.date` (ISO 8601 date): 4
- `market.symbol` (string): 4
- `market.ask` (number): 3
- `market.bid` (number): 3
- `market.price` (number): 3
- `entity.id` (string): 2
- `entity.category` (string): 1
- `market.change24h` (number): 1
- `market.change24hPct` (number): 1
- `market.close` (number): 1
- `market.high` (number): 1
- `market.low` (number): 1
- `market.open` (number): 1
- `market.volume` (number): 1
- `market.volume24h` (number): 1
- plus 26 platform-specific fields under `ext.`

## Endpoints

### binance.avg_price

Current 5-minute average price for a spot symbol.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/binance/avg_price?symbol=BTCUSDT` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `symbol` (string, required): Spot symbol, UPPERCASE, e.g. BTCUSDT
- Fields returned: `entity.date`, `ext.avgPrice`, `ext.windowMinutes`
- Reference: https://onekey.dev/docs/api/binance/avg_price.md

### binance.book_ticker

Best bid/ask price and quantity for a spot symbol.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/binance/book_ticker?symbol=BTCUSDT` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `symbol` (string, required): Spot symbol, UPPERCASE, e.g. BTCUSDT
- Fields returned: `market.symbol`, `market.bid`, `market.ask`, `ext.bidQty`, `ext.askQty`
- Reference: https://onekey.dev/docs/api/binance/book_ticker.md

### binance.depth

Order book snapshot (top levels) for a spot symbol.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/binance/depth?symbol=BTCUSDT&limit=5` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `symbol` (string, required): Spot symbol, UPPERCASE, e.g. BTCUSDT
  - `limit` (string, optional, default 20): Depth levels
- Fields returned: `entity.id`, `market.bid`, `market.ask`, `ext.bestBidQty`, `ext.bestAskQty`, `ext.bids`, `ext.asks`
- Reference: https://onekey.dev/docs/api/binance/depth.md

### binance.klines

Candlesticks (OHLCV) for a spot symbol.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/binance/klines?symbol=BTCUSDT&limit=10` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `symbol` (string, required): Spot symbol, UPPERCASE, e.g. BTCUSDT
  - `interval` (string, optional, default 1h): Candle interval
  - `limit` (string, optional, default 100): Number of candles (1-500)
- Fields returned: `entity.date`, `market.open`, `market.high`, `market.low`, `market.close`, `market.volume`, `ext.quoteVolume`, `ext.trades`
- Reference: https://onekey.dev/docs/api/binance/klines.md

### binance.price

Latest price for a spot symbol.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/binance/price?symbol=BTCUSDT` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `symbol` (string, required): Spot symbol, UPPERCASE, e.g. BTCUSDT
- Fields returned: `market.symbol`, `market.price`
- Reference: https://onekey.dev/docs/api/binance/price.md

### binance.symbol_info

Trading rules and status for a spot symbol.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/binance/symbol_info?symbol=BTCUSDT` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `symbol` (string, required): Spot symbol, UPPERCASE, e.g. BTCUSDT
- Fields returned: `market.symbol`, `entity.category`, `ext.baseAsset`, `ext.quoteAsset`, `ext.baseAssetPrecision`, `ext.quotePrecision`, `ext.spotTradingAllowed`, `ext.marginTradingAllowed`, `ext.orderTypes`
- Reference: https://onekey.dev/docs/api/binance/symbol_info.md

### binance.ticker_24h

24h rolling ticker for a spot symbol.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/binance/ticker_24h?symbol=BTCUSDT` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `symbol` (string, required): Spot symbol, UPPERCASE, e.g. BTCUSDT
- Fields returned: `market.symbol`, `market.price`, `market.change24h`, `market.change24hPct`, `market.volume24h`, `market.bid`, `market.ask`, `entity.date`, `ext.high24h`, `ext.low24h`, `ext.open24h`, `ext.vwap24h`, `ext.quoteVolume24h`, `ext.trades24h`
- Reference: https://onekey.dev/docs/api/binance/ticker_24h.md

### binance.trades

Most recent public trades for a spot symbol.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/binance/trades?symbol=BTCUSDT&limit=10` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `symbol` (string, required): Spot symbol, UPPERCASE, e.g. BTCUSDT
  - `limit` (string, optional, default 50): Rows (1-100)
- Fields returned: `entity.id`, `market.price`, `entity.date`, `ext.qty`, `ext.quoteQty`, `ext.isBuyerMaker`
- Reference: https://onekey.dev/docs/api/binance/trades.md

## Sample request

```bash
curl "https://api.onekey.dev/v1/binance/avg_price?symbol=BTCUSDT" \
  -H "x-api-key: YOUR_API_KEY"
```