Use the canonical base URL https://backtest.greeks.live. Successful endpoint responses are raw CSV downloads; errors are JSON with standard HTTP status codes.

Professional Data API page showing BTC and ETH coverage, supported intervals and CSV endpoints.

Authentication and key safety

  • Open Account in SABR Backtest and select Create API Key.
  • Store the key in a secret manager or local environment variable.
  • Send it as Authorization: Bearer <key>. The downloadable API / Skill.md also documents X-API-Key: <key>.
  • Never place a key in a URL, browser bundle, notebook output, repository, article or support screenshot.
  • Revoke an exposed key before continuing work.
Account settings showing Data API allowance, ticker span and the Create API Key control.

Request shapes

ShapeParameters
Single pointtime=<UTC ISO timestamp>
Batchstart_time, end_time and interval
Optional assetasset accepts BTC or ETH and defaults to BTC.

Single-point and batch parameters are mutually exclusive. Batch end_time is inclusive when it falls on the generated interval grid.

Fixed grid and as-of lookup

  • The API creates target timestamps from start_time through end_time at the requested interval.
  • For each query_time, it selects the latest source row whose source_time is not later than query_time.
  • The source row must be within a seven-day lookback.
  • If no eligible source row exists, that target bucket is omitted.

Endpoints

EndpointPurpose
/api/v1/sabr.csvAll valid SABR/WV4 expiry rows for each selected surface timestamp.
/api/v1/derivative-ticker.csvDeribit BTC-PERPETUAL or ETH-PERPETUAL ticker data, according to asset.

Current default limits

  • Intervals: 1m, 5m, 15m, 30m, 1h, 4h and 1d.
  • At most 10,000 target buckets per request.
  • Ticker batch span: at most 90 days by default.
  • The current API reference specifies 60 requests per active API key per UTC hour; Account shows the applicable allowance and usage for your key.
  • 429 can mean quota exhaustion or temporary service load. Avoid aggressive retries and follow Retry-After or other server guidance when present.

Errors

StatusMeaning
400Invalid time shape, interval or range; too many buckets; ticker span too large.
401Missing or invalid API key.
403Disabled key owner or revoked key.
404No eligible surface or ticker data for the requested grid.
429Quota exceeded or service busy.
503Backend query or runtime failure.
SABR/WV4 endpointParameters, columns and option-IV usage.Derivative ticker endpointBTC-PERPETUAL prices, funding and open interest.Open API Docs and AccountCheck current coverage, quotas and API-key controls.