（12082期）Trading212 API – 官方股票交易 API，支持 Invest/ISA

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