SuperAPI AI 工具集

ib-account

通用与其它

查看项目

更新于 10-16 01:10

技能介绍

用途:从 Interactive Brokers(IB)获取账户摘要,返回现金余额、购买力、账户净值等信息,适合用户询问账户、余额或购买力时使用。

连接要求:本地必须运行 TWS 或 IB Gateway 并启用 API。模拟盘端口 7497,实盘端口 7496。可用 IB_PORT 环境变量设置默认端口(如 Gateway 容器用 IB_PORT=4001),优先级为 --port 参数 > IB_PORT > 内置默认值,可在 shell 或 .env 文件中设置。端口回退:若配置端口失败,会自动在另一端口重试;重试成功则记住可用账户类型(实盘/模拟)并在本次及后续会话的 IB 技能调用中复用,直到用户明确要求另一账户;两个端口都失败时,提示用户确认 TWS 或 IB Gateway 已运行且启用 API 访问。

用法:若未安装 uv 或找不到 pyproject.toml,将命令中的 uv run python 替换为 python。命令为 uv run python scripts/account.py [--port PORT] [--account ACCOUNT_ID] [--all-accounts]。参数:--port 指定 IB 端口(默认 7497 模拟盘);--account 指定账户 ID;--all-accounts 获取所有受管账户摘要。默认无参数时仅获取第一个受管账户,除非用户指定账户,否则建议始终使用 --all-accounts。

输出:返回 JSON,包含 connected(连接是否成功)与 accounts(账户摘要列表,每项含账户 ID、净清算值、现金、购买力等)。若未连接,需说明 TWS/Gateway 需处于运行状态。

依赖:ib-async。

时区:所有时间戳与基于时间的计算必须使用 America/New_York 时区,所有 JSON 输出必须包含 generated_at(纽约时间字符串)与 data_delay 字段。

限制:资料未提供收费、价格、平台支持范围及具体效果等信息。