加密期权数据 API

#面向 AI 智能体与 LLM 的加密期权数据

“BTC 周五到期的最大痛点在哪里？”“ETH 隐含波动率在上升吗？”“看跌/看涨比说明了什么？”：AI 智能体通过 MCP 工具 get_options_data 用本数据族作答，该工具接收资产而非交易对。

{
  "name": "get_options_data",
  "arguments": {
    "asset": "BTC",
    "fields": ["options_summary", "options_put_call_ratio", "options_iv"]
  }
}

• 给 LLM 的提示：最大痛点是统计意义上的重心，而非预测；这里只有 BTC 和 ETH 有期权：BTCUSDT 会被拒绝，资产应写 BTC。
• 给开发者：/v1/options/summary 让使用 tool calling 的 AI 智能体一次请求就看到一个资产的全貌；MCP 工具还可通过 expiries 返回各到期日的数据。
• 适用环境：Claude、ChatGPT、Cursor 及任何 MCP 客户端，包括支持 MCP 的 AI 智能体框架，如 LangChain 或 n8n。

通过 MCP 服务器指南接入你的 AI 智能体，或用开源的 Agent Skills 教它使用 BytNode。

#基本原则

该市场数据族有三点不同于其他市场数据族。

• 仅两种资产：比特币和以太坊。其他资产上，这个市场缺乏深度。
• 通过 ?asset= 指定（必填），只填资产（BTC 或 ETH），而不是 ?symbol=。传入 BTCUSDT 或不传资产，都会返回 422。
• 希腊值会重新计算，采用统一约定，而不是直接取自各交易所：各交易所的符号和约定差异太大，无法直接相加。

#概览

一次调用获取全貌：持仓、成交量、看跌/看涨比、平值隐含波动率，以及最近到期日的详情。

curl -H "X-API-KEY: $BYTNODE_API_KEY" \
  "https://api.bytnode.com/v1/options/summary?asset=BTC"

#持仓量与成交量

持仓量，以资产单位和美元表示，按看涨和看跌拆分。

窗口内的变化，按需计算：最后一个值减去第一个值。每行带有 oi_change_call_usd 和 oi_change_put_usd。

持仓量按行权价和到期日的分布。它是市场真正投入资金的价位地图：标的必须穿越的行权价墙。

#看跌/看涨比与最大痛点

看跌与看涨之比，按持仓量和成交量分别计算。低于 1 时看涨占优；高于 1 时下行对冲占上风。

max pain 历史针对的是单个到期日：因此 expiry 为必填。可以按 /v1/options/max-pain 或 /v1/options/expiry 返回的形式传入（2026-10-01T08:00:00.000Z），也可以只传日期（2026-10-01）：两者指同一个到期日。缺失时，请求返回 422 missing_parameter，错误信息会列出该资产的有效到期日。

#隐含波动率

30 天恒定期限的平值隐含波动率，以百分比表示（iv_atm_30d_pct）：在 30 天前后的两个到期日之间按总方差插值，因此最近到期日到期时不会跳变。它衡量市场为对冲支付了多少，与方向无关。每个到期日的平值波动率见 /v1/options/expiry。

同一波动率，以按需生成的 OHLC K 线呈现，同样以百分比表示。每行带有 time、open、high、low、close。足以像绘制价格一样绘制波动率。与该市场数据族的所有历史接口一样，只提供已收盘的 K 线：进行中的那根从不出现。

#希腊值与到期日

按持仓量加权聚合的 Delta、Gamma、Vega 和 Theta。它们按统一约定重新计算，因此可以跨交易所相加，而各交易所自行公布的数值做不到这一点。

按到期日汇总：每个日期的持仓、看跌/看涨比、最大痛点和波动率。在大额到期之前应查看此视图，因为届时仓位了结会对标的产生影响。