用途:通过 Trading 212 公开 API 连接账户、完成认证、查询账户摘要、查询待处理订单、以及下达股票买卖订单。API 目前处于 beta 阶段,部分端点或行为可能变化。
主要能力:支持两种环境,Demo(纸面交易,https://demo.trading212.com/api/v0)与 Live(真实资金,https://live.trading212.com/api/v0);仅支持 Invest 和 Stocks ISA 账户;使用 Trading 212 自定义 ticker 作为交易标识,请求前需先搜索对应 ticker。订单类型包括 Market、Limit、Stop、StopLimit。数量约定:正数为买入,负数为卖出。市价单支持 extendedHours 参数,可在盘前(4:00-9:30 ET)和盘后(16:00-20:00 ET)执行。
使用方式:认证采用 HTTP Basic Auth,API Key 作为用户名、API Secret 作为密码,可先组合后 base64 编码并加 Basic 前缀构造 Authorization 头。可设置环境变量 T212_API_KEY、T212_API_SECRET、T212_ENV(demo 或 live,默认 live),账户专属变量如 T212_API_KEY_INVEST/T212_API_SECRET_INVEST 与 T212_API_KEY_STOCKS_ISA/T212_API_SECRET_STOCKS_ISA。调用前须先确认用户目标环境(LIVE 或 DEMO),不可默认假定。API Key 与环境绑定,LIVE 的密钥只能访问 live 站点,DEMO 只能访问 demo 站点,混用会返回 401。若同时配置 Invest 与 Stocks ISA,需先确认目标账户或按账户分别调用。
限定与错误:限价、止损等单约 1 请求/2 秒;账户摘要、订单查询约 1 请求/5 秒;市价单约 50 请求/分钟。403 表示权限缺失,429 表示触发限流,需等待 x-ratelimit-reset;408 可以重试。订单时间有效性支持 DAY 与 GOOD_TILL_CANCEL;API 仅支持按数量(QUANTITY)下单,不支持按金额(VALUE)。
适用场景:需要在脚本或智能体流程中查询账户、管理订单和进行模拟或实盘股票交易的开发者。