GET /api/v1/derivative-ticker.csv
对于每个目标时间点,该端点按 asset 返回 API 回看窗口内时间不晚于 query_time 的最新 Deribit BTC-PERPETUAL 或 ETH-PERPETUAL 行情记录。
查询参数
| 名称 | 用途 |
|---|---|
| time | 单个 UTC ISO 时间戳。 |
| start_time / end_time | 在所选 Interval 网格上的包含式批量目标范围。 |
| interval | 1m、5m、15m、30m、1h、4h 或 1d。 |
| asset | 支持 BTC 或 ETH;默认为 BTC。 |
请求示例
每次请求都应携带 Authorization: Bearer <key> 请求头;CSV 中的 symbol 随 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 列
| 列 | 含义 |
|---|---|
| query_time / source_time | 目标查询时间和实际行情快照时间。 |
| asset / exchange / symbol | 所选 BTC 或 ETH 资产、deribit,以及对应的 BTC-PERPETUAL 或 ETH-PERPETUAL 合约代码。 |
| last_price | 可用时的最新成交价。 |
| mark_price | 衍生品标记价格。 |
| index_price | 标的指数价格。 |
| funding_rate / funding_ts | 可用时的当前资金费率和时间戳。 |
| predicted_funding_rate | 可用时的预测资金费率。 |
| open_interest | 可用时的永续未平仓量。 |
正确使用行情数据
- 使用 source_time 衡量数据滞后程度,不要假定每行数据恰好产生于 query_time。
- 按研究目的选择 last_price、mark_price 或 index_price;三者含义不同,不可互换。
- 所选资产的永续合约可作为对冲或参考输入,但不是与期权到期日匹配的远期价格。
- 对相同到期日的期权定价,应使用 sabr.csv 中的 forward。
- 行情字段可能为空值,必须显式处理。
安全批量模式
- 选择适合研究假设的时间间隔(Interval)。
- 将请求拆分为不超过 API 限制的时间段。
- 统一处理时间边界,避免重复包含 end_time。
- 验证 query_time 单调,并且 source_time 不晚于 query_time。
- 把请求参数和 CSV 一起保存。