VeighNa Elite Trader 算法交易执行指南:五种内置算法与多账户委托实战
VeighNa Elite Trader 算法交易执行指南:五种内置算法与多账户委托实战
VeighNa Elite Trader 的【算法交易】组件是一套基于独立进程算法引擎的委托执行方案,用于把大笔订单自动拆分成小单分批委托,从而降低交易成本与市场冲击成本,并支持在设定阈值内进行高抛低吸。本文以 docs/elite/extension/elite_algotrading.md 为核心,结合 docs/elite/strategy/elite_algotrading.md、docs/community/app/algo_trading.md 与 vnpy/trader/constant.py 等仓库内容,系统讲解算法交易的启动、状态监控、五种内置算法原理以及多账户批量下单的完整实战流程。
功能简介
VeighNa Elite Trader 主界面的【算法交易】组件,用于完成启动算法、停止算法等核心任务。与手工下单不同,算法交易组件采用独立进程的算法引擎负责委托订单的具体执行过程,将执行逻辑与主交易界面解耦,避免算法循环判断占用主进程资源。
从 CHANGELOG.md 的版本演进可以看出该模块的设计脉络:
- 算法模块历史上经历了“移除套利和网格两个非执行类算法”(仅保留纯执行类算法);
- 调整了模板与引擎设计,只支持单合约算法执行交易;
- 增加状态枚举值,算法支持暂停和恢复运行;
- 增加委托/成交推送时对算法状态的过滤,修复条件委托算法全部成交后状态更新缺失的问题;
- 算法交易模块最终被剥离到独立的
vnpy_algotrading项目中,由 VeighNa Elite Trader 以应用(App)形式加载。
当前仓库默认提供五种示例算法:TWAP(时间加权平均)、Iceberg(冰山)、Sniper(狙击手)、Stop(条件委托)、BestLimit(最优限价)。用户既可以通过大单拆分降低冲击成本,也可以在设定阈值内进行高抛低吸操作。
启动执行
启动 VeighNa Elite Trader 并成功连接交易接口后,点击主界面左侧中部的【算法交易】标签页,即可看到算法执行组件的操作界面。
整个界面核心是左侧的算法配置区与右侧的执行监控区:
- 在单元格【算法】对应的下拉框中选择要启动的算法(TWAP / Iceberg / Sniper / Stop / BestLimit 之一)。
- 选择好算法后,对算法的参数进行配置。
- 点击【启动算法】按钮,即开始算法委托执行。
启动成功后,监控信息会分散到主界面右侧的三个标签页中:
- 右侧中上部分的【算法】标签页:显示该算法的执行情况;
- 右侧中上部分的【委托】标签页:显示算法拆分后发出的委托;
- 右侧中下部分的【成交】标签页:显示委托对应的成交回报。
若需停止所有已启动的算法,点击【全部停止】按钮即可一键终止全部算法。
参数配置说明
以 docs/community/app/algo_trading.md 中描述的配置字段为准,算法启动前需要填写以下参数:
- 算法:下拉框选择要执行的交易算法;
- 交易所 / 本地代码:Elite 版本中拆分为交易所(symbol 前缀)与代码两个字段,格式为
symbol(合约代码);社区版则统一使用vt_symbol(合约代码 + 交易所名称); - 方向:多、空。对应 vnpy/trader/constant.py 中
Direction枚举的LONG(多)与SHORT(空),部分市场(如股票)还有NET(净)方向; - 开平:开、平、平今、平昨。对应同一文件 constant.py 中
Offset枚举的OPEN、CLOSE、CLOSETODAY、CLOSEYESTERDAY(平今/平昨主要适用于上期所品种); - 价格:委托下单的目标价格;
- 委托数量:委托的总数量,算法会将其拆分成小批订单逐轮执行;
- 接口:选择要发出委托的交易接口(多账户场景下用于指定子账户,见下文“多账户支持”);
- 执行时间(秒):TWAP 等时间类算法运行的总时长;
- 每轮间隔(秒):每隔多少秒进行一次委托下单操作。
注意:个别示例算法未实现开平方向的判断逻辑,若实际交易需要区分开平(尤其是平今/平昨),可基于自身需求对算法进行个性化修改。
算法状态监控
启动 VeighNa Elite Trader 后,点击主界面右侧中上部分的【算法】标签页,即可看到算法状态监控组件。
该组件用于记录已启动算法的详细信息,包括:名称、本地代码、方向、开平、价格、总数量、成交量、剩余量、成交均价、状态、参数以及变量。每行最左侧还嵌入了两个控制单个算法状态的按钮(【暂停】与【停止】),便于对单个算法进行精细化控制。
算法状态
一个算法具有运行、暂停、停止和结束四种状态,分别对应四种枚举值:
| 状态 | 枚举值 | 触发场景 |
|---|---|---|
| 运行 | RUNNING | 算法启动时进入运行状态 |
| 结束 | FINISHED | 算法因完成任务主动结束(计时到了、成交量满足条件等) |
| 暂停 | PAUSED | 算法被用户手动暂停 |
| 停止 | STOPPED | 算法被用户手动停止(被动结束) |
这与 CHANGELOG.md 中“增加状态枚举值,算法支持暂停和恢复运行”的演进记录相互印证。
算法控制按钮
算法启动后,该算法信息行最左侧的【停止】和【暂停】按钮均处于可点击状态。若算法主动结束(FINISHED),该行最左侧的两个按钮区域会变灰(不可点击)。
暂停算法
若想暂停算法的执行,点击【暂停】按钮,此时原【暂停】按钮上的文字会变为**“恢复”**,算法进入 PAUSED 状态,不再发出新的委托。
恢复算法
点击【恢复】按钮可恢复已暂停算法的执行,此时按钮文字重新变回**“暂停”**,算法继续按照既定逻辑委托。
停止算法
点击【停止】按钮可停止运行中的算法,算法进入 STOPPED 状态,该行最左侧的两个按钮区域随之变灰(不可点击)。
五种内置算法详解
目前【算法交易】组件内置了以下五种算法,均基于最新 Tick 推送的行情进行判断与委托:
TWAP - 时间加权平均算法
时间加权平均算法(Time Weighted Average Price)的具体执行步骤如下:
- 将委托数量平均分布在某个时间区域内,每隔一段时间用指定的价格挂出买单(或卖单);
- 买入情况:卖一价低于目标价格时发出委托,委托数量取剩余委托量与委托分割量中的最小值;
- 卖出情况:买一价高于目标价格时发出委托,委托数量取剩余委托量与委托分割量中的最小值。
TWAP 是最适合大单分拆的入门算法。以 docs/elite/strategy/elite_algotrading.md 中的示例为例:买入 20 手沪深 300 股指期货 2409 合约(IF2409),执行价格 3422 元,执行时间 120 秒,每轮间隔 6 秒——即每 6 秒当合约卖一价小于等于 3422 时,以 3422 的价格买入 1 手,将买入操作分割成 20 次。
Iceberg - 冰山算法
冰山算法(Iceberg)的核心思路是在某个价位挂单,但只挂出总量的一部分,其余部分隐藏,直到全部成交:
- 买入情况:先检查撤单——最新 Tick 卖一价低于目标价格时执行撤单;若无活动委托,则发出委托,委托数量取剩余委托量与挂出委托量中的最小值;
- 卖出情况:先检查撤单——最新 Tick 买一价高于目标价格时执行撤单;若无活动委托,则发出委托,委托数量取剩余委托量与挂出委托量中的最小值。
冰山算法通过控制盘口可见挂单量,避免大额挂单暴露在盘口吸引跟风盘,适合对盘口暴露敏感的品种。
Sniper - 狙击手算法
狙击手算法(Sniper)的思路是监控最新 Tick 推送的行情,发现好价格立刻报价成交:
- 买入情况:最新 Tick 卖一价低于目标价格时发出委托,委托数量取剩余委托量与卖一量中的最小值;
- 卖出情况:最新 Tick 买一价高于目标价格时发出委托,委托数量取剩余委托量与买一量中的最小值。
Sniper 不主动拆单,而是等待对手盘出现优于目标价格的价格时一次性吃掉盘口挂单量,适合行情波动中寻找被动成交机会。
Stop - 条件委托算法
条件委托算法(Stop)属于突破触发型委托,监控最新 Tick 行情,发现行情突破立刻报价成交:
- 买入情况:Tick 最新价高于目标价格时发出委托,委托价 = 目标价格 + 超价;
- 卖出情况:Tick 最新价低于目标价格时发出委托,委托价 = 目标价格 - 超价。
该算法的核心价值在于突破确认后的快速跟进,超价参数用于保证委托能够进入成交队列(避免因价格跳动导致排队过深)。
BestLimit - 最优限价算法
最优限价算法(BestLimit)的思路同样是监控最新 Tick 行情,发现好价格立刻报价成交,但报价始终跟随盘口最优价:
- 买入情况:先检查撤单——最新 Tick 买一价不等于目标价格时执行撤单;若无活动委托,则发出委托,委托价格为最新 Tick 买一价,委托数量为剩余委托量;
- 卖出情况:先检查撤单——最新 Tick 买一价不等于目标价格时执行撤单;若无活动委托,则发出委托,委托价格为最新 Tick 卖一价,委托数量为剩余委托量。
BestLimit 始终以对手盘的最优一档价格报价,追求即时成交概率最大化,同时通过撤单逻辑确保报价与目标价格保持一致。
多账户支持
VeighNa Elite Trader 的算法委托执行模块提供了多账户批量下单交易支持(手动),允许同时登录最多 5 个交易账户。
加载
以登录 CTP 接口为例,加载多账户的完整流程如下:
- 在登录界面下方的【交易接口】标签页的下拉框中先选中 CTP 接口;
- 在“自定义接口”处填写自定义的接口名(例如“CTP1”“CTP2”)之后点击【添加】按钮;
- 填写子账户的配置信息,点击【确定】按钮,即可依次加载对应账户的接口;
- 添加完毕后,点击登录界面的【登录】按钮登录 VeighNa Elite Trader;
- 在菜单栏中依次点击【系统】→【连接 xxx】(xxx 为自定义接口名,若加载时填写“CTP1”,则菜单栏显示【连接CTP1】),即可连接子账户接口;
- 连接成功以后,主界面【日志】组件会立刻输出登录相关信息,同时可以看到对应的账号信息、持仓信息等相关信息。
连接完成后,即可在【市场深度交易】(或【快速交易】)界面通过指定的账户进行手工委托。多账户加载的通用流程还可参考 docs/elite/info/elite_trader.md 中“多账户支持”一节的说明。
算法下单
若需通过【算法交易】组件进行多账户委托:
- 在创建的图表左上角选择账户对应的【接口】,再启动算法,即可让算法引擎把拆单后的委托通过指定接口发出;
- 发出委托后,可以在主界面【算法】、【委托】和【成交】组件上跟踪到根据对应接口下单的委托,逐账户核对执行情况。
请注意:目前支持同时登录最多 5 个交易账户,超过该数量将无法正常加载。
结合源码理解执行体系
以下仓库证据有助于深入理解算法交易的底层运行机制:
- 方向与开平枚举定义:vnpy/trader/constant.py 中定义了
Direction(多/空/净)与Offset(开/平/平今/平昨)枚举,算法配置界面中的“方向”“开平”下拉框取值直接来源于此; - 委托状态机:同一文件 constant.py 中的
Status枚举定义了提交中、未成交、部分成交、全部成交、已撤销、拒单六种委托状态,算法拆分出的每笔委托在【委托】【成交】组件中的流转均以此为依据; - 模块演进:CHANGELOG.md 记录了算法交易模块从 VeighNa Trader 剥离至独立
vnpy_algotrading项目、移除套利/网格算法、支持状态枚举与暂停恢复、限定单合约执行等关键变更,可据此理解当前五种算法均为“纯执行类”算法的设计取向; - 功能对照:docs/community/app/algo_trading.md 是社区版 VeighNa Trader 中算法交易模块的完整文档,包含脚本加载方式(
from vnpy_algotrading import AlgoTradingApp后main_engine.add_app(AlgoTradingApp))、CSV 批量启动与数据监控说明,可作为理解 Elite 版本算法引擎的补充材料。
常见注意事项
- 先连接口再启动模块:启动算法前请先连接交易接口,并确认主界面【日志】栏输出“合约信息查询成功”后再启动算法,否则算法可能因缺少合约信息而无法正常委托;
- IB 接口特例:IB 接口登录时无法自动获取所有合约信息,只有用户手动订阅行情时才能获取,因此需先在主界面手动订阅合约行情再启动算法模块;
- 开平方向:部分内置示例算法(如 Sniper、Stop 等)未实现开平判断,期货交易涉及平今/平昨时需自行扩展算法逻辑;
- 账户数量上限:多账户场景下最多同时登录 5 个交易账户,超出上限将无法正常加载;
- 算法数量限制:当前算法引擎按单合约执行设计,若需对同一合约并发运行多个算法,可通过分别启动算法实例实现。