⚠️Data availability
Candle/snapshot data for Binance spot started 2026-03-13; directional flow (/v1/flow) started 2026-03-17. We have not yet reached 31 days of data collection for this source. See Data availability for details.
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
/tickerendpoint with 1-second granularity is restricted to Pro, Business, and Enterprise plans. taker_buy_ratiocontext. A ratio of0.50means equal buyer and seller taker volume. Above0.50indicates net buying pressure; below indicates net selling. This is a useful signal for intrabar momentum analysis.- Volume is in base asset units. A
volumeof1234.56on BTCUSDT means 1,234.56 BTC were traded, not $1,234.56. - Symbols are short form. Use
BTC, notBTCUSDT. Kwery handles the pair mapping internally.