Overview
Binance is the world's largest cryptocurrency exchange by volume. Kwery ingests spot market data for USDT-quoted pairs and normalizes it into two formats: OHLCV candlestick data for historical analysis and 1-second ticker snapshots for high-frequency use cases.
What we ingest
- OHLCV candlestick data with volume and taker buy ratio
- 1-second ticker snapshots with best bid/ask and quoted quantities
Currently tracked pairs: BTCUSDT, ETHUSDT, SOLUSDT, XRPUSDT (queried as BTC, ETH, SOL, XRP).
Data semantics
| Concept | Detail |
|---|
| Quote currency | USDT for all pairs |
| Symbol format | Short form — BTC, not BTCUSDT |
| OHLCV | Standard open/high/low/close/volume candles |
taker_buy_ratio | Fraction of volume initiated by buyers (0–1) |
| Ticker | Real-time best bid/ask with size, 1-second granularity |
Available endpoints
List available symbols
GET /v1/binance/spot
Returns all tracked Binance spot symbols and their metadata.
curl "https://kwery-api.com/v1/binance/spot?api-key=YOUR_KEY"
{
"source": "binance_spot",
"symbols": [
{ "symbol": "BTC", "pair": "BTCUSDT", "status": "active" },
{ "symbol": "ETH", "pair": "ETHUSDT", "status": "active" },
{ "symbol": "SOL", "pair": "SOLUSDT", "status": "active" },
{ "symbol": "XRP", "pair": "XRPUSDT", "status": "active" }
]
}
Get OHLCV candles
GET /v1/binance/spot/{symbol}
Returns OHLCV candlestick data for a spot pair.
| Parameter | Type | Required | Default | Description |
|---|
symbol | string | Yes | — | Asset symbol (e.g. BTC, ETH, SOL, XRP) |
interval | string | Yes | — | Candle interval: 5m, 15m, 1h, 4h, 24h |
start | string | No | — | ISO 8601 start time |
end | string | No | — | ISO 8601 end time |
limit | integer | No | 100 | Maximum candles to return |
offset | integer | No | 0 | Number of records to skip |
curl "https://kwery-api.com/v1/binance/spot/BTC?api-key=YOUR_KEY&interval=1h&limit=3"
{
"symbol": "BTC",
"source": "binance_spot",
"interval": "1h",
"candles": [
{
"timestamp": "2026-03-09T12:00:00Z",
"open": 78234.51,
"high": 78489.00,
"low": 78100.22,
"close": 78350.75,
"volume": 1234.56,
"taker_buy_ratio": 0.54
},
{
"timestamp": "2026-03-09T11:00:00Z",
"open": 78102.30,
"high": 78310.00,
"low": 78001.10,
"close": 78234.51,
"volume": 1087.23,
"taker_buy_ratio": 0.48
},
{
"timestamp": "2026-03-09T10:00:00Z",
"open": 77890.00,
"high": 78150.50,
"low": 77812.40,
"close": 78102.30,
"volume": 952.18,
"taker_buy_ratio": 0.61
}
],
"total": 720,
"limit": 3,
"offset": 0
}
Get 1-second ticker
GET /v1/binance/spot/{symbol}/ticker
Pro Returns 1-second ticker snapshots with best bid/ask and quoted size.
| Parameter | Type | Required | Default | Description |
|---|
symbol | string | Yes | — | Asset symbol (e.g. BTC, ETH) |
start | string | No | — | ISO 8601 start time |
end | string | No | — | ISO 8601 end time |
limit | integer | No | 100 | Maximum ticks to return |
offset | integer | No | 0 | Number of records to skip |
curl "https://kwery-api.com/v1/binance/spot/BTC/ticker?api-key=YOUR_KEY&limit=3"
{
"symbol": "BTC",
"source": "binance_spot",
"interval": "1s",
"ticks": [
{
"timestamp": "2026-03-09T12:00:01Z",
"best_bid": 78349.50,
"best_ask": 78350.80,
"best_bid_qty": 0.42,
"best_ask_qty": 0.38
},
{
"timestamp": "2026-03-09T12:00:02Z",
"best_bid": 78350.10,
"best_ask": 78351.20,
"best_bid_qty": 0.55,
"best_ask_qty": 0.31
},
{
"timestamp": "2026-03-09T12:00:03Z",
"best_bid": 78348.90,
"best_ask": 78350.00,
"best_bid_qty": 0.60,
"best_ask_qty": 0.45
}
],
"total": 86400,
"limit": 3,
"offset": 0
}
Source-specific fields
OHLCV candles
| Field | Type | Description |
|---|
open | float | Opening price (USDT) |
high | float | Highest price in interval |
low | float | Lowest price in interval |
close | float | Closing price (USDT) |
volume | float | Total traded volume (base asset units) |
taker_buy_ratio | float | Fraction of volume from taker buy orders (0–1) |
timestamp | string | ISO 8601 interval open time |
1-second ticker
| Field | Type | Description |
|---|
best_bid | float | Best bid price (USDT) |
best_ask | float | Best ask price (USDT) |
best_bid_qty | float | Size at best bid (base asset units) |
best_ask_qty | float | Size at best ask (base asset units) |
timestamp | string | ISO 8601 tick time |
Available intervals
OHLCV
| Interval | Description | Minimum plan |
|---|
5m | 5-minute candles | Free |
15m | 15-minute candles | Free |
1h | Hourly candles | Free |
4h | 4-hour candles | Free |
24h | Daily candles | Free |
Ticker
| Interval | Description | Minimum plan |
|---|
1s | 1-second snapshots | Pro |
Limitations & notes
- USDT denomination only. All prices are quoted in USDT. If you need BTC-denominated pairs or other quote currencies, those are not currently supported.
- Ticker requires Pro plan. The
/ticker endpoint with 1-second granularity is restricted to Pro, Business, and Enterprise plans.
taker_buy_ratio context. A ratio of 0.50 means equal buyer and seller taker volume. Above 0.50 indicates net buying pressure; below indicates net selling. This is a useful signal for intrabar momentum analysis.
- Volume is in base asset units. A
volume of 1234.56 on BTCUSDT means 1,234.56 BTC were traded, not $1,234.56.
- Symbols are short form. Use
BTC, not BTCUSDT. Kwery handles the pair mapping internally.