WonderTrader / Adapters

wondertrader 交易接口:官方名单、仓库实际模块与接入方式

接口决定这套框架能不能落到你的账户上。官方 README 列了一份支持名单,但仓库的源码目录里实际存在的适配模块比名单更多 —— 两者都值得看:名单代表官方对外承诺的范围,目录代表你真正能编译到的东西。本文把两份清单并排列出,并给出公开测试环境的接入方式。

期货:CTP / CTPMini / 飞马 / 易达期权:CTPOpt / 金证 / QWIN股票:XTP / 奇点 / ATP / OES扩展:可自研适配
行情解析层Parser*
交易执行层Trader*
策略层CTA/SEL/HFT/UFT
行情与交易适配分层示意(依据官方 README 与仓库源码目录实际模块清单,检索 2026-09-16);示意非官方架构图,接口支持范围以官方文档与柜台公告为准。
Official list

官方 README 列出的支持接口

以下是官方 README 与官方文档中明确写出的名单,按期货、期权、股票三类分组。原文中的限制也一并保留。

类别接口官方原文备注适用场景注意点
期货CTP未附加限制说明国内商品期货与金融期货的主流接口业内最通用的选择,仿真环境资源也最多
期货CTPMini未附加限制说明使用 Mini 版本柜台的环境与标准 CTP 的接口细节不同,适配模块也分开实现
期货飞马 Femas未附加限制说明使用飞马柜台的期货环境「飞马」为柜台名称,需在你的期货公司确认是否提供
期货艾克朗科官方原文标注「仅组播行情」只看行情、不通过它下单该限制必须保留说明:它不提供交易能力
期货易达未附加限制说明使用易达柜台的期货环境需确认柜台版本与接口版本匹配
期权CTPOpt未附加限制说明商品期权与金融期权期权代码结构与期货不同,配置需按期权文件
期权金证期权 maOpt未附加限制说明使用金证期权柜台的场景来自官方更新日志记录的接口新增项
期权QWIN 二开官方原文标注为「二开」基于 QWIN 二次开发的环境二开接口通常需要柜台方配合,接入周期更长
股票中泰 XTP未附加限制说明股票实盘与仿真官方实盘攻略就是用该接口演示股票仿真全流程
股票中泰 XTPXAlgo未附加限制说明使用算法交易总线的场景该模块来自官方更新日志记录的接口新增项
股票华鑫奇点未附加限制说明使用华鑫柜台的股票环境需与券商确认柜台版本
股票华锐 ATP未附加限制说明极速柜台场景官方更新日志记录为新增的极速柜台接口
股票宽睿 OES未附加限制说明极速柜台场景官方更新日志记录为新增的极速股票柜台接口
Source tree

仓库源码里实际存在的适配模块

下面两表来自仓库源码目录的实际条目(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 行情模块接收本地广播行情否(属内置能力)与数据组件配合官方实盘攻略中用它接收数据组件广播
Simulation

没有柜台时怎么先跑通

在拿到真实柜台权限之前,官方提供了两种可以用来验证全链路的途径。

途径官方做法能验证什么不能验证什么注意点
内置仿真交易模块使用内置仿真撮合模块,覆盖已支持的股票与期货策略信号到下单流程是否走通无法反映真实撮合与排队官方更新日志记录该模块可满足已支持品种的仿真交易
柜台仿真环境官方实盘攻略用股票仿真账号演示完整流程行情通道、交易通道、落地与广播的配置是否正确不代表实盘可用仿真账号通常需要单独申请
公开测试环境官方 FAQ 给出通过仿制 CTP 模块接入公开测试环境的方式标准 CTP 链路的连通性不代表你的生产柜台可用官方示例中的前置地址与账号是给公众测试用的,不要用于承载真实业务
回测环境用历史数据回放策略策略逻辑与参数不验证任何接口连通性回测通过后再做仿真跟踪,这是官方建议的顺序
Test env

公开测试环境接入要点

官方 FAQ 专门写了一节讲如何接入公开测试环境,核心是在行情与交易通道配置里指定仿制的 CTP 模块。

配置位置要改什么官方示例中的取值作用注意点
行情通道配置指定柜台模块名示例使用仿制的行情模块名让行情解析模块加载仿制接口库而非原生库模块名必须与实际文件对应
交易通道配置指定柜台模块名示例使用仿制的交易模块名让交易适配模块加载仿制接口库行情与交易可能用不同的模块名
快速私有流开关打开该开关官方强调必须为真不接收上次连接之前的历史私有流官方原文用「一定要为真」强调,属于必改项
前置地址填写测试环境地址官方文档给出公开测试地址连接测试席位不要在生产配置里沿用测试地址
数据落地开关是否把接口数据写入本地文件官方示例开启便于排查回报与资金数据开启后会额外占磁盘,长期运行需管理
不要照抄测试凭据:官方 FAQ 中的测试前置地址与账号是面向公众的测试资源,仅用于连通性验证。本文不复述具体凭据,生产环境请使用你自己的柜台账号,并向券商或期货公司确认接口与权限范围。
Extension

官方名单里没有你的柜台怎么办

官方文档专门设了「C++ 开发」章节讲扩展,说明适配层是按可扩展设计的。以下是官方给出的扩展入口。

扩展点官方文档入口你要实现什么难度与周期注意点
行情接口适配官方文档「对接新的行情接口」把新行情源的推送转成框架内部行情结构并注入取决于行情源协议复杂度行情解析模块需与数据组件的录制链路配合
交易接口适配官方文档「对接新的交易接口」实现下单、撤单、查询与回报转换通常比行情适配重回报与资金查询的正确性直接决定风控是否可信
自定义数据存储官方文档「自定义数据存储模块」把行情读写接到自己的存储引擎官方另有扩展加载器与转储器两个更轻的接入点
自定义执行单元官方文档「自定义执行单元」实现自己的算法交易执行逻辑官方提供执行单元工厂作为扩展入口
扩展行情解析器官方文档「使用进阶」章节在不需要改核心的情况下接入额外行情源较低适合已有行情源、只想接进数据链路的场景
C++ 开发环境官方文档「C++开发环境搭建」准备编译与调试环境前置步骤仓库 docker 目录提供可用于构建的镜像定义
Troubleshooting

接口层排查表

接口问题的表现形式很相似,先按「行情通不通 / 交易通不通」二分,再往下查。

现象可能原因核对方法处理方向
行情连上但一直没数据前置地址或账号错误,合约代码与合约文件不一致看行情解析日志是否有登录成功与订阅成功记录核对前置、账号与录制范围内的代码写法
交易通道登录失败缺少授权字段,或账号未开通该柜台权限对照官方接口配置样例检查授权字段是否齐全与券商或期货公司确认接口与权限开通状态
能下单但查询不到持仓未开启接口数据落地,或未打开快速私有流开关检查通道配置中的数据落地与私有流开关官方强调该开关必须为真,先把它打开
行情正常但下单被拒触发通道流量风控,或账户权限范围不含该标的看风控日志与通道返回的错误码按柜台限制调整风控阈值并复核权限范围
仿真环境能跑、实盘不行名称与模块名对不上,或生产前置与测试前置混用逐项比对两套配置的模块名与前置地址生产配置独立维护,不要从测试配置复制
新接的柜台回报对不上行情或交易适配层的字段映射有偏差用交易数据转储模块导出接口原始数据比对修正适配层字段映射后重新验证
FAQ

常见问题

接口支持范围随版本变化,最终以官方仓库、官方文档与你所接柜台的公告为准。

官方名单和仓库里的模块为什么不一样?

因为两者口径不同。README 的名单是官方对外列出的支持范围,而源码目录里的条目反映的是仓库当前实际包含的适配模块,其中一些已实现但未写进名单(例如部分柜台适配与仿真、转储类模块)。判断能不能用,建议两份都看:名单代表官方承诺,目录代表你能编译到的东西,最终还要以柜台公告与你自己的连通性测试为准。

艾克朗科可以直接用来下单吗?

不能。官方在名单里对该接口标注了「仅组播行情」,也就是说它只提供行情能力,不提供交易能力。如果只看别人整理的支持列表,很容易误以为它支持交易,实际接入时会发现下单无从下手。任何转述名单的内容都应保留这个限制。

没有柜台,怎么先验证流程?

有两条路:一是用内置的仿真交易模块,官方说明它覆盖已支持的股票与期货,可以验证从信号到下单的流程;二是申请柜台仿真账号,官方「实盘完整攻略」本身就是用股票仿真账号演示的,覆盖行情通道、交易通道、落地目录与广播端口这整条链路。另外官方 FAQ 也给出了接入公开测试环境的方式,但那只适合验证连通性。

为什么强调快速私有流开关必须打开?

官方 FAQ 在交易通道配置示例里用「一定要为真」强调了这个开关。它的作用是只接收本次连接之后的私有流,而不是把上次连接之前的历史回报也拉回来。如果不打开,可能把历史回报当成当前回报处理,导致持仓与成交记录错乱。这类问题在仿真环境不容易复现,所以官方才用加粗语气提示。

能不能不用官方名单里的柜台,接自研接口?

可以,官方文档专门有「C++开发」章节讲扩展,包括对接新的行情接口、对接新的交易接口、自定义数据存储模块、自定义执行单元等入口。但要有心理准备:交易适配需要正确实现下单、撤单、查询与回报转换,其中回报与资金查询的正确性直接决定风控是否可信,工作量通常比行情适配大。本文不评估任何具体柜台的开通难度。

EasyClaw 那边的交易接口能替代吗?

覆盖范围不同,不能替代。EasyClaw 本机技能中确有交易类能力(例如富途 OpenAPI 相关技能可做港股、美股、A 股行情与模拟/实盘下单),但其期货覆盖为主连标的,且不包含本框架所涉及的国内期货柜台直连、组合执行与通道风控。如果你需要的是国内期货或极速柜台链路,仍需自建。两者之间没有已证实的集成关系。

接好接口,还要盯得住运行

控制台负责把组合、策略、通道与日志集中到一处,并提供自动调度与进程守护,是长期运行不可或缺的一环。