API reference
Send your API key in the X-Api-Key header with every request. All timestamps are UTC.
Available streams
Symbols: btc, eth, sol, xrp · Market lengths: 5 and 15 minutes. Every symbol + timeframe pair is one stream (8 in total).
| symbol | timeframe | Stream |
|---|---|---|
btc | 5, 15 | btc-5m, btc-15m |
eth | 5, 15 | eth-5m, eth-15m |
sol | 5, 15 | sol-5m, sol-15m |
xrp | 5, 15 | xrp-5m, xrp-15m |
GET
/v1/coverageWhat your key can access.
curl -H "X-Api-Key: $KEY" https://polybk.com/v1/coverage
→ {"tier":"pro","streams":["btc-5m",…],"earliest_ts":…,"first_month":"2026-03"}GET
/v1/windowsList the markets (settlement windows) available on a date.
| Param | Default | Meaning |
|---|---|---|
symbol | btc | btc · eth · sol · xrp |
timeframe | 5 | 5 or 15 (minutes) |
date | today | YYYY-MM-DD |
→ {"stream":"btc-5m","date":"2026-10-30","windows":[…]}GET
/v1/rowsGet rows for one market window.
| Param | Default | Meaning |
|---|---|---|
symbol | btc | btc · eth · sol · xrp |
timeframe | 5 | 5 or 15 |
window_start | — | window open time (unix seconds — take it from /v1/windows) |
limit | 5000 | max rows per call (up to 50000) |
→ {"window_start":…,"count":…,"source":"parquet","rows":[…]}GET
/v1/windows.csvSame parameters as /v1/rows — downloads the whole window as a CSV file.
GET
/v1/latestThe most recent recorded row for a stream.
Errors
| Code | Meaning |
|---|---|
| 401 | missing or invalid API key |
| 402 | key works, but no active plan |
| 403 | stream or date range not in your plan |
| 404 | no such window |
| 429 | too many requests — wait a minute |
Request limits
Starter: 300 requests/minute · Pro: 600 requests/minute, per key. For large downloads use /v1/windows.csv — one request per market window.