The interval parameter controls the time resolution of candle and aggregated data. Available intervals depend on your plan tier and the data source.
Interval Reference
| Interval | String | Minimum tier |
|---|---|---|
| 1 second | 1s | Business |
| 5 minutes | 5m | Pro |
| 15 minutes | 15m | Basic (Free) |
| 1 hour | 1h | Basic (Free) |
| 4 hours | 4h | Basic (Free) |
| 24 hours | 24h | Basic (Free) |
| 1 day | 1d | Pro |
Requesting an interval that requires a higher tier returns a 403 with plan_required.
Source Compatibility
Not all sources support all intervals. The table below shows which intervals are available for each source.
| Source | 1s | 5m | 15m | 1h | 4h | 24h | 1d |
|---|---|---|---|---|---|---|---|
binance | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
binance_futures | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
hyperliquid | — | Yes | Yes | Yes | Yes | Yes | Yes |
chainlink | — | — | Yes | Yes | Yes | Yes | Yes |
polymarket | — | — | Yes | Yes | Yes | Yes | Yes |
kalshi | — | — | Yes | Yes | Yes | Yes | Yes |
The 1-second interval for Binance is delivered via the Binance 1s ticker feed and requires a Pro plan or higher. At the Business tier, 1s is available as a standard candle interval.
Interval vs. History Depth
Your plan also limits how far back you can query. A wider interval does not extend your history window — a Basic plan can query 14 days of 1h candles but not 30 days, regardless of interval. See Tier Access Reference for the full history depth matrix.
Usage
Pass the interval string as the interval query parameter:
curl "https://kwery-api.com/v1/candles?api-key=YOUR_KEY&symbol=BTCUSDT&source=binance&interval=4h&limit=100"
If you omit the interval parameter, the endpoint returns an error — it is required on all endpoints that accept it.