Skip to main content

Overview

Binance Futures is the derivatives arm of Binance, offering USD-M (USDT-margined) perpetual futures contracts. Perpetual futures have no expiration date and use a funding rate mechanism to keep the contract price anchored to the spot index. Kwery ingests the same OHLCV and ticker data as Binance Spot, plus derivatives-specific fields like funding_rate and open_interest.

What we ingest

  • OHLCV candlestick data with taker buy ratio
  • Funding rate at each interval
  • Open interest (total outstanding contracts)
  • 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
Contract typeUSD-M perpetual (USDT-margined, no expiry)
Quote currencyUSDT
Symbol formatShort form — BTC, not BTCUSDT
Funding ratePercentage rate, settled every 8 hours
Open interestTotal notional value of outstanding contracts
ℹ️Info

Funding rate is a periodic payment between longs and shorts. A positive rate means longs pay shorts; a negative rate means shorts pay longs. Rates are settled every 8 hours (00:00, 08:00, 16:00 UTC).

Available endpoints

List available symbols

GET /v1/binance/futures

Returns all tracked Binance Futures symbols and their metadata.

curl "https://kwery-api.com/v1/binance/futures?api-key=YOUR_KEY"
{
  "source": "binance_futures",
  "symbols": [
    { "symbol": "BTC", "pair": "BTCUSDT", "contract_type": "perpetual", "status": "active" },
    { "symbol": "ETH", "pair": "ETHUSDT", "contract_type": "perpetual", "status": "active" },
    { "symbol": "SOL", "pair": "SOLUSDT", "contract_type": "perpetual", "status": "active" },
    { "symbol": "XRP", "pair": "XRPUSDT", "contract_type": "perpetual", "status": "active" }
  ]
}

Get OHLCV candles

GET /v1/binance/futures/{symbol}

Returns OHLCV candlestick data with funding rate and open interest.

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/futures/BTC?api-key=YOUR_KEY&interval=1h&limit=3"
{
  "symbol": "BTC",
  "source": "binance_futures",
  "interval": "1h",
  "candles": [
    {
      "timestamp": "2026-03-09T12:00:00Z",
      "open": 78280.00,
      "high": 78510.50,
      "low": 78120.30,
      "close": 78390.20,
      "volume": 2450.78,
      "taker_buy_ratio": 0.52,
      "funding_rate": 0.0001,
      "open_interest": 58420.15
    },
    {
      "timestamp": "2026-03-09T11:00:00Z",
      "open": 78150.40,
      "high": 78340.00,
      "low": 78050.10,
      "close": 78280.00,
      "volume": 2180.34,
      "taker_buy_ratio": 0.47,
      "funding_rate": 0.0001,
      "open_interest": 57890.60
    },
    {
      "timestamp": "2026-03-09T10:00:00Z",
      "open": 77920.50,
      "high": 78200.80,
      "low": 77850.00,
      "close": 78150.40,
      "volume": 1920.12,
      "taker_buy_ratio": 0.59,
      "funding_rate": 0.0001,
      "open_interest": 57210.30
    }
  ],
  "total": 720,
  "limit": 3,
  "offset": 0
}

Get 1-second ticker

GET /v1/binance/futures/{symbol}/ticker

Pro Returns 1-second ticker snapshots. Same shape as the spot ticker.

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/futures/BTC/ticker?api-key=YOUR_KEY&limit=3"
{
  "symbol": "BTC",
  "source": "binance_futures",
  "interval": "1s",
  "ticks": [
    {
      "timestamp": "2026-03-09T12:00:01Z",
      "best_bid": 78389.00,
      "best_ask": 78390.50,
      "best_bid_qty": 1.20,
      "best_ask_qty": 0.85
    },
    {
      "timestamp": "2026-03-09T12:00:02Z",
      "best_bid": 78390.10,
      "best_ask": 78391.30,
      "best_bid_qty": 0.95,
      "best_ask_qty": 1.10
    },
    {
      "timestamp": "2026-03-09T12:00:03Z",
      "best_bid": 78388.50,
      "best_ask": 78389.80,
      "best_bid_qty": 1.45,
      "best_ask_qty": 0.72
    }
  ],
  "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)
funding_ratefloatFunding rate for the interval (e.g. 0.0001 = 0.01%)
open_interestfloatTotal outstanding contract value (base asset units)
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

  • Funding rate is a snapshot, not a time-series. The funding_rate field on each candle reflects the most recent settled or predicted funding rate at that point in time. It changes at 00:00, 08:00, and 16:00 UTC when settlement occurs.
  • Open interest is in base asset units. An open_interest of 58420.15 for BTCUSDT means 58,420.15 BTC worth of contracts are outstanding, not $58,420.
  • Ticker requires Pro plan. The /ticker endpoint is restricted to Pro, Business, and Enterprise plans — identical to the spot ticker.
  • Futures prices can deviate from spot. During periods of high funding or extreme sentiment, the perpetual price may trade at a premium or discount to spot. Compare against Binance Spot for basis analysis.
  • Symbols are short form. Use BTC, not BTCUSDT. The pair mapping is handled internally.
  • Same response shape as spot (plus derivatives fields). If you're already consuming Binance Spot data, switching to futures requires no structural changes — just handle the additional funding_rate and open_interest fields.