GET /v1/candles

Retrieve OHLCV candlestick data across all supported sources in a single unified endpoint.

Min Tier: Free | Credits: 50 base + 3 per row returned

Parameters

Response

Response Headers

Example

cURL

curl "https://kwery-api.com/v1/candles?api-key=YOUR_KEY&symbol=BTC&source=binance_futures&interval=4h&start=2026-03-01T00:00:00Z&end=2026-03-02T00:00:00Z&limit=6"

Python

import requests

resp = requests.get("https://kwery-api.com/v1/candles", params={
    "api-key": "YOUR_KEY",
    "symbol": "BTC",
    "source": "binance_futures",
    "interval": "4h",
    "start": "2026-03-01T00:00:00Z",
    "end": "2026-03-02T00:00:00Z",
    "limit": 6,
})
data = resp.json()

TypeScript

const params = new URLSearchParams({
  "api-key": "YOUR_KEY",
  "symbol": "BTC",
  "source": "binance_futures",
  "interval": "4h",
  "start": "2026-03-01T00:00:00Z",
  "end": "2026-03-02T00:00:00Z",
  "limit": "6",
});
const res = await fetch(`https://kwery-api.com/v1/candles?${params}`);
const data = await res.json();

Example Response

{
  "data": [
    {
      "timestamp": "2026-03-01T00:00:00Z",
      "symbol": "BTC",
      "source": "binance_futures",
      "interval": "4h",
      "open": 93850.00,
      "high": 94200.50,
      "low": 93600.00,
      "close": 94150.25,
      "volume": 8420.15,
      "num_trades": 184320,
      "taker_buy_ratio": 0.54,
      "funding_rate": 0.0001,
      "open_interest": 52340.80
    },
    {
      "timestamp": "2026-03-01T04:00:00Z",
      "symbol": "BTC",
      "source": "binance_futures",
      "interval": "4h",
      "open": 94150.25,
      "high": 94680.00,
      "low": 94050.00,
      "close": 94520.75,
      "volume": 7835.42,
      "num_trades": 167540,
      "taker_buy_ratio": 0.51,
      "funding_rate": 0.0001,
      "open_interest": 53100.20
    }
  ],
  "meta": {
    "symbol": "BTC",
    "source": "binance_futures",
    "interval": "4h",
    "returned": 6,
    "next_cursor": "eyJ0IjoiMjAyNi0wMy0wMVQyMDowMDowMFoifQ",
    "has_more": false
  }
}

Source-Specific Behavior

Polymarket — The close field represents the outcome probability (0–1) rather than a dollar price. volume is denominated in USDC. Fields like num_trades, taker_buy_ratio, funding_rate, and open_interest are always null.

Chainlink — Only 5m and 15m intervals are available. volume is always null because Chainlink is an oracle feed, not an exchange. Prices reflect the on-chain aggregated answer.

Binance (spot and futures) — num_trades is populated on every candle. taker_buy_ratio, funding_rate, and open_interest are only present on binance_futures.

Hyperliquid — Funding settles continuously (hourly), unlike Binance's 8-hour schedule. funding_rate and open_interest may be null on sub-hourly intervals.

Tier Access

Errors