Tracking Crypto Derivatives 是一个用于加密货币衍生品市场综合分析的工具技能，目标是在中心化与去中心化交易所之间聚合资金费率、未平仓合约、爆仓与期权数据，从而提供可参考的交易洞察。
一、用途 该技能面向需要跨交易所观察衍生品市场的使用者，用于追踪资金费率变化、评估市场仓位与趋势强度、观察爆仓分布与近期大额清算、研究期权流向与隐含波动率，并计算基差以寻找基差交易或套利机会。
二、支持的交易场所与市场
- 永续合约（Perpetual Swaps）：Binance、Bybit、OKX、Deribit、BitMEX。
- 期货（Futures）：季度与月度合约。
- 期权（Options）：以 Deribit 为主，同时包括 OKX、Bybit。
- DEX 永续（DEX Perpetuals）：dYdX、GMX、Drift Protocol。
三、前置条件 使用前需要确保具备：Python 3.8+；可访问交易所 API 的网络；可选提供 API key 以获得更高速率限制；以及对衍生品概念（资金费率、OI、基差）的基本理解。
四、使用方式 该技能通过命令行脚本 derivatives_tracker.py 运行，分为若干步骤。
1）检查资金费率 用于监控各交易所资金费率，识别市场情绪与套利机会。示例：
- 查询 BTC 在所有交易所的资金费率：python derivatives_tracker.py funding BTC
- 查询多资产：python derivatives_tracker.py funding BTC ETH SOL
- 显示历史均值：python derivatives_tracker.py funding BTC --history 7d 结果解读：正资金费率（>0.01%）表示多头支付空头，偏多情绪；负资金费率（<-0.01%）表示空头支付多头，偏空情绪；极端资金费率（>0.1%）可能构成反向机会。
2）分析未平仓合约（OI） 用于衡量市场仓位与趋势强度。示例：
- 获取 BTC 各交易所 OI：python derivatives_tracker.py oi BTC
- 显示 OI 随时间变化：python derivatives_tracker.py oi BTC --changes
- 对比 OI 与价格：python derivatives_tracker.py oi BTC --divergence OI 解读：OI 上升且价格上涨为强多头趋势；OI 上升且价格下跌为强空头趋势；OI 下降且价格上涨为轧空反弹；OI 下降且价格下跌为多头被清算。
3）监控爆仓（清算） 用于跟踪清算水平与近期事件。示例：
- 获取爆仓热力图：python derivatives_tracker.py liquidations BTC
- 显示近期大额清算：python derivatives_tracker.py liquidations BTC --recent
- 设置最小规模过滤：python derivatives_tracker.py liquidations BTC --min-size 100000 爆仓信号：大额清算聚集区可指示支撑/阻力；连环清算可能加速价格波动；多空清算比例可指示市场方向。
4）分析期权市场 用于研究期权流向与隐含波动率。示例：
- 获取期权概览：python derivatives_tracker.py options BTC
- 显示 put/call 比率：python derivatives_tracker.py options BTC --pcr
- 查找特定期日的最大痛点：python derivatives_tracker.py options BTC --expiry 2025-01-31
- 跟踪大额期权交易：python derivatives_tracker.py options BTC --flow 期权解读：IV rank 高（>80）表示期权昂贵，可考虑卖出；IV rank 低（<20）表示期权便宜，可考虑买入；最大痛点是多数期权到期作废的行权价。
5）计算基差 用于寻找基差交易与套利机会。示例：
- 获取现货-永续基差：python derivatives_tracker.py basis BTC
- 获取季度期货基差：python derivatives_tracker.py basis BTC --quarterly
- 显示所有基差机会：python derivatives_tracker.py basis --all 基差交易：正基差表示期货高于现货（contango，正常）；负基差表示期货低于现货（backwardation）；当基差较高时可采用现金持有策略（买入现货并卖出期货）。
6）完整仪表板 用于获取综合衍生品概览。示例：
- BTC 完整仪表板：python derivatives_tracker.py dashboard BTC
- 多资产仪表板：python derivatives_tracker.py dashboard BTC ETH SOL
- 导出 JSON：python derivatives_tracker.py dashboard BTC --output json 更多实现说明可参见 {baseDir}/references/implementation.md。
五、输出形态 该技能提供结构化报告，主要包括：
- 资金费率报告：按交易所列出当前值、24 小时均值、7 日均值与下次支付倒计时，并给出加权平均与年化、情绪判断。
- 未平仓合约报告：按交易所列出 OI（USD）、24 小时变化、7 日变化与份额，并给出总 OI 与多空比。
- 清算热力图：以当前价格为基准，分层展示下方多头清算与上方空头清算的密度与金额，并统计 24 小时多空清算额。
六、错误处理与示例 常见问题包括：ERR_RATE_LIMIT（降低请求频率或添加 API key）、ERR_EXCHANGE_DOWN（交易所 API 不可用，尝试替代方案）、ERR_SYMBOL_INVALID（检查交易对格式，如 BTC、ETH，而非 BTCUSDT）。更多错误处理见 {baseDir}/references/errors.md，示例见 {baseDir}/references/examples.md。
七、数据来源与关键概念 数据来源包括：Coinglass（聚合衍生品数据）、交易所 API（Binance、Bybit、OKX、Deribit）、The Graph（DEX 永续数据）。关键概念包括：资金费率（多空每 8 小时支付）、未平仓合约（未平仓合约总量）、基差（期货与现货价差）、最大痛点（多数期权作废的行权价）、IV Rank（当前 IV 相对历史的百分位）。
八、风险提示 衍生品为带杠杆的工具，存在较高亏损风险；资金成本会随时间累积；爆仓可能快速发生；期权可能到期作废。该工具仅提供分析，不构成财务建议。