SnapTrade 投资组合 是做什么的?
概述
通过 SnapTrade 连接券商账户并生成每日总价值报告。本技能使用官方 SnapTrade Python SDK(snaptrade_client),请求签名自动处理。
工作流程
2d) 下单买入/卖出(股票/ETF)
运行:
python3 scripts/snaptrade_order.py buy|sell TICKER UNITS --account-id <ACCOUNT_ID> [--order-type market|limit] [--limit-price <PRICE>] [--tif Day|GTC|IOC|FOK]
默认值:
- 订单类型:market
- 有效期:Day
- 限价:仅限价单需要
可选监控(轮询近期订单):
python3 scripts/snaptrade_order.py buy|sell TICKER UNITS --account-id <ACCOUNT_ID> --watch
- 默认每 10s 轮询一次,最长 120s
- 可通过
--watch-interval和--watch-seconds调整
按 ID 监控已有订单:
python3 scripts/snaptrade_watch_order.py --account-id <ACCOUNT_ID> --order-id <BROKERAGE_ORDER_ID>
- 同样默认 10s/120s,可通过
--watch-interval和--watch-seconds调整
当用户询问时,使用账户订单端点确认成交并报告未结订单。
0) 创建 SnapTrade 账户 + 获取 API 密钥
您需要一个 SnapTrade 账户来连接券商。在 https://snaptrade.com 免费创建账户,生成您的 Client ID 和 Consumer Key,然后将其添加到技能配置中。
1) 安装依赖
pip3 install -r requirements.txt
2) 配置凭据(一次性)
将凭据存储在本地配置文件中(不要提交)。user_id 在首次运行时自动生成:
/home/openclaw/.openclaw/workspace/secrets/snaptrade.json
示例:
{
"client_id": "YOUR_CLIENT_ID",
"consumer_key": "YOUR_CONSUMER_KEY",
"user_id": "<auto-generated-uuid>"
}
2) 注册用户 + 生成连接门户链接
运行:
python3 scripts/snaptrade_portal.py
这将:
- 如果缺少
user_secret,则注册用户 - 将
user_secret存储回配置文件 - 打印用户必须打开的连接门户 URL 以关联账户
2b) 重新启用已禁用的连接
运行:
python3 scripts/snaptrade_reconnect.py [brokerage-name]
这将:
- 列出已禁用的连接
- 生成重新启用链接(可选按券商名称匹配)
- 打印重新启用 URL,供用户重新启用连接
2c) 列出可用券商(允许的连接)
运行:
python3 scripts/snaptrade_brokers.py
这会调用 /snaptrade/partners 并返回 allowed_brokerages 列表(显示名称)。
3) 拉取总投资组合价值
运行:
python3 scripts/snaptrade_total.py
输出为 JSON,例如:
{"total_value": 123456.78, "currency": "CAD"}
3b) 按券商汇总(货币转换)
运行:
python3 scripts/snaptrade_broker_totals.py --currency CAD
输出 JSON 包含按券商汇总的选定货币总价值以及使用的汇率。
实现说明: 尽量避免使用 get_user_holdings。持仓/头寸数据优先使用 get_user_account_positions(头寸端点)。仅当用户明确要求时,才使用持仓中的余额/现金;否则不要调用持仓。
4) 安排每日报告
使用 cron 调用 snaptrade_total.py,格式化简洁的 WhatsApp 消息,然后发送给用户。仅需总价值。
脚本
scripts/snaptrade_common.py— 配置加载/保存 + 客户端创建scripts/snaptrade_portal.py— 注册用户 + 生成连接门户链接scripts/snaptrade_reconnect.py— 为禁用的连接生成重新启用链接scripts/snaptrade_brokers.py— 列出该客户允许的券商scripts/snaptrade_order.py— 下单买入/卖出(市价/限价),可选监控scripts/snaptrade_watch_order.py— 按 ID 监控已有订单以确认成交scripts/snaptrade_total.py— 计算所有账户的总价值scripts/snaptrade_broker_totals.py— 按券商汇总,支持汇率转换
备注
- 请求签名由 SDK 通过
request_after_hook使用consumer_key处理。 - 总价值通过将每个账户的
account.balance.total相加得出;这避免了添加或删除账户时出错。 - 如果存在多种货币,脚本使用遇到的第一个货币。
- 将密钥保存在本地配置文件中,并设置
chmod 600权限。