服务名称：trd_open_api
当前版本：1.0.4（以部署环境/health或GET /返回为准）
文档类型：对外集成说明（官网发布稿）
更新日期：2026-03-12
本文描述第三方系统对接 模拟交易开放 API 的协议、鉴权、接口清单与错误码。实现细节以线上部署为准；联调可参考仓库内 trd_open_api_test_demo。
1. 概述
开放 API 是面向机构/合作方的 HTTP JSON 服务。在运营方为您开通账户后，通过 HMAC 签名 + JWT 会话 访问模拟交易能力：
- 认证：
POST /auth/token使用下发的登录密码换取access_token。 - 交易：下单、撤单、查询委托/成交/持仓（路径均以
/api/v1/trd-open为前缀）。 - 安全：签名校验、防重放、可选 IP 白名单、按账户 QPS / 最大并发限流。
- 配置：
sign_key、权限、exchange_accounts、限流配额等由运营方开通时配置并下发。
不提供：资金流水、登录审计、历史委托/成交专用查询；当前开放侧仅提供当日委托/成交/持仓查询。历史数据请与运营方另行约定。