官方 Trading 212 API 工具，支持股票交易、订单管理、持仓监控及历史数据导出，Beta 阶段仅限 Invest/ISA 账户，需严格区分模拟/实盘环境。
说明：
## 核心用法
Trading 212 API Skill 是官方提供的程序化交易接口，目前处于 **Beta 测试阶段**，支持 Invest 账户和 Stocks ISA 账户，不支持 CFD 或 ISA 以外的账户类型。
**认证机制** 采用 HTTP Basic Auth，用户需在 Trading 212 App 内生成 API Key + Secret 对，经 Base64 编码后构建 `Authorization: Basic ` 请求头。**关键限制**：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` |
会员专属
