IBKR Trader Toolkit — IBKR 交易工具包

IBKR Trader Toolkit 实时数据、期权分析和投资组合风险管理，适用于Interactive Brokers —— 所有这些都通过JSON输出的CLI脚本实现。核心规则：脚本产生数据，您（模型）产生分析。

何时触发此技能 用户询问... 示例短语 股票/ETF价格 “SPY当前价格是多少？” “AAPL当前价格是多少？” 期权链、希腊字母、IV “显示下个月AAPL的看跌期权” “策略想法” “我应该卖出MU的看跌期权吗？” 头寸风险 “我是否过度看多？” 盈亏、胜率、历史记录 “我的轮盘交易表现如何？” 盈利风险 “ARM是否在我的看涨期权到期之前公布？” 警报/监控 “如果SPY的IV超过80%，请提醒我” 即使用户没有提到IBKR —— 如果他们询问自己的头寸或盈亏，这个技能是权威来源。 关键：对于股票价格，始终使用market_quote.py。永远不要通过网络搜索股票价格 —— 网络数据可能已经过时。

工作流程 “应该卖出$SYM的看跌期权吗？” 按照以下步骤运行，然后综合分析： 步骤 命令 为什么 1 portfolio_positions.py 了解现有的风险敞口 2 earnings_calendar.py SYM --days 60 避免在到期日前60天内的盈利报告 3 options_analyzer.py SYM --outlook bullish --risk-profile conservative --iv-context 获取IV环境和候选行权 4 options_chain.py SYM --dte-min 25 --dte-max 45 获取选定行权的实时中间价格

您的推荐必须包括： 行权价 • delta • 溢价 • 收支平衡点 • 年化收益率 • 盈利/IV警告

“我的投资组合看起来如何？” 步骤 命令 1 portfolio_positions.py → 位置 + 希腊字母 2 options_daily.py → 到期警告 + IV摘要 3 pnl_analytics.py --days 7 → 最近的实际盈亏

“我正在考虑添加交易X —— 它是否安全？” risk_simulator.py --add "SYM STRIKE EXPIRY R ACTION QTY" 标记任何以下情况： Vega幅度加倍 → 更多IV暴露 净delta符号翻转 → 方向性赌注现在相反 一个符号 > 30%的资本 → 集中风险

“我的轮盘怎么样？” wheel_tracker.py --summary 每个符号的回报：阶段（短期看跌/分配/涵盖看涨/被调用），累计溢价，周期天数，年化回报。

脚本参考 脚本 何时使用 market_quote.py SYM [SYM2 ...] 任何股票/ETF价格问题 portfolio_positions.py 我拥有什么？投资组合希腊字母 options_chain.py SYM 行权调查 + IV到期 options_analyzer.py SYM --outlook X --risk-profile Y --iv-context 策略想法，根据前景 options_daily.py 晨间/日终期权报告（从这里开始） pnl_analytics.py [--days N] 实现盈亏，胜率，最佳/最差 risk_simulator.py --add "..." 预交易希腊字母影响 earnings_calendar.py SYM ... 在N天内的盈利 technical_indicators.py SYM RSI / MA / BB / ATR wheel_tracker.py --summary 轮盘周期状态 alerts_monitor.py 阈值规则（cron友好）

所有脚本：输出JSON到标准输出（或到 --output FILE） 从环境变量（IBKR_HOST，IBKR_PORT，IBKR_CLIENT_ID_BASE，IBKR_MARKET_DATA_TYPE）读取IBKR配置 是只读的 —— 它们永远不能下单

预交易清单（每个期权推荐） 在建议任何期权交易之前，验证所有三个： IV环境 —— 来自options_analyzer.py --iv-context。不要在低IV环境下出售溢价；不要在高IV环境下购买溢价。 到期日前的盈利 —— 来自earnings_calendar.py。盈利后IV的压缩会改变数学计算。 现有头寸希腊字母 —— 来自portfolio_positions.py。如果已经有+5000的delta，添加更多是错误的方向或不正确的。 明确说明每个检查：“IV环境：低（比率0.7）；盈利：未来45天内没有；当前净delta：+1,200。”这允许用户审计推理。

操作约束 约束 什么意思 JSON输入，判断输出 脚本的推荐列表是候选数据，而不是最终答案。重新排名以适应用户的情况。 默认实时 IBKR_MARKET_DATA_TYPE=1。如果报价看起来冻结，请检查市场时间和订阅。 每个脚本一个clientId 如果您看到clientId已经在使用，请等待几秒钟或增加IBKR_CLIENT_ID_BASE。 跨调用缓存链 options_chain.py --output /tmp/chain.json，然后options_analyzer.py --chain-file /tmp/chain.json可以节省IBKR的往返时间。

更深入的参考 当用户的问题需要时按需阅读： references/strategies.md —— 完整的McMillan/Overby策略库 + 选择矩阵 references/greeks_primer.md —— 实际的Delta/Gamma/Vega/Theta解释 references/wheel_strategy.md —— 行权/DTE选择，滚动-分配决策树 references/troubleshooting.md —— 连接错误，订阅问题