GETAvailable
Daily BTC price spread between Coinbase and Kraken
Daily BTC price spread between Coinbase and Kraken
GET
/api/p3/cb-kr-spreadRequest
Query parameters
| Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| days | integer | Optional | 365 | ≤ 4200 | Look-back window in days. Example: 365 |
Example request
curl -s "https://www.coinboss.com/api/p3/cb-kr-spread?days=365"Response fields
The field table is generated from real responses, so it lists exactly what the endpoint returns. Paths use a[] for array items and {*} for objects keyed by a dynamic name such as a coin or an exchange.
| Field | Type | Unit | Description |
|---|---|---|---|
| success | boolean | — | true when the request succeeded. On failure the body is `{ success: false, code, error, request_id }`. |
| kraken_since | string | — | Date of the earliest Kraken BTC/USD daily candle held (ISO timestamp of midnight UTC+8, so the UTC date shown is one day early). |
| kraken_until | string | — | Date of the latest Kraken BTC/USD daily candle held (ISO timestamp of midnight UTC+8, so the UTC date shown is one day early). |
| latest | object | — | Most recent record. |
| latest.ts | number | ms | Timestamp. |
| latest.cb | number | USD | Coinbase BTC-USD daily close of the most recent day in `series`. |
| latest.kr | number | USD | Kraken BTC/USD daily close of the most recent day in `series`. |
| latest.gap | number | — | Price gap. |
| latest.gap_pct | number | % | Price gap. |
| series | array | — | Time series. |
| series[] | object | — | Time series. |
| series[].ts | number | ms | Timestamp. |
| series[].cb | number | USD | Coinbase BTC-USD daily close for that day. |
| series[].kr | number | USD | Kraken BTC/USD daily close for that day. |
| series[].gap | number | — | Price gap. |
| series[].gap_pct | number | % | Price gap. |
Generated 2026-11-11 23:00 UTC from 1 real responses.
Example response
/api/p3/cb-kr-spread?days=365 · Real response captured 2026-11-13 03:58:09 UTC. Long arrays and maps are shortened for display: series had 364 items.
- "success"true
- "kraken_since""2013-10-05T16:00:00.000Z"
- "kraken_until""2026-11-11T16:00:00.000Z"
- "latest"
- "ts"1794412800000
- "cb"71370.57
- "kr"71356
- "gap"14.57
- "gap_pct"0.0204
- "series"
Details
- Authentication
- None. Public endpoint.
- Rate limit
- 1200 requests per minute per IP
- Server cache
- 10m
- Edge micro-cache
- 10s
- Update frequency
- every 6 hours (daily bars)
- Window
- last 365 days by default (`days` max 4200)
- Data sources
- Coinbase vs Kraken BTC/USD daily close spread computed in-house from the two exchanges' public candles.
- Exchange coverage
- BTC/USD only; kraken_since / kraken_until report the covered date range.
- Sorting
- date ascending
- Units
- USD (gap) and percent (gap_pct)
- Method
- gap = Coinbase close - Kraken close; gap_pct = gap / Kraken close x 100.
- Timestamps
- Unix epoch milliseconds (UTC) unless the field description says otherwise
- Response format
- json
- Stability
- Stable
Live status
AvailableChecked 2026-11-13 03:58:09 UTCHTTP 2001 msSchema matchesNewest data point 36h old
Availability, last 30 days
100% of 410 checks passed
Errors
Failed calls share one shape on every endpoint. The full list is on the errors page. Errors and rate limits →
| Code | HTTP | Meaning | What to do |
|---|---|---|---|
| INVALID_PARAM | 400 | A required parameter is missing or a value is not accepted. `param` names the parameter when it is known. | Do not retry unchanged; fix the request. |
| UNAUTHORIZED | 401 | The `CB-API-KEY` header was sent but the key is unknown or revoked. Public data needs no key — drop the header or use a valid key. | Do not retry unchanged. |
| FORBIDDEN | 403 | The route is not part of the public API (internal or account-only). | Do not retry. |
| NOT_FOUND | 404 | Unknown route, or the requested coin / exchange / fund does not exist. | Do not retry; check the path and identifiers against the catalog. |
| RATE_LIMITED | 429 | More requests than the per-minute limit. `Retry-After` gives the seconds to wait. | Wait for `Retry-After`, then retry with backoff. |
| INTERNAL | 500 | Unexpected server error. The message is generic by design; quote `request_id` when reporting it. | Retry once after a few seconds; report it with the request id if it persists. |
| UPSTREAM_FAILED | 503 | The data source behind this endpoint did not answer in time. No stale or substitute numbers are returned in its place. | Retry with backoff; check the status page. |
| UNAVAILABLE | 501 / 503 | The dataset is temporarily not ready (cache warming) or the endpoint has no lawful public source yet. | Retry later; the catalog marks endpoints that are unavailable by design. |
| REQUEST_FAILED | 200 | Some older endpoints answer HTTP 200 with `success: false`. Always check `success`, not only the HTTP status. | Depends on the message; treat as a failed request. |
Try it
GET
/api/p3/cb-kr-spreadAvailableParameters
integer · default 365 · max 4200 — Look-back window in days.
Request URL
https://www.coinboss.com/api/p3/cb-kr-spread?days=365Choose an endpoint and press “Send request”. The response, headers and timing will appear here.
More in this category
- Futures basis (all venues) /api/sd/basis
- Basis history (hourly) /api/sd/basis/history
- Coins ranked by basis /api/sd/basis/rank
- Futures-spot basis list /api/derivatives/basis
- Daily BTC price spread between Coinbase and Kraken /api/p3/cb-kr-spread
- Coinbase Bitcoin premium index /api/p3/coinbase-premium
- Perp premium index list /api/p3/premium-index
- Premium-index history for one coin /api/p3/premium-index/history
- Premium-index candles /api/p3/premium-index/klines
- USDT OTC premium against fiat FX rates /api/usdt-premium
- Full futures-spot basis list /api/basis/list