核心用法
ClawBack 是一个自动化跟单交易系统，核心功能是监控美国国会众议员和参议员的财务披露文件，当检测到股票交易申报后，在设定的延迟期（默认3天）后自动在用户的E*TRADE账户中执行按比例缩小的跟单交易。
执行流程：
1. 从 House Clerk（众议院书记官办公室）和 Senate eFD（参议院电子申报系统）抓取PDF披露文件
2. 解析交易明细（股票代码、买卖方向、金额区间、申报日期）
3. 按预设参数（交易规模百分比、最大持仓限制）计算实际下单量
4. 通过E*TRADE API执行市价或限价单
5. 启动追踪止损和组合回撤监控
CLI 命令集：
clawback setup：交互式配置向导（环境选择、API密钥、OAuth认证、账户绑定）clawback status：检查虚拟环境、凭证有效性、API连接状态clawback run：前台交互模式运行clawback daemon：后台服务化运行（定时轮询披露、自动执行、Token刷新）clawback test：测试Telegram通知链路
关键配置项：
tradeScalePercentage（默认1%）：跟单比例，即议员交易金额的复制比例maxPositionPercentage（默认5%）：单票最大仓位上限dailyLossLimit（默认2%）：日度止损线pollIntervalHours（默认24）：披露文件轮询间隔
显著优点
1. 信息套利逻辑清晰：基于NBER研究结论——国会议员年均跑赢标普500达47%，利用公开披露的时间差（法定45天内申报）捕捉滞后信息价值
2. 自动化程度高：从PDF解析、数据清洗、信号生成到订单执行全链路无人值守，支持daemon模式7×24运行
3. 风险控制完善：内置多层防护——8%个股止损、15%组合回撤停机、3%日度亏损限制、PDT规则保守限制（2单/日）
4. 目标政客优先级：默认追踪Nancy Pelosi等高频交易且历史业绩突出的议员，可按 chamber/individual 灵活扩展
5. 沙盒验证机制：强制区分sandbox（模拟交易）与production（实盘），支持回测引擎验证策略有效性
潜在缺点与局限性
1. 券商单一性：仅支持ETRADE，无Alpaca、IBKR等替代选项，且ETRADE API以稳定性差、文档混乱著称
2. 披露时滞风险：议员有45天法定申报期，实际平均延迟约30天，等信号到达时信息价值可能已衰减（尤其在快变市场）
3. 交易规模盲区：披露仅显示金额区间（如$15,001-$50,000），无法获知其精确仓位占比，导致tradeScalePercentage设定缺乏基准
4. 合规灰色地带：虽基于公开数据，但批量自动化跟单可能触发"跟随交易"监管关注，且未声明是否处理延迟申报的修正文件
5. 技术债务：依赖PDF解析（House Clerk）和网页抓取（Senate eFD），源站格式变更即导致数据中断；无备用数据源
6. 回测样本偏差：公开回测数据Win Rate仅42.9%-57.1%，Sharpe比率<0.4，统计显著性存疑
适合人群
- 有Python环境运维能力的个人投资者
- 已持有E*TRADE账户且通过开发者认证（获取Consumer Key/Secret需审核）
- 可接受高波动、理解"议员光环≠必然盈利"的投机型用户
- 具备$50,000+初始资金（默认配置）以支持分散持仓和止损空间
常规风险
| 风险类型 | 具体表现 | 缓解措施 |
|---------|---------|---------|
| 市场风险 | 议员交易时点未必最优，可能接飞刀 | 强制3日延迟、30日持有期 |
| 执行风险 | E*TRADE API超时、滑点、部分成交 | 限价单备选、订单状态轮询 |
| 合规风险 | SEC对"模仿交易"的潜在界定 | 仅限个人账户、不做资金归集 |
| 数据风险 | 披露文件解析错误、时间戳混乱 | 人工抽检、交叉验证源文件 |
| 安全风险 | OAuth Token 30天过期需手动刷新 | 自动90分钟刷新机制 |
特别警示：tradeScalePercentage=0.01看似保守，但若议员单笔申报$500,000，系统即触发$5,000跟单，需确保账户流动性充足。daemon模式在Token失效或API限流时可能静默失败，建议配合/clawback status每日巡检。