VeighNa Elite Trader 算法交易执行指南:五种内置算法、状态监控与多账户委托实战
VeighNa Elite Trader 算法交易执行指南:五种内置算法、状态监控与多账户委托实战
VeighNa(vnpy)Elite Trader 提供独立的算法交易执行组件,帮助交易者在主界面内直接完成大单拆单、智能择时下单等算法委托操作。本文以仓库文档 docs/elite/extension/elite_algotrading.md 为核心脉络,系统讲解算法交易的启动流程、状态监控、五种内置算法的执行逻辑与多账户支持,并结合 vnpy/trader 源码剖析其底层数据模型与事件驱动机制。读完本文,你将能够熟练使用 Elite Trader 的【算法交易】组件完成从配置、启动到暂停、停止、监控的完整交易闭环,并为自定义算法与多账户批量下单打下基础。
功能简介
VeighNa Elite Trader 提供了算法委托执行交易支持。用户可以通过 Elite Trader 主界面的【算法交易】组件便捷完成启动算法、停止算法等任务。
【算法交易】组件采用独立进程的算法引擎负责委托订单的具体执行过程——算法引擎与主交易界面解耦,即使算法出现异常也不会影响主程序的其他功能,这一设计正是"独立进程"的核心价值。目前该组件提供了五种示例算法,用户既可以通过把大笔订单自动拆分成合适的小单分批委托的操作,有效降低交易成本和冲击成本,也可以在设定的阈值内进行高抛低吸操作:
- 降成本型:如冰山算法、狙击手算法,将大单隐藏为小单逐步成交;
- 择时型:如条件委托算法,监控行情突破后立刻成交;
- 区间型:如最优限价算法,在价格处于有利区间时主动报价。
从源码结构看,Elite Trader 的算法组件遵循 vnpy 标准的"应用插件"框架:任何功能模块都通过 BaseApp 抽象类注册,由 MainEngine.add_app 加载为独立引擎,引擎则统一继承 BaseEngine 并绑定对应的事件引擎与界面组件。算法交易组件同样以此模式挂载,因此可以像其他模块一样在 Elite Trader 主界面中即开即用。
启动执行
启动 VeighNa Elite Trader 并连接交易接口之后,点击主界面左侧中部的【算法交易】标签页,即可看到算法执行组件的操作界面。
完整的启动步骤如下:
- 登录 VeighNa Elite Trader,连接交易接口(连接成功后主界面【日志】组件会输出"合约信息查询成功"等提示,此时合约数据已就绪,可以安全下单)。
- 点击主界面左侧中部的【算法交易】标签页,进入算法执行组件界面。
- 在单元格【算法】对应的下拉框中选择要启动的算法(如 TWAP、Iceberg、Sniper、Stop、BestLimit)。
- 对算法的参数进行配置,主要包括:交易所、代码(合约代码)、方向、开平、价格、委托数量、执行时间、每轮间隔等。
- 点击【启动算法】按钮,即可进行算法委托。
启动成功后,算法委托的执行情况会实时呈现在以下三个区域:
| 监控区域 | 位置 | 展示内容 |
|---|---|---|
| 【算法】标签页 | 主界面右侧中上部 | 算法的执行情况与状态 |
| 【委托】标签页 | 主界面右侧中上部 | 算法拆分产生的具体委托 |
| 【成交】标签页 | 主界面右侧中下部 | 委托对应的成交明细 |
若需要停止所有已启动的算法,点击【全部停止】按钮即可一键停止全部算法。
参数配置要点
算法参数配置是算法执行的关键。以文档中的时间加权平均算法(TWAP)为例,其核心参数语义如下:
- 交易所 / 代码:指定交易的合约,代码格式为 symbol(合约代码),如
IF2409; - 方向:多、空,对应源码中 Direction 枚举的
LONG(多)与SHORT(空); - 开平:开、平、平今、平昨,对应源码中 Offset 枚举的
OPEN、CLOSE、CLOSETODAY、CLOSEYESTERDAY; - 价格:委托下单的目标价格;
- 委托数量:委托的总数量,算法会将其拆分成小批订单逐轮执行;
- 执行时间(秒):运行该算法交易的总时间;
- 每轮间隔(秒):每隔多少时间进行一次委托下单操作。
一个典型的 TWAP 场景(示例引自 docs/elite/strategy/elite_algotrading.md):使用时间加权平均算法买入 20 手沪深 300 股指期货 2409 合约(IF2409),执行价格为 3422 元,执行时间为 120 秒,每轮间隔为 6 秒。即每隔 6 秒钟,当合约卖一价小于等于 3422 时,以 3422 的价格买入 1 手 IF2409,将买入操作分割成 20 次完成,从而平滑大单的市场冲击。
算法状态监控
启动 VeighNa Elite Trader 之后,点击主界面右侧中上部的【算法】标签页,即可看到算法状态监控组件。
算法状态监控组件用于记录已启动算法的以下信息:
- 名称:算法的名称;
- 本地代码:vt_symbol,即合约代码与交易所的组合;
- 方向:多、空;
- 开平:开、平、平今、平昨;
- 价格:算法委托的目标价格;
- 总数量:算法计划委托的总量;
- 成交量:当前已成交的数量;
- 剩余量:尚未成交的剩余数量;
- 成交均价:已成交部分的平均成交价格;
- 状态:算法的运行状态;
- 参数:启动算法时配置的参数;
- 变量:算法运行过程中动态更新的内部变量。
除此之外,组件每行最左侧还嵌入了两个控制单个算法状态的按钮(【停止】与【暂停】),方便对单个算法进行精细控制。
这些监控字段与 vnpy 核心数据对象一一对应:委托与成交明细分别由 OrderData 与 TradeData 承载,二者都包含价格(price)、数量(volume)、成交量(traded)、方向(direction)、开平(offset)等字段;行情驱动则来自 TickData,其中 bid_price_1、ask_price_1、bid_volume_1、ask_volume_1、last_price 等字段正是五种内置算法做出买卖决策的数据基础。
算法状态
一个算法具有运行、暂停、停止和结束四种状态:
| 状态 | 英文标识 | 触发时机 |
|---|---|---|
| 运行 | RUNNING | 算法启动后立即进入 |
| 结束 | FINISHED | 算法因完成任务而主动结束(计时到了或成交量满足条件等) |
| 暂停 | PAUSED | 算法被用户暂停 |
| 停止 | STOPPED | 算法被被动停止 |
可以看到,算法结束与停止的关键区别在于:主动完成(FINISHED)与被动终止(STOPPED)。前者是算法执行完所有委托任务后的自然归宿,后者是用户干预或异常导致的中断。
算法控制按钮
当算法启动后,【算法】组件上会显示该算法的状态信息,此时该算法信息最左侧的【停止】和【暂停】按钮皆处于可点击状态。若该算法主动结束了,此时该算法最左侧的两个按钮区域皆会变灰(不可点击)。
暂停算法
若想暂停算法的执行,可点击【暂停】按钮,此时原来【暂停】按钮上的文字会变为"恢复"。
恢复算法
如果想恢复已暂停算法的执行,则可点击【恢复】按钮进行恢复,此时原来【恢复】按钮上的文字会变为"暂停"。
停止算法
若想停止该运行中的算法,可以点击【停止】按钮停止算法,此时该算法最左侧的两个按钮区域皆会变灰(不可点击)。
从状态机角度看,按钮文字在"暂停/恢复"之间切换,正是算法状态在 PAUSED 与 RUNNING 之间往返切换的可视化反馈;而按钮区域变灰,则对应算法进入 FINISHED 或 STOPPED 终态后不再接受控制指令。
算法介绍
目前,【算法交易】组件提供了以下五种内置算法。所有算法都以最新 Tick 推送的行情(尤其是盘口买卖一档的价格与数量)作为决策输入,通过"条件判断 + 委托下单"的方式逐轮执行。
TWAP - 时间加权平均算法
时间加权平均算法(TWAP)具体执行步骤如下:
- 将委托数量平均分布在某个时间区域内,每隔一段时间用指定的价格挂出买单(或者卖单);
- 买入情况:卖一价低于目标价格时,发出委托,委托数量在剩余委托量与委托分割量中取最小值;
- 卖出情况:买一价高于目标价格时,发出委托,委托数量在剩余委托量与委托分割量中取最小值。
TWAP 的核心是"时间均匀分割":总数量除以轮次数得到每轮委托分割量,只要盘口价格满足条件就以目标价挂出 min(剩余委托量, 分割量) 的小单,直到执行时间耗尽或全部成交。
Iceberg - 冰山算法
冰山算法(Iceberg)具体执行步骤如下:
- 在某个价位挂单,但是只挂一部分,直到全部成交;
- 买入情况:先检查撤单,最新 Tick 卖一价低于目标价格时,执行撤单;若无活动委托,发出委托,委托数量在剩余委托量与挂出委托量中取最小值;
- 卖出情况:先检查撤单,最新 Tick 买一价高于目标价格时,执行撤单;若无活动委托,发出委托,委托数量在剩余委托量与挂出委托量中取最小值。
冰山算法的精髓在于"只露出水面一角":每次只在目标价位挂出小部分委托,成交后补挂下一部分,同时通过撤单逻辑保证挂单价格始终跟随市场有利方向,从而隐藏大单的真实规模。
Sniper - 狙击手算法
狙击手算法(Sniper)具体执行步骤如下:
- 监控最新 Tick 推送的行情,发现好的价格立刻报价成交;
- 买入情况:最新 Tick 卖一价低于目标价格时,发出委托,委托数量在剩余委托量与卖一量中取最小值;
- 卖出情况:最新 Tick 买一价高于目标价格时,发出委托,委托数量在剩余委托量与买一量中取最小值。
狙击手算法不做价格等待,而是"咬住对手盘":一旦对手一档价格优于目标价,立刻按对手盘量(卖一量/买一量)与剩余量的较小值出手,追求快速成交。
Stop - 条件委托算法
条件委托算法(Stop)具体执行步骤如下:
- 监控最新 Tick 推送的行情,发现行情突破立刻报价成交;
- 买入情况:Tick 最新价高于目标价格时,发出委托,委托价为目标价格加上超价;
- 卖出情况:Tick 最新价低于目标价格时,发出委托,委托价为目标价格减去超价。
条件委托算法本质是一个"可配置超价"的止损/突破单:以最新成交价突破目标价作为触发条件,通过"目标价格 ± 超价"的方式给委托留出成交余量,确保行情快速穿越时委托能够被优先撮合。
BestLimit - 最优限价算法
最优限价算法(BestLimit)具体执行步骤如下:
- 监控最新 Tick 推送的行情,发现好的价格立刻报价成交;
- 买入情况:先检查撤单:最新 Tick 买一价不等于目标价格时,执行撤单;若无活动委托,发出委托,委托价格为最新 Tick 买一价,委托数量为剩余委托量;
- 卖出情况:先检查撤单:最新 Tick 买一价不等于目标价格时,执行撤单;若无活动委托,发出委托,委托价格为最新 Tick 卖一价,委托数量为剩余委托量。
最优限价算法始终把委托挂在盘口"最优一档":买方向挂买一价、卖方向挂卖一价,并在盘口最优价偏离目标价时撤掉旧单、重挂新单,兼顾了成交速度与成交价格,是五种算法中价格跟随最积极的一种。
多账户支持
算法委托执行交易模块提供了多账户批量下单交易支持(手动),允许同一客户端同时管理多个交易账户,并通过【算法交易】组件按账户分别启动算法委托。
加载
以登录 CTP 接口为例,多账户加载步骤如下:
- 在登录界面下方的【交易接口】标签页的下拉框中先选中 CTP 接口。
- 在"自定义接口"处填写自定义的接口名(例如 "CTP1"、"CTP2")之后点击【添加】按钮。
- 填写子账户的配置信息(如经纪商代码、用户代码、密码等),点击【确定】按钮,即可依次加载对应账户的接口。
- 添加完毕后,点击登录界面的【登录】按钮登录 VeighNa Elite Trader。
- 在菜单栏中依次点击【系统】->【连接xxx】(xxx 是自定义的接口名,若加载时填写的 "CTP1",则菜单栏中显示的就是【连接CTP1】),即可连接子账户接口。
连接成功以后,VeighNa Elite Trader 主界面【日志】组件会立刻输出登录相关信息,同时用户也可以看到对应的账号信息、持仓信息等相关信息。此时已经可以在【市场深度交易】界面通过指定的账户进行委托了。
这里的"自定义接口名"机制,本质上是同一 Gateway 类的多个实例化:每个自定义名对应一份独立的账户配置,登录后各自建立独立的交易通道,互不干扰。
算法下单
账户下单
若需通过【算法交易】组件进行多账户委托,可在创建的图表左上角选择账户对应的【接口】来启动算法。
发出委托后,可以在 VeighNa Elite Trader 主界面【算法】、【委托】和【成交】组件上跟踪到根据对应接口下单的委托——即每个账户发出的委托都带有其所属接口的标识,方便跨账户核对执行情况。
请注意:
- 目前支持同时登录最多 5 个交易账户。
源码层面的实现原理
为了让读者更深入地理解上述功能,这里从 vnpy/trader 源码角度补充几条与算法交易直接相关的底层机制。
事件驱动与数据模型
算法交易的全部决策都建立在实时行情推送之上。在 vnpy 中,交易接口每收到一笔行情都会构造 TickData 并通过事件引擎广播,算法引擎订阅该事件后执行条件判断:
ask_price_1(卖一价)与bid_price_1(买一价)用于 TWAP、Iceberg、Sniper、BestLimit 的买卖决策;last_price(最新成交价)用于 Stop 算法的突破判断;ask_volume_1(卖一量)与bid_volume_1(买一量)用于 Sniper 的委托数量计算。
算法发出的委托由 OrderData 描述,其 traded(已成交量)与 volume(委托总量)字段正是状态监控中"成交量/剩余量"的数据来源;每笔成交由 TradeData 记录,其价格汇总即可得到"成交均价"。
枚举定义与参数取值
算法配置中的方向、开平、委托类型等参数,都对应 constant.py 中定义的枚举:
- Direction:多(LONG)、空(SHORT)、净(NET);
- Offset:开(OPEN)、平(CLOSE)、平今(CLOSETODAY)、平昨(CLOSEYESTERDAY);
- OrderType:限价(LIMIT)、市价(MARKET)、STOP、FAK、FOK、询价(RFQ)等。
算法引擎在内部会将这些枚举值转换为网关对应的下单字段,因此界面下拉框中的选项与源码枚举一一对应,这也是配置项取值范围的权威依据。
引擎挂载与独立进程
Elite Trader 的算法交易组件采用独立进程的算法引擎,其架构遵循 vnpy 的应用模块体系:每个功能模块实现 BaseApp 抽象类(声明 app_name、app_module、engine_class、widget_name 等属性),再通过 MainEngine.add_app 在启动时注册加载,对应的引擎类继承 BaseEngine 并注册所需的事件处理函数。这种"主引擎统一管理、算法引擎独立执行"的分层设计,既保证了组件间的解耦,也让算法交易可以稳定地长时间运行。
小结
VeighNa Elite Trader 的【算法交易】组件以独立进程的算法引擎为核心,提供了 TWAP、Iceberg、Sniper、Stop、BestLimit 五种开箱即用的示例算法,配合【算法】状态监控、【委托】与【成交】明细跟踪,以及"暂停/恢复/停止/全部停止"的完整控制能力,能够有效应对大单拆分与智能择时的执行需求;同时通过自定义接口名机制支持最多 5 个交易账户的批量下单。无论是手工拆分大单降低冲击成本,还是依托 Tick 行情进行条件化执行,本文介绍的配置方式与状态管理逻辑都可以直接应用于实盘交易场景。如果读者希望进一步扩展,可参考 docs/elite/strategy/elite_algotrading.md 了解同模块下的 CSV 智能扫单能力,或基于 vnpy/trader 的数据模型自行编写个性化算法。