使用规范基础地址 https://backtest.greeks.live。成功响应为原始 CSV 下载;错误响应为带标准 HTTP 状态码的 JSON。

专业数据 API 页面,显示 BTC 和 ETH 数据覆盖范围、支持的时间间隔及 CSV 端点。

认证与 Key 安全

  • 打开 SABR Backtest 的 Account(账户)页面,然后选择 Create API Key(创建 API 密钥)。
  • 将密钥保存在 Secret Manager 或本地环境变量中。
  • 使用 Authorization: Bearer <key> 请求头;可下载的 API / Skill.md 还记录了 X-API-Key: <key>。
  • 不要把密钥放在 URL、浏览器 Bundle、Notebook 输出、代码库、文章或支持截图中。
  • 密钥一旦暴露,应先撤销,再继续工作。
账户设置页面,显示数据 API 额度、行情最大查询跨度和创建 API 密钥按钮。

请求形态

形态参数
单点time=<UTC ISO timestamp>
批量start_time、end_time、interval
可选 assetasset 支持 BTC 或 ETH,默认为 BTC。

单点和批量参数互斥。若 end_time 位于生成的 Interval 网格上,批量范围包含 end_time。

固定网格与 As-of 查询

  • API 从 start_time 到 end_time 按 interval 生成目标时间戳。
  • 对每个 query_time,选择 source_time 不晚于它的最新源数据。
  • source_time 必须位于 query_time 之前 7 天的回看窗口内。
  • 若回看窗口内没有符合条件的源数据,则省略该目标时间桶。

端点

端点用途
/api/v1/sabr.csv为每个选中曲面时间返回所有有效 SABR/WV4 到期日行。
/api/v1/derivative-ticker.csv根据 asset 返回 Deribit BTC-PERPETUAL 或 ETH-PERPETUAL 行情。

间隔与账户限制

  • Intervals:1m、5m、15m、30m、1h、4h、1d。
  • 每次请求最多包含 10,000 个目标时间桶。
  • Ticker 批量查询默认最多跨越 90 天。
  • 当前 API 参考文档规定:每个有效 API 密钥每个 UTC 小时最多请求 60 次;账户页面显示该密钥适用的额度与已用量。
  • 429 可能表示额度已用尽,也可能表示服务暂时繁忙。请避免密集重试,并在响应提供 Retry-After 或其他指引时遵循。

错误

状态码含义
400时间参数、interval 或范围无效;目标时间桶过多;Ticker 跨度过大。
401API 密钥缺失或无效。
403密钥所有者被禁用,或密钥已被撤销。
404请求的时间网格内没有符合条件的 SABR 曲面或 Ticker 数据。
429API 额度已用尽,或 Data API 暂时繁忙。
503后端查询或运行时失败。
SABR/WV4 端点参数、列和期权 IV 使用方式。Derivative Ticker 端点BTC-PERPETUAL 价格、资金费率和 OI。打开 API Docs 和 Account检查当前覆盖、配额和 API Key 控件。