GET /api/v1/derivative-ticker.csv

For each target time, this endpoint returns the latest Deribit BTC-PERPETUAL or ETH-PERPETUAL ticker row, according to asset, at or before query_time within the API lookback window.

Query parameters

NameUse
timeSingle UTC ISO timestamp.
start_time / end_timeInclusive batch target range on the selected interval grid.
interval1m, 5m, 15m, 30m, 1h, 4h or 1d.
assetAccepts BTC or ETH; defaults to BTC.

Example requests

Send Authorization: Bearer <key> with each request. The symbol in the CSV follows asset.

  • BTC: GET https://backtest.greeks.live/api/v1/derivative-ticker.csv?asset=BTC&time=2026-05-01T07:00:00Z
  • ETH: GET https://backtest.greeks.live/api/v1/derivative-ticker.csv?asset=ETH&time=2026-05-01T07:00:00Z

CSV columns

ColumnMeaning
query_time / source_timeRequested bucket and actual as-of ticker timestamp.
asset / exchange / symbolSelected BTC or ETH asset, deribit, and the matching BTC-PERPETUAL or ETH-PERPETUAL symbol.
last_priceLast traded price when available.
mark_priceDerivative mark price.
index_priceUnderlying index price.
funding_rate / funding_tsCurrent funding value and its timestamp when available.
predicted_funding_ratePredicted funding value when available.
open_interestPerpetual open interest when available.

Use the ticker correctly

  • Use source_time to measure staleness rather than assuming every row is exact at query_time.
  • Choose last, mark or index price according to the research question; they are not interchangeable.
  • The selected asset’s perpetual can be a hedge/reference input, but is not the expiry-matched option forward.
  • Use forward from sabr.csv for same-expiry option pricing.
  • Expect nullable market fields and handle them explicitly.

Safe batching pattern

  • Choose an interval appropriate for the hypothesis.
  • Partition requests into spans no longer than the account limit.
  • Keep boundary handling consistent to avoid duplicate inclusive end timestamps.
  • Validate monotonic query_time and source_time not later than query_time.
  • Persist request parameters beside the CSV.
API contractAuthentication, fixed-grid semantics, limits and errors.SABR surface endpointUse expiry-matched forwards and model parameters.