（7161期）SnapTrade – 一键聚合多券商，自动追踪总资产

一键聚合多券商，自动追踪总资产 通过 SnapTrade SDK 安全连接主流券商（Webull、E*TRADE 等），自动化生成投资组合日报，支持下单交易与实时监控 使用说明 核心用法 SnapTrade Portfolio 是一款面向个人投资者的投资账户聚合与自动化报告工具，基于 SnapTrade 官方 Python SDK 构建，支持与北美主流券商（如 Webull、E*TRADE、Alpaca 等）的安全连接。 主要功能流程 1. 账户初始化与配置 在 snaptrade.com 注册免费账户，获取 Client ID 与 Consumer Key 本地配置存储于 ~/.openclaw/workspace/secrets/snaptrade.json，权限设置为 600 首次运行自动生成 UUID 作为 user_id 2. 券商账户连接 snaptrade_portal.py：生成专属连接门户链接，用户授权后自动完成 OAuth 绑定 snaptrade_reconnect.py：处理失效连接的重连 snaptrade_brokers.py：查询当前支持的券商列表 3. 投资组合监控 snaptrade_total.py：聚合所有授权账户持仓，计算总资产（处理多币种时以首个币种为准） 智能检测连接状态：对失效连接保留最后已知余额并标记，避免同步阻塞 支持 cron 定时任务生成日报，格式化后推送至 WhatsApp 4. 交易执行（进阶） snaptrade_order.py：支持市价/限价单，可设 Day/GTC/IOC/FOK 时效，附带 10 秒轮询的订单状态监控（默认 120 秒） snaptradewatchorder.py：按订单 ID 追踪成交状态 --- 显著优点 | 维度 | 优势 ||------|------| 覆盖广度 | 单一 SDK 对接 20+ 北美主流券商，避免各平台独立开发 | 安全机制 | 请求签名由 SDK 自动处理（requestafterhook + consumer_key），密钥本地加密存储 | 容错设计 | 失效连接不阻断整体流程，保留历史数据并显式报告 | 自动化友好 | 纯 CLI 工具链，天然适配 cron/systemd 定时任务 | 合规基础 | 基于 SnapTrade 官方 SDK，非爬虫方案，降低账户风控风险 | --- 潜在缺点与局限性 地域限制：SnapTrade 主要覆盖北美券商，对 A 股、港股、欧洲券商支持有限 货币处理简化：多币种场景下仅以首个币种输出，未做实时汇率换算 时效性依赖：持仓同步需等待券商端数据刷新，极端行情下可能存在分钟级延迟 权限粒度：需一次性授权较大范围的数据读取权限，无法细分子账户隔离 API 稳定性：依赖 SnapTrade 第三方服务，存在上游服务变更或 rate limit 风险 --- 适合人群 多账户投资者：在 2 家以上券商分散持仓，需统一视图的用户 量化爱好者：希望用 Python 脚本自动化生成净值报告、定时推送 北美市场专注者：主要交易美股、ETF 的长期投资者 隐私敏感用户：偏好本地密钥存储，不接受纯云端资管工具 --- 常规风险 | 风险类型 | 说明 | 缓释建议 ||----------|------|----------| 密钥泄露 | Client ID / Consumer Key 本地存储，若设备失陷可能被滥用 | 配置文件权限 600，考虑使用系统密钥环（keyring）替代 JSON | 连接失效 | 券商 OAuth token 过期或用户改密导致同步中断 | 配置监控告警，结合 snaptrade_reconnect.py 主动修复 | 误操作交易 | CLI 参数错误导致非预期下单 | 生产环境添加 --dry-run 模式，或设置交易密码二次确认 | 数据延迟 | 极端行情下净值计算滞后于实际市值 | 日报场景可接受；实时交易需结合券商原生 App 复核 | 第三方依赖 | SnapTrade 服务终止或涨价导致功能中断 | 定期评估替代方案（Plaid、Yodlee 等），保持持仓数据本地备份 | 原始说明 Connect to a user's investment accounts via SnapTrade SDK and generate portfolio reports (e.g., daily total value). Use when the user wants SnapTrade-based brokerage connectivity (Webull, E*TRADE, etc.), connection portal links, account registration, or automated portfolio summaries.