REST API

期权

比特币和以太坊的期权市场，在多个交易所间聚合，统一换算为美元，并按同一约定重新计算。十七个接口回答同一个问题：市场把风险放在哪里，价格几何。

#基本原则

该数据族有三点不同于 API 的其他部分。

  • 仅两种资产：比特币和以太坊。期权市场在其他资产上缺乏深度。
  • 通过 ?asset= 指定，只填资产（BTC 或 ETH），而不是 ?symbol=。传入 BTCUSDT 会被拒绝。
  • 希腊值会重新计算，采用统一约定，而不是直接取自各交易所：各交易所的符号和约定差异太大，无法直接相加。
参数类型默认值说明
assetstringBTCBTC 或 ETH。
timeframestring1h用于 /history 接口：1m、5m、15m、30m、1h、4h、1d。
limitinteger100用于 /history 接口。
since_ms / until_msinteger—带日期的窗口，该数据族的历史接口均支持。

#概览

GET/v1/options/summarydata_type · options_summary

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

curl -H "X-API-KEY: $BYTNODE_KEY" \
  "https://api.bytnode.com/v1/options/summary?asset=BTC"
字段类型说明
assetstringBTC 或 ETH。
underlying_pricefloat计算时标的资产的价格。
open_interestobject以美元计的持仓：总计、看涨、看跌。
volumeobject以美元计的成交额，分项相同。
pc_ratiofloat看跌与看涨之比。
pc_signalstring对该比率的定性解读。
iv_atmfloat平值隐含波动率，以小数表示：0.48 即 48%。
nearest_expiryobject最近的到期日：日期、剩余天数、最大痛点，以及其自身的看跌/看涨比和波动率。
coverageobjectsources_active 为参与的交易所数量，oi_coverage 取值 0 到 1。

#持仓量与成交量

GET/v1/options/oidata_type · options_oi
GET/v1/options/oi/historydata_type · options_oi_history

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

GET/v1/options/oi/deltadata_type · options_oi_delta
GET/v1/options/oi/delta/historydata_type · options_oi_delta_history

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

GET/v1/options/oi/distributiondata_type · options_oi_distribution

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

GET/v1/options/volumedata_type · options_volume
GET/v1/options/volume/historydata_type · options_volume_history

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

GET/v1/options/pc-ratiodata_type · options_pc_ratio
GET/v1/options/pc-ratio/historydata_type · options_pc_ratio_history

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

GET/v1/options/max-paindata_type · options_max_pain
GET/v1/options/max-pain/historydata_type · options_max_pain_history

什么是最大痛点

使到期期权总价值最低的行权价，也就是期权买方亏损最多的价位。它是统计上的重心，而不是预测：其价值在于说明现有仓位在哪个价位形成张力。

#隐含波动率

GET/v1/options/ivdata_type · options_iv
GET/v1/options/iv/historydata_type · options_iv_history

按持仓量加权的隐含波动率，以小数表示。它衡量市场为对冲支付了多少，与方向无关。

GET/v1/options/iv/klinesdata_type · options_iv_klines

同一波动率，以按需生成的 OHLC K 线呈现。每行带有 bucket、open、high、low、close。足以像绘制价格一样绘制波动率。

#希腊值与到期日

GET/v1/options/greeksdata_type · options_greeks

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

GET/v1/options/expirydata_type · options_expiry

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