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
| Name | Use |
|---|---|
| time | Single UTC ISO timestamp. |
| start_time / end_time | Inclusive batch target range on the selected interval grid. |
| interval | 1m, 5m, 15m, 30m, 1h, 4h or 1d. |
| asset | Accepts 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
| Column | Meaning |
|---|---|
| query_time / source_time | Requested bucket and actual as-of ticker timestamp. |
| asset / exchange / symbol | Selected BTC or ETH asset, deribit, and the matching BTC-PERPETUAL or ETH-PERPETUAL symbol. |
| last_price | Last traded price when available. |
| mark_price | Derivative mark price. |
| index_price | Underlying index price. |
| funding_rate / funding_ts | Current funding value and its timestamp when available. |
| predicted_funding_rate | Predicted funding value when available. |
| open_interest | Perpetual 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.