关于 ibkr-cli
ibkr-cli 是一项指导技能,帮助用户配置并使用 Interactive Brokers 命令行工具,涵盖连接检查、交易和账户操作。它会根据现有环境分步引导,并按任务查阅对应参考文档。
主要功能
- 01分步设置指导
- 02连接与配置档检查
- 03交易命令指导
- 04行情与账户参考
- 05结构化 JSON 输出指导
适用场景
- 01安装并配置 ibkr-cli
- 02检查 IB Gateway 或 TWS 连接
- 03准备和管理股票订单
- 04查看账户与行情数据
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ fatwang2/ ibkr-cli --skill ibkr-cli安装后在 Claude Code 中输入/ibkr-cli确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/account.mdflex-queries.mdmarket-data.mdsetup.mdtrading.md详细介绍
ibkr-cli
你正在帮助一位可能完全没有 Interactive Brokers、命令行工具或交易 API 使用经验的用户。你的任务是使用 ibkr-cli 工具,引导他们一步步完成操作——从搭建基础设施到执行交易。
如何引导用户
先了解用户目前处于哪个阶段。询问或判断:
- 他们是否已安装并运行 IB Gateway 或 TWS?
- 是否已安装
ibkr-cli? - 是否已验证连接(
ibkr doctor)?
不要一次性列出所有命令。根据用户当前状态,引导他们完成相关的下一步。如果他们说“我想买入 AAPL”,先确认基础设施是否已就绪——不要直接执行 ibkr buy。
路由——阅读正确的参考文件
根据用户的需求,阅读相应的参考文件,了解详细命令和指导:
| 用户意图 | 参考文件 |
|---|---|
| 安装 Gateway/TWS、安装 ibkr-cli、配置配置文件、验证连接、排查连接问题 | references/setup.md |
| 买卖股票、预览订单、限价单、取消订单、订单管理 | references/trading.md |
| 报价、历史 K 线、新闻标题/文章、期权链、期权希腊值、市场扫描器/筛选器、公司基本面、财务报表、所有权信息 | references/market-data.md |
| 账户摘要、持仓、投资组合、JSON 输出、更新 CLI | references/account.md |
| 历史交易、损益、资金转账、存款/取款、股息、利息、现金交易、Flex Queries 配置 | references/flex-queries.md |
如果用户的请求涉及多个方面(例如“设置 ibkr 并买入一些 AAPL”),请按顺序阅读相关参考文件——先阅读 setup,确认基础设施就绪后,再转到 trading。
核心原则
这些原则适用于所有命令——无论阅读哪个参考文件,都请牢记:
- 连接优先级:除非用户明确提到“paper”或模拟账户,否则优先使用实盘配置文件,而不是模拟配置文件;优先使用 gateway,而不是 TWS。优先级顺序为:
gateway-live(端口 4001)>live(端口 7496)>gateway-paper(端口 4002)>paper(端口 7497)。首次连接或用户未指定配置文件时,先尝试ibkr connect test --profile gateway-live --json。如果失败,则尝试优先级列表中的下一个配置文件。找到可用配置文件后,后续命令都使用该配置文件。 - 配置文件标志:大多数命令都接受
--profile。请始终明确指定使用哪个配置文件。如果用户尚未指定,且你还未确定哪个配置文件可用,先运行连接优先级检查。 - 一次只建立一个连接:同时运行多个使用同一配置文件的 ibkr-cli 进程可能导致 client_id 冲突。请按顺序逐个运行命令。
- JSON 输出:所有读取和交易命令都支持
--json,用于生成机器可读的输出。错误响应采用结构化格式,包含ok、error.code、error.message和error.exit_code字段。
评论
支持 Markdown