trading212-api

📈 智能股票交易 API 助手

基于 Trading 212 官方 API 的完整操作指南,支持股票买卖、账户查询与历史数据导出,助您实现安全自动化交易。

收藏
1.7k
安装
818
版本
v1.0.0
CLS 安全性认证2026-05-13
点击查看完整报告 >

使用说明

核心用法

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_INVESTT212_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 可能随时调整端点或限流策略,建议用户关注官方变更日志。

安全解读

核心用法

Trading 212 API 是一套 RESTful 接口,支持股票交易平台的完整操作链路:

认证方式:HTTP Basic Auth,需从 Trading 212 App 生成 API Key + Secret,base64 编码后使用。关键约束:Demo 与 Live 环境的 API Key 严格隔离,不可混用。

主要功能模块

  • 账户管理:查询账户余额、持仓市值、已实现/未实现盈亏
  • 订单操作:支持市价单、限价单、止损单、止损限价单;正数量买入、负数量卖出
  • 持仓监控:获取全部持仓,需关注 quantityAvailableForTrading(部分股票可能被锁定在 Pies 中)
  • 标的信息:通过 /instruments 获取完整标的列表(约 5MB),建议本地缓存 1 小时
  • 历史数据:订单记录、股息记录、资金流水,支持 CSV 报告导出

关键约束

  • 仅支持 Invest 和 Stocks ISA 账户
  • Beta 阶段,API 可能变更
  • 标的使用自定义 ticker(如 AAPL_US_EQ),不可直接推断

显著优点

1. 官方直连:直接对接 Trading 212 核心交易系统,非第三方封装,延迟低、数据准
2. 功能完整:覆盖交易全流程,从查询到下单再到报表导出

3. 安全设计:TLS 1.2+ 加密、环境隔离、密钥权限分离

4. 零佣金场景:配合 Trading 212 零佣金策略,API 交易成本可控

5. 沙盒环境:Demo 环境支持完整的 paper trading 测试

潜在缺点与局限性

1. Beta 不稳定:API 处于 Beta,端点和行为可能变化,生产使用需跟踪更新
2. 账户类型受限:不支持 CFD、Forex 等账户,仅限 Invest/ISA

3. 频率限制严格:部分端点 1 req/50s(如 instruments),需配合缓存策略

4. 无实时行情:仅支持历史数据查询,无 WebSocket 实时推送

5. 英国-centric:平台主要服务英国及欧洲用户,非全球覆盖

适合人群

  • 已有 Trading 212 账户的量化交易爱好者
  • 需要自动化投资组合管理的个人投资者
  • 希望导出完整交易记录进行税务申报的用户
  • 熟悉 REST API 和 shell/curl 的技术型交易者

常规风险

1. 密钥泄露风险:API Secret 泄露可能导致账户资金损失,必须使用环境变量存储
2. 环境混淆风险:Demo/Live Key 混用会导致 401 错误,极端情况下可能误操作实盘

3. 订单不可撤销:市价单执行极快,提交后几乎无法取消

4. 资金风险:自动化脚本 bug 可能导致重复下单或过量交易

5. Beta 兼容性:未来 API 变更可能导致现有脚本失效

trading212-api 内容

手动下载zip · 12.0 kB
SKILL.mdtext/markdown
请选择文件