WonderTrader / Adapters
wondertrader 交易接口:官方名单、仓库实际模块与接入方式
接口决定这套框架能不能落到你的账户上。官方 README 列了一份支持名单,但仓库的源码目录里实际存在的适配模块比名单更多 —— 两者都值得看:名单代表官方对外承诺的范围,目录代表你真正能编译到的东西。本文把两份清单并排列出,并给出公开测试环境的接入方式。
官方 README 列出的支持接口
以下是官方 README 与官方文档中明确写出的名单,按期货、期权、股票三类分组。原文中的限制也一并保留。
| 类别 | 接口 | 官方原文备注 | 适用场景 | 注意点 |
|---|---|---|---|---|
| 期货 | CTP | 未附加限制说明 | 国内商品期货与金融期货的主流接口 | 业内最通用的选择,仿真环境资源也最多 |
| 期货 | CTPMini | 未附加限制说明 | 使用 Mini 版本柜台的环境 | 与标准 CTP 的接口细节不同,适配模块也分开实现 |
| 期货 | 飞马 Femas | 未附加限制说明 | 使用飞马柜台的期货环境 | 「飞马」为柜台名称,需在你的期货公司确认是否提供 |
| 期货 | 艾克朗科 | 官方原文标注「仅组播行情」 | 只看行情、不通过它下单 | 该限制必须保留说明:它不提供交易能力 |
| 期货 | 易达 | 未附加限制说明 | 使用易达柜台的期货环境 | 需确认柜台版本与接口版本匹配 |
| 期权 | CTPOpt | 未附加限制说明 | 商品期权与金融期权 | 期权代码结构与期货不同,配置需按期权文件 |
| 期权 | 金证期权 maOpt | 未附加限制说明 | 使用金证期权柜台的场景 | 来自官方更新日志记录的接口新增项 |
| 期权 | QWIN 二开 | 官方原文标注为「二开」 | 基于 QWIN 二次开发的环境 | 二开接口通常需要柜台方配合,接入周期更长 |
| 股票 | 中泰 XTP | 未附加限制说明 | 股票实盘与仿真 | 官方实盘攻略就是用该接口演示股票仿真全流程 |
| 股票 | 中泰 XTPXAlgo | 未附加限制说明 | 使用算法交易总线的场景 | 该模块来自官方更新日志记录的接口新增项 |
| 股票 | 华鑫奇点 | 未附加限制说明 | 使用华鑫柜台的股票环境 | 需与券商确认柜台版本 |
| 股票 | 华锐 ATP | 未附加限制说明 | 极速柜台场景 | 官方更新日志记录为新增的极速柜台接口 |
| 股票 | 宽睿 OES | 未附加限制说明 | 极速柜台场景 | 官方更新日志记录为新增的极速股票柜台接口 |
仓库源码里实际存在的适配模块
下面两表来自仓库源码目录的实际条目(2026-09-16 检索)。可以看到实际模块数量多于官方名单,说明部分接口已实现但未写进 README 名单。
| 交易适配模块 | 对应柜台 / 用途 | 是否在官方名单中 | 适用场景 | 注意点 |
|---|---|---|---|---|
| 标准 CTP 交易模块 | CTP 交易 | 是 | 期货实盘 | 最常用的组合 |
| CTPMini 交易模块 | CTPMini 交易 | 是 | Mini 柜台环境 | 与标准 CTP 分开维护 |
| CTP 期权交易模块 | 期权交易 | 是 | 期权实盘 | 需配合期权基础文件 |
| 飞马交易模块 | 飞马柜台 | 是 | 期货实盘 | 环境依赖柜台方 |
| 华泰交易模块 | 华泰相关柜台 | 否(未写入名单) | 对应柜台环境 | 要使用请先与柜台确认可用性 |
| 中泰 XTP 交易模块 | 股票实盘与仿真 | 是 | 股票实盘 | 官方实盘攻略的演示接口 |
| 中泰 XTP 算法交易模块 | 算法交易总线 | 是 | 算法下单 | 需券商开通相应权限 |
| 宽睿 OES 交易模块 | 极速股票柜台 | 是 | 低延迟股票场景 | 需券商开通 |
| 华锐 ATP 交易模块 | 极速柜台 | 是 | 低延迟股票场景 | 需券商开通 |
| 易达交易模块 | 易达柜台 | 是 | 期货实盘 | 版本需匹配 |
| 顶点交易模块 | 顶点柜台 | 否(未写入名单) | 对应柜台环境 | 要使用请先与柜台确认可用性 |
| 华鑫交易模块 | 华鑫奇点 | 是 | 股票实盘 | 需券商开通 |
| 仿真交易模块 | 内置仿真撮合 | 否(属能力而非接口) | 无柜台时跑通流程 | 来自官方更新日志记录,覆盖已支持的股票与期货 |
| 交易数据转储模块 | 把交易接口数据转接出来 | 否(属工具) | 自建交易记录归档 | 来自官方更新日志记录的模块 |
| 行情解析模块 | 对应行情源 / 用途 | 是否在官方名单中 | 适用场景 | 注意点 |
|---|---|---|---|---|
| 标准 CTP 行情模块 | CTP 行情 | 是 | 期货行情 | 最常用的组合 |
| CTPMini / CTPOpt 行情模块 | Mini 与期权行情 | 是 | 对应柜台 | 与交易模块配套使用 |
| 飞马行情模块 | 飞马行情 | 是 | 期货行情 | 环境依赖柜台方 |
| 中泰 XTP 行情模块 | 股票行情(含逐笔数据) | 是 | 股票实盘 | 官方更新日志记录过对该接口逐笔数据处理的完善 |
| 华鑫 / 宽睿 / 华锐行情模块 | 对应极速柜台行情 | 是 | 低延迟股票场景 | 需券商开通 |
| 共享内存行情模块 | 通过内存映射文件转发行情 | 否(属新增能力) | 同机多进程行情分发 | 来自官方更新日志 0.9.9 的新增模块 |
| UDP 行情模块 | 接收本地广播行情 | 否(属内置能力) | 与数据组件配合 | 官方实盘攻略中用它接收数据组件广播 |
没有柜台时怎么先跑通
在拿到真实柜台权限之前,官方提供了两种可以用来验证全链路的途径。
| 途径 | 官方做法 | 能验证什么 | 不能验证什么 | 注意点 |
|---|---|---|---|---|
| 内置仿真交易模块 | 使用内置仿真撮合模块,覆盖已支持的股票与期货 | 策略信号到下单流程是否走通 | 无法反映真实撮合与排队 | 官方更新日志记录该模块可满足已支持品种的仿真交易 |
| 柜台仿真环境 | 官方实盘攻略用股票仿真账号演示完整流程 | 行情通道、交易通道、落地与广播的配置是否正确 | 不代表实盘可用 | 仿真账号通常需要单独申请 |
| 公开测试环境 | 官方 FAQ 给出通过仿制 CTP 模块接入公开测试环境的方式 | 标准 CTP 链路的连通性 | 不代表你的生产柜台可用 | 官方示例中的前置地址与账号是给公众测试用的,不要用于承载真实业务 |
| 回测环境 | 用历史数据回放策略 | 策略逻辑与参数 | 不验证任何接口连通性 | 回测通过后再做仿真跟踪,这是官方建议的顺序 |
公开测试环境接入要点
官方 FAQ 专门写了一节讲如何接入公开测试环境,核心是在行情与交易通道配置里指定仿制的 CTP 模块。
| 配置位置 | 要改什么 | 官方示例中的取值 | 作用 | 注意点 |
|---|---|---|---|---|
| 行情通道配置 | 指定柜台模块名 | 示例使用仿制的行情模块名 | 让行情解析模块加载仿制接口库而非原生库 | 模块名必须与实际文件对应 |
| 交易通道配置 | 指定柜台模块名 | 示例使用仿制的交易模块名 | 让交易适配模块加载仿制接口库 | 行情与交易可能用不同的模块名 |
| 快速私有流开关 | 打开该开关 | 官方强调必须为真 | 不接收上次连接之前的历史私有流 | 官方原文用「一定要为真」强调,属于必改项 |
| 前置地址 | 填写测试环境地址 | 官方文档给出公开测试地址 | 连接测试席位 | 不要在生产配置里沿用测试地址 |
| 数据落地开关 | 是否把接口数据写入本地文件 | 官方示例开启 | 便于排查回报与资金数据 | 开启后会额外占磁盘,长期运行需管理 |
官方名单里没有你的柜台怎么办
官方文档专门设了「C++ 开发」章节讲扩展,说明适配层是按可扩展设计的。以下是官方给出的扩展入口。
| 扩展点 | 官方文档入口 | 你要实现什么 | 难度与周期 | 注意点 |
|---|---|---|---|---|
| 行情接口适配 | 官方文档「对接新的行情接口」 | 把新行情源的推送转成框架内部行情结构并注入 | 取决于行情源协议复杂度 | 行情解析模块需与数据组件的录制链路配合 |
| 交易接口适配 | 官方文档「对接新的交易接口」 | 实现下单、撤单、查询与回报转换 | 通常比行情适配重 | 回报与资金查询的正确性直接决定风控是否可信 |
| 自定义数据存储 | 官方文档「自定义数据存储模块」 | 把行情读写接到自己的存储引擎 | 中 | 官方另有扩展加载器与转储器两个更轻的接入点 |
| 自定义执行单元 | 官方文档「自定义执行单元」 | 实现自己的算法交易执行逻辑 | 中 | 官方提供执行单元工厂作为扩展入口 |
| 扩展行情解析器 | 官方文档「使用进阶」章节 | 在不需要改核心的情况下接入额外行情源 | 较低 | 适合已有行情源、只想接进数据链路的场景 |
| C++ 开发环境 | 官方文档「C++开发环境搭建」 | 准备编译与调试环境 | 前置步骤 | 仓库 docker 目录提供可用于构建的镜像定义 |
接口层排查表
接口问题的表现形式很相似,先按「行情通不通 / 交易通不通」二分,再往下查。
| 现象 | 可能原因 | 核对方法 | 处理方向 |
|---|---|---|---|
| 行情连上但一直没数据 | 前置地址或账号错误,合约代码与合约文件不一致 | 看行情解析日志是否有登录成功与订阅成功记录 | 核对前置、账号与录制范围内的代码写法 |
| 交易通道登录失败 | 缺少授权字段,或账号未开通该柜台权限 | 对照官方接口配置样例检查授权字段是否齐全 | 与券商或期货公司确认接口与权限开通状态 |
| 能下单但查询不到持仓 | 未开启接口数据落地,或未打开快速私有流开关 | 检查通道配置中的数据落地与私有流开关 | 官方强调该开关必须为真,先把它打开 |
| 行情正常但下单被拒 | 触发通道流量风控,或账户权限范围不含该标的 | 看风控日志与通道返回的错误码 | 按柜台限制调整风控阈值并复核权限范围 |
| 仿真环境能跑、实盘不行 | 名称与模块名对不上,或生产前置与测试前置混用 | 逐项比对两套配置的模块名与前置地址 | 生产配置独立维护,不要从测试配置复制 |
| 新接的柜台回报对不上 | 行情或交易适配层的字段映射有偏差 | 用交易数据转储模块导出接口原始数据比对 | 修正适配层字段映射后重新验证 |
常见问题
接口支持范围随版本变化,最终以官方仓库、官方文档与你所接柜台的公告为准。
官方名单和仓库里的模块为什么不一样?
因为两者口径不同。README 的名单是官方对外列出的支持范围,而源码目录里的条目反映的是仓库当前实际包含的适配模块,其中一些已实现但未写进名单(例如部分柜台适配与仿真、转储类模块)。判断能不能用,建议两份都看:名单代表官方承诺,目录代表你能编译到的东西,最终还要以柜台公告与你自己的连通性测试为准。
艾克朗科可以直接用来下单吗?
不能。官方在名单里对该接口标注了「仅组播行情」,也就是说它只提供行情能力,不提供交易能力。如果只看别人整理的支持列表,很容易误以为它支持交易,实际接入时会发现下单无从下手。任何转述名单的内容都应保留这个限制。
没有柜台,怎么先验证流程?
有两条路:一是用内置的仿真交易模块,官方说明它覆盖已支持的股票与期货,可以验证从信号到下单的流程;二是申请柜台仿真账号,官方「实盘完整攻略」本身就是用股票仿真账号演示的,覆盖行情通道、交易通道、落地目录与广播端口这整条链路。另外官方 FAQ 也给出了接入公开测试环境的方式,但那只适合验证连通性。
为什么强调快速私有流开关必须打开?
官方 FAQ 在交易通道配置示例里用「一定要为真」强调了这个开关。它的作用是只接收本次连接之后的私有流,而不是把上次连接之前的历史回报也拉回来。如果不打开,可能把历史回报当成当前回报处理,导致持仓与成交记录错乱。这类问题在仿真环境不容易复现,所以官方才用加粗语气提示。
能不能不用官方名单里的柜台,接自研接口?
可以,官方文档专门有「C++开发」章节讲扩展,包括对接新的行情接口、对接新的交易接口、自定义数据存储模块、自定义执行单元等入口。但要有心理准备:交易适配需要正确实现下单、撤单、查询与回报转换,其中回报与资金查询的正确性直接决定风控是否可信,工作量通常比行情适配大。本文不评估任何具体柜台的开通难度。
EasyClaw 那边的交易接口能替代吗?
覆盖范围不同,不能替代。EasyClaw 本机技能中确有交易类能力(例如富途 OpenAPI 相关技能可做港股、美股、A 股行情与模拟/实盘下单),但其期货覆盖为主连标的,且不包含本框架所涉及的国内期货柜台直连、组合执行与通道风控。如果你需要的是国内期货或极速柜台链路,仍需自建。两者之间没有已证实的集成关系。