SuperAPI AI 工具集

ib-collar

数据与分析

查看项目

更新于 10-16 01:12

技能介绍

用途:为 PMCC(Poor Man's Covered Call)持仓生成战术领口策略报告,在财报或高风险事件期间提供下行保护。运行前需在本地启动 TWS 或 IB Gateway 并启用 API:模拟盘端口 7497,实盘端口 7496。可用 IB_PORT 环境变量设置默认端口,优先级为 --port 参数 > IB_PORT > 内置默认;配置端口失败时自动重试另一端口,成功后记忆账户类型供后续调用复用;两端口均失败则提示用户确认软件运行且已启用 API。

用法:第一步采集数据,运行 uv run python scripts/collar.py SYMBOL [--port PORT] [--account ACCOUNT],脚本向 stdout 返回 JSON;第二步读取 templates/markdown-template.md 格式说明,由 JSON 生成 markdown 报告并存至 sandbox/;第三步向用户呈现关键结论,包括推荐的看跌期权保护、成本收益及报告保存路径。参数:SYMBOL 为需在持仓中的股票代码;--port 为 IB 端口(默认 7497 模拟盘);--account 为指定账户 ID(可选,默认搜索全部账户)。示例:uv run python scripts/collar.py NVDA;uv run python scripts/collar.py AMZN --account U790497。

JSON 主要字段:symbol、current_price、long_strike、long_expiry、long_qty、long_cost、short_positions、is_proper_pmcc、short_above_long、earnings_date、days_to_earnings、put_analysis、unprotected_loss_10、unprotected_loss_15、unprotected_gain_10、volatility。报告分节包括持仓摘要、PMCC 健康检查、财报风险、看跌期权久期分析、领口情景(跳空高开/持平/跳空低开)、成本收益分析、实施时间线与建议。

关键概念:正规 PMCC 为深度价内 LEAPS 多头看涨加长期权行权价之上的价外空头看涨,领口无需额外保证金;结构破损时(如崩盘后多头看涨转价外、空头看涨低于多头行权价)需保证金但领口仍适用。战术领口仅在事件前买入保护性看跌、事件后卖出。久期权衡:短期更便宜但跳空高开无残值;中期(2-4 周)成本、gamma 与残值较平衡;长期在跳空高开时保值但更贵且 gamma 较低。所有时间戳须用 America/New_York 时区,JSON 输出须含 generated_at 与 data_delay。