analyzing-options-flow

分析期权资金流

概述

跟踪并分析中心化衍生品交易所（Deribit、OKX、Bybit）的加密货币期权资金流，以识别机构持仓、评估市场情绪，并检测 BTC 和 ETH 期权市场中的异常活动。

前提条件

• 至少一个加密货币衍生品交易所的 API 凭据（推荐使用 Deribit API 密钥；也可使用 OKX 或 Bybit）
• Python 3.8+，并已安装 requests 和 websocket-client 库
• 可选：使用 pandas 和 numpy 对资金流数据进行高级统计分析
• 了解期权术语：行权价、到期日、隐含波动率、Delta、Gamma、未平仓合约量和权利金
• 可访问交易所的 WebSocket 数据流，以实时监控资金流

说明

1. 使用 Read 工具从 ${CLAUDE_SKILL_DIR}/config/crypto-apis.env 加载交易所 API 凭据，以通过衍生品交易所端点进行身份验证。
2. 运行 Bash(crypto:options-*) 连接 Deribit 期权数据流，并获取 BTC 或 ETH 当前的期权链，包括所有有效行权价和到期日。
3. 获取所有行权价和到期日的未平仓合约量数据，生成未平仓合约量热力图，显示持仓集中区域。
4. 按成交量和未平仓合约量计算整体看跌／看涨比率，以评估总体市场情绪（比率高于 1.0 表示看跌倾向；低于 1.0 表示看涨倾向）。
5. 筛选超过可配置名义金额门槛（例如，$500K+）的大宗交易，以从散户噪声中识别机构级交易活动。
6. 分析不同到期日的隐含波动率期限结构，以检测波动率收缩（可能预示即将突破）或波动率扩张（不确定性增加）。
7. 通过计算使最多期权到期作废的行权价，跟踪即将到期合约的最大痛点，表明临近到期时价格可能被吸引至该水平。
8. 将近期资金流数据与历史基准（7 天和 30 天滚动平均值）进行比较，标记统计上异常的持仓。
9. 生成资金流摘要报告，提供可操作信号：看涨的大额大宗看涨期权、看跌的看跌期权扫单、IV 偏斜变化，以及关键行权价的 OI 增长。
10. 使用 --format json 或 --format csv 导出结果，以便集成到交易仪表板或告警系统。

完整的实现工作流请参见 ${CLAUDE_SKILL_DIR}/references/implementation.md。

输出

• 期权链表格，显示每份合约的行权价、到期日、买价／卖价、IV、Delta、Gamma、未平仓合约量和成交量
• 看跌／看涨比率摘要（按成交量和未平仓合约量统计），并附历史对比
• 大宗交易日志，列出时间戳、方向（买入／卖出）、行权价、到期日、规模、权利金和隐含波动率
• 未平仓合约量热力图数据，按到期日映射行权价及持仓集中情况
• 按到期日列出的最大痛点计算结果，包括最佳痛点行权价和面临风险的美元金额
• 展示近期和远期到期日的隐含波动率期限结构曲线
• 异常活动告警，标记偏离滚动平均值超过 2 个标准差的交易
• JSON 或 CSV 导出文件，用于后续分析和仪表板集成

错误处理

错误	原因	解决方案
API Rate Limit Exceeded	向衍生品交易所 API 发送的请求过多	限制请求频率，确保每次调用间隔至少 100ms；使用 WebSocket 数据流获取实时数据，而不是轮询 REST 端点；如有需要，升级 API 套餐
Cannot connect to blockchain node or timeout	查询链上结算数据时，RPC 端点无法访问	切换到备用 RPC 端点；检查网络连接；确认节点已完全同步
Invalid API key or signature mismatch	交易所 API 身份验证失败	在交易所重新生成 API 密钥；确认密钥权限包含衍生品数据的读取权限；检查系统时钟同步情况（HMAC 签名需要准确的时间戳）
No options data for instrument	查询的期权合约已过期或不存在	确认工具名称符合交易所的命名规范（例如 Deribit 上的 BTC-28MAR25-100000-C）；检查到期日是否已过
WebSocket connection dropped	交易所数据流因连接闲置或网络问题而断开	实现采用指数退避策略的自动重连；定期发送 ping 帧以保持连接
Insufficient historical data	用于统计比较的基准期过短	将滚动窗口从 7 天延长至 30 天；确保数据采集流程已运行足够长的时间，以积累历史数据

示例

BTC 期权情绪快照

# Pull current BTC options chain and compute put/call ratios
python options_flow.py btc --summary

返回综合看跌／看涨比率、未平仓合约量最高的 5 个行权价、最近到期日的最大痛点，以及当前平值隐含波动率。看跌／看涨比率为 0.65，且 120K 美元行权价的看涨期权未平仓合约量较大，表明机构持仓偏多。

检测机构大宗交易

# Filter for block trades above $1M notional in the last 24 hours
python options_flow.py btc --blocks --min-notional 1000000 --period 24h  # 1000000 = 1M limit

列出所有超过阈值的大宗交易，包括方向推断（主动方）、行权价、到期日、支付的权利金，以及成交时的隐含波动率。可用于在标的资产价格变动前发现大额方向性押注。

ETH 隐含波动率期限结构

# Generate IV term structure for ETH across all active expiries
python options_flow.py eth --iv-curve --format json > eth_iv_term.json

将隐含波动率期限结构导出为 JSON。平坦或倒挂的期限结构（近期隐含波动率高于远期）往往预示着剧烈的方向性行情，而陡峭上扬的曲线则表示市场预期近期行情平静。

资源

• Deribit API 文档 -- 加密货币期权数据的主要交易所，提供 WebSocket 和 REST 端点
• Laevitas Analytics -- 加密货币衍生品分析面板，提供期权交易流可视化
• Greeks.live -- 实时加密货币期权分析和大宗交易追踪
• Amberdata Derivatives -- 面向机构的加密货币衍生品数据 API
• The Block Research -- 汇总的加密货币期权市场数据和图表