（2914期）IBKR CLI – 盈透证券 API 一站式 CLI 工具箱

盈透证券 API 一站式 CLI 工具箱 通过 ib_insync 连接 IB TWS/Gateway，提供账户查询、行情、历史数据、合约搜索、扫描器及完整订单生命周期的 Python/Bash 双端 CLI 工具。 使用说明 核心功能 IBKR Skill 是一套面向 Interactive Brokers (盈透证券) 的完整 API 操作工具集，基于 ibinsync 异步框架封装，提供 Python 原生 CLI (ibkrcli.py) 与 Bash 封装脚本 (ibkr.sh/openclaw.sh) 双端入口，覆盖量化交易日常所需的全部运维场景。 核心能力矩阵 | 模块 | 功能详情 ||------|---------|| 账户服务 | 账户总览、持仓明细、投资组合、实时盈亏查询，支持多账户指定 (--account) || 行情数据 | 实时报价订阅 (quote)、历史 K 线拉取（支持 IB 原生时间格式如 "30 D"、"1 hour"）、市场数据类型切换 (1-4 类数据) || 合约发现 | 通过 symbol + secType + expiry 等参数查询合约详情，自动处理合约资格验证 || 交易执行 | 支持 MKT/LMT/STP/STP LMT 四类订单，提供订单下达、状态跟踪、撤单、成交回报全生命周期管理 || 扫描器 | 接入 IB Scanner API，支持 TOPPERCGAIN 等预设扫描码，可指定市场范围与返回条数 | 显著优点 双端兼容：Python 原生脚本适合程序化调用，Bash 封装便于终端快速操作与管道集成 配置灵活：支持环境变量 (IBKRHOST/PORT/CLIENTID) 与命令行参数双重覆盖，易于多实例/多账户切换 错误透明：连接失败、合约无效、API 异常均返回非零退出码，便于 CI/CD 或自动化流程捕获 向后兼容：保留 getaccountinfo.py 等旧脚本入口，无缝迁移存量工作流 潜在局限与风险 运行依赖：必须预先启动 TWS 或 IB Gateway 并开启 API 端口， Skill 本身不包含券商软件 实盘风险：place-order 直接对接真实账户，误操作或参数错误将导致真实资金成交；建议先用模拟账户 (paper trading) 验证 并发限制：ib_insync 单客户端连接受 IB API 速率限制，高频场景需自行管理 client ID 分配 网络时延：本地 127.0.0.1 以外部署时需确保低延迟链路，否则行情与成交状态推送可能滞后 适合人群 需要脚本化管理 IB 账户的量化交易者与个人投资者 构建自动化交易系统（如定时获取持仓、条件触发下单）的开发者 希望通过 CLI 快速调试合约规格、扫描市场机会的技术用户 安全建议 生产环境务必使用 paper trading 账户验证逻辑后再切换实盘 建议通过防火墙限制 API 端口访问范围，避免暴露于公网 敏感配置（账户 ID、client ID）建议通过环境变量注入，避免硬编码 原始说明 Comprehensive Interactive Brokers (IBKR) TWS/Gateway skill using ib_insync. Includes Python and bash CLIs for account, market data, historical data, contract...