Skip to main content

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.