trading212-api

核心用法

Trading 212 API 技能提供了一套完整的股票交易自动化操作指南，涵盖从账户认证到订单执行的全流程。用户可通过该技能连接 Trading 212 的 Invest 或 Stocks ISA 账户（暂不支持 CFD），在 Demo（模拟）或 Live（实盘）环境中进行程序化交易。核心功能包括：使用 HTTP Basic Auth 进行 API 认证；放置市价单、限价单、止损单及止损限价单；实时查询账户资金、持仓明细与盈亏状况；检索历史订单、分红记录及交易流水；导出 CSV 格式的综合交易报告。技能内置了智能的环境变量管理逻辑，支持单账户或多账户（Invest + Stocks ISA）配置，并提供详细的预下单验证脚本，确保用户在下单前检查可用资金或可售股份数量。

显著优点

该技能的最大优势在于其文档的完备性与实用性。首先，它提供了 Trading 212 Beta API 的详尽参考，包括所有端点的速率限制（如订单接口 50 次/分钟、账户查询 1 次/5 秒）、请求/响应 Schema 及错误代码对照表，大幅降低了开发者的调试成本。其次，技能内置了多重安全机制：强制要求用户明确选择 Live 或 Demo 环境、提供完整的 API Key 环境变量配置指南、包含预下单资金验证脚本，有效避免误操作导致的资金损失。此外，技能还提供了智能缓存策略（如将 instruments 数据缓存至本地 1 小时）和速率限制处理方案，帮助用户规避 API 限流。对于多账户用户，技能支持通过 T212_API_KEY_INVEST 和 T212_API_KEY_STOCKS_ISA 分别管理 Invest 和 ISA 账户，实现资产一站式管理。

潜在缺点或局限性

尽管文档详尽，但该技能存在若干局限性。首先，Trading 212 API 目前处于 Beta 阶段，端点或行为可能发生变动，生产环境使用需承担 API 变更带来的维护成本。其次，功能范围受限：仅支持 Invest 和 Stocks ISA 账户，不支持 CFD 交易；仅支持按数量（QUANTITY）下单，不支持按金额（VALUE）下单；且每个标的最多只能有 50 个待处理订单。第三，来源可信度为 T3 级别（个人开发者维护），虽内容透明可审计，但非 Trading 212 官方直接维护，更新及时性可能受限。最后，由于 API 设计非幂等性，重复请求可能创建重复订单，用户需自行实现去重逻辑。

适合的目标群体

该技能主要面向三类用户：一是具备基础编程能力的股票投资者，希望利用 API 实现定投策略、网格交易或自动再平衡；二是量化交易初学者，需要通过 Demo 环境练习程序化交易，熟悉 RESTful API 与金融数据交互；三是多账户管理用户，需要同时监控 Invest 和 Stocks ISA 账户的持仓与税务报告（如导出年度 CSV 报表）。不适合无编程基础的手动交易者，以及对高频交易有极致要求的用户（因速率限制相对保守）。

使用该技能可能存在的常规风险

使用本技能需警惕以下风险：安全风险方面，API Key 和 Secret 需通过环境变量配置，若硬编码或日志记录可能导致凭证泄露，进而造成账户资金损失；资金风险方面，Live 环境的实盘交易直接涉及真实资金，且订单一旦提交无法撤回（除非未成交），错误的代码逻辑可能导致意外买卖；性能风险方面，instruments 全量数据约 5MB 且限流 50 秒/次，首次获取可能较慢；合规风险方面，英国股票交易可能涉及印花税（Stamp Duty），API 会自动扣除，但用户需自行关注税务申报；依赖风险方面，作为 Beta API，Trading 212 可能随时调整端点或限流策略，建议用户关注官方变更日志。