核心用法
Trading 212 API Skill 是官方提供的程序化交易接口，目前处于 Beta 测试阶段，支持 Invest 账户和 Stocks ISA 账户，不支持 CFD 或 ISA 以外的账户类型。
认证机制 采用 HTTP Basic Auth，用户需在 Trading 212 App 内生成 API Key + Secret 对，经 Base64 编码后构建 Authorization: Basic <token> 请求头。关键限制：API Key 与生成环境严格绑定——Live 账户创建的 Key 无法用于 Demo 环境，反之亦然。
核心功能模块：
- 账户信息：查询总资产、可用现金、已实现/未实现盈亏
- 订单管理：支持市价单(Market)、限价单(Limit)、止损单(Stop)、止损限价单(Stop-Limit)，正负数量区分买卖方向
- 持仓监控：获取当前头寸、可交易数量（需区分直接持仓 vs Pie 内持仓）
- 合约查询：全量 instruments 列表（约 5MB，建议本地缓存 1 小时）
- 历史数据：订单成交记录、股息明细、资金流水，支持游标分页
- 报表导出：异步生成 CSV 交易报告
环境隔离：明确区分 Demo（纸面交易）与 Live（真实资金），每次会话前必须确认目标环境。
显著优点
1. 官方原生支持：由 Trading 212 直接维护，接口规范性与数据权威性高于第三方爬虫方案
2. 零佣金交易生态：结合平台本身的免佣金策略，API 交易无额外技术费用
3. 多账户支持：可同时配置 Invest 与 Stocks ISA 两套凭证，实现跨账户资产管理
4. 完整订单生命周期：从下单、改单、撤单到成交回执，状态机清晰（NEW → PARTIALLY_FILLED → FILLED / CANCELLED / REJECTED）
5. 税务透明：订单成交详情包含印花税、FINRA 费用、外汇转换费等明细，便于税务申报
6. 预交易校验机制：文档强调先查资金/持仓再下单，降低废单率
潜在缺点与局限性
1. Beta 阶段不稳定：接口定义、速率限制、功能可用性可能随时变更，生产环境需谨慎
2. 账户类型受限：仅限 Invest 和 Stocks ISA，不支持 CFD、 pension 账户或其他地区变体
3. 无实时行情：不提供 WebSocket 或实时报价流，需依赖外部行情源
4. 速率限制严格：部分端点仅 1 req/50s（instruments）、1 req/5s（账户摘要），批量操作需设计缓存与退避策略
5. 无市价保护：市价单直接提交交易所，极端行情下存在滑点风险，无价格区间保护机制
6. 订单不可幂等：重复提交会生成重复订单，需客户端自行实现去重逻辑
7. 持仓锁定复杂：Pie（组合投资）内的持仓不计入 quantityAvailableForTrading，卖出前需显式检查
适合人群
- 量化策略开发者：需要自动化执行低频交易策略（因速率限制不适合高频）
- 多账户资产管理者：同时管理 Invest 与 ISA 账户的个人投资者
- 税务优化需求者：需要详细交易记录与费用明细进行税务申报
- 纸面交易系统验证者：利用 Demo 环境回测策略逻辑后再迁移至实盘
常规风险
| 风险类型 | 说明 | 缓释建议 |
|---------|------|---------|
| **环境误操作** | Live/Demo 凭证混用导致实盘意外下单 | 严格分离环境变量命名（如 `T212_LIVE_AUTH_HEADER` vs `T212_DEMO_AUTH_HEADER`） |
| **速率限制触发** | burst 请求导致 429 错误，关键操作被阻断 | 均匀 pacing（如 50 req/min 端点间隔 ≥1.2s），优先使用本地缓存 |
| **重复订单** | 网络重试或脚本逻辑缺陷导致重复成交 | 实现客户端订单 ID 去重，或人工确认关键交易 |
| **Pie 持仓锁定** | 误以为总持仓可卖，实际部分锁定在 Pie 中 | 下单前强制校验 `quantityAvailableForTrading` 而非 `quantity` |
| **API 变更风险** | Beta 阶段接口废弃或字段变更 | 订阅官方更新通知，维护集成测试套件 |
| **密钥泄露** | 硬编码凭证或日志打印导致账户被盗 | 全程使用环境变量，禁止日志输出 `T212_API_SECRET` 或 `T212_AUTH_HEADER` |