Skip to main content
⚠️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

ConceptDetail
Quote currencyUSDT for all pairs
Symbol formatShort form — BTC, not BTCUSDT
OHLCVStandard open/high/low/close/volume candles
taker_buy_ratioFraction of volume initiated by buyers (0–1)
TickerReal-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.

ParameterTypeRequiredDefaultDescription
symbolstringYesAsset symbol (e.g. BTC, ETH, SOL, XRP)
intervalstringYesCandle interval: 5m, 15m, 1h, 4h, 24h
startstringNoISO 8601 start time
endstringNoISO 8601 end time
limitintegerNo100Maximum candles to return
offsetintegerNo0Number 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.

ParameterTypeRequiredDefaultDescription
symbolstringYesAsset symbol (e.g. BTC, ETH)
startstringNoISO 8601 start time
endstringNoISO 8601 end time
limitintegerNo100Maximum ticks to return
offsetintegerNo0Number 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

FieldTypeDescription
openfloatOpening price (USDT)
highfloatHighest price in interval
lowfloatLowest price in interval
closefloatClosing price (USDT)
volumefloatTotal traded volume (base asset units)
taker_buy_ratiofloatFraction of volume from taker buy orders (0–1)
timestampstringISO 8601 interval open time

1-second ticker

FieldTypeDescription
best_bidfloatBest bid price (USDT)
best_askfloatBest ask price (USDT)
best_bid_qtyfloatSize at best bid (base asset units)
best_ask_qtyfloatSize at best ask (base asset units)
timestampstringISO 8601 tick time

Available intervals

OHLCV

IntervalDescriptionMinimum plan
5m5-minute candlesFree
15m15-minute candlesFree
1hHourly candlesFree
4h4-hour candlesFree
24hDaily candlesFree

Ticker

IntervalDescriptionMinimum plan
1s1-second snapshotsPro

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.