GET/symbols
Discover available symbols and retained delisted contracts, listing dates, and backfill bounds.
Binance futures API
A public, read-only API for USDT crypto perpetuals. Choose a route below to try it against this server. No API key is needed.
All data comes from the collector's stored history. Backfills and missing samples can leave empty results; check /status and the response's coverage for availability.
Collection progress
Loading status…Overall historical import—
Estimated time remainingCalculating…Observing the loading rate.
Import jobs processed—Across candles and both metric streams.
Klines
— Waiting for status.Live freshness: —Historical scan: —Open interest
— Waiting for status.Live freshness: —Historical scan: —Long/short ratio
— Waiting for status.Live freshness: —Historical scan: —Refreshes automatically every 15 seconds.
Progress measures historical ranges processed. Missing samples are repaired separately. The time estimate follows recent loading speed and can change as downloads or retries slow down.
GET
GET/klines
Read closed OHLCV candles. Every minute in an aggregated bucket must be stored for that bucket to appear.
GET/open-interest
Read native five-minute open-interest totals and their value.
GET/long-short-ratio
Read native five-minute global long/short account ratios. Account shares may be null in historical archives.
GET/status
Inspect collector freshness, latest timestamps, backfill progress, and unresolved gaps for every symbol.
GET/health
Check PostgreSQL connectivity. An OK response does not imply that collection is fresh.
Parameters & response conventions
| Parameter | Applies to | Meaning |
|---|---|---|
symbol | All three data routes | Required contract symbol; Latin letters must be uppercase. Unicode symbols are supported. |
interval | /klines only | 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M. Metrics remain native five-minute samples. |
startTime | All three data routes | Nonnegative integer UTC Unix milliseconds. Start-inclusive; must be less than endTime. |
endTime | All three data routes | Nonnegative integer UTC Unix milliseconds. End-exclusive. Candle buckets must fit entirely inside the range. |
limit | All three data routes | Integer 1–1,000, default 500. This explorer starts with 10 rows for a small preview. |
summary | /status | Optional true/false, default false. Use true for overall progress without per-symbol details. |
- Results ascend by timestamp. Continue with
nextStartTimeas the next request'sstartTime; null means no further page. /klinesreturnscount, the number of candles in the current response'sdataarray.- Prices, volumes, ratios, and other decimals are JSON strings to preserve precision. Trade totals are also strings.
- Candles are closed and complete. Weeks start Monday, months follow the UTC calendar, and the three-day grid is anchored to January 2, 1970.
coverageincludes first/latest stored timestamps, progress, and unresolved gaps. Up to 1,000 gaps are shown;gapsTruncatedsignals more./status.summaryshows backfill/scan percentages and live freshness for candles and both metrics. Per-symbol progress includes percentages, UTC dates, and retry states. Percentages measure processed history; inspect gaps for missing samples. Live collection runs indefinitely and uses freshness/lag instead of completion.collectorFreshreports heartbeat freshness;/healthchecks the database connection.- HTTP 400: invalid inputs; 404: unknown symbol or route; 405: unsupported method; 503: database unavailable or query timeout.
Response
Choose a route and select Try GET.
Your response will appear here.