VeighNa Trader 图形化交易终端完整指南:启动、连接、委托交易与全局配置

原创2026-09-18 12:32:412,502 阅读
文章标签:金融科技桌面应用机器学习数据可视化后端

VeighNa Trader 图形化交易终端完整指南:启动、连接、委托交易与全局配置

VeighNa Trader 是 vnpy 开源量化交易平台提供的图形化交易终端(GUI),它将事件引擎、主引擎(MainEngine)、各类交易接口(Gateway)与功能应用(App)整合进一套桌面界面,覆盖从连接行情、合约查询、手动下单到持仓资金监控的完整交易流程。本文以仓库文档 docs/community/info/veighna_trader.md 为主线,结合 vnpy/trader 源码实现,系统讲解 VeighNa Trader 的启动方式、SimNow 仿真连接、行情订阅、委托交易、数据监控组件与全局配置,帮助读者快速上手并理解界面背后的引擎架构。

启动程序

VeighNa Trader 提供两种启动方式:图形模式与脚本模式,两者共用同一套 MainEngine + MainWindow 架构,差异仅在于入口形式。

图形模式(VeighNa Station)

登录 VeighNa Station 后,点击【交易】按钮,在启动界面中勾选所需的交易接口(Gateway)和应用模块(App),点击【启动】按钮即可进入 VeighNa Trader。图形模式下,接口与应用的选择通过界面完成,无需编写代码,适合日常手动交易与功能验证。

脚本模式(run.py)

脚本模式适合需要自定义接口组合或二次开发的用户。在源码仓库的 examples/veighna_trader/ 目录下找到 run.py(注意:是 GitHub 源码包中的示例,而非 VeighNa Studio 内置目录),运行该文件即可进入 VeighNa Trader。

以 Windows 10 为例,在 run.py 所在文件夹内按住【Shift】并点击鼠标右键,选择【在此处打开 PowerShell 窗口】,然后在弹出的终端中输入:

python run.py

run.py 的核心逻辑展示了 VeighNa Trader 的组装过程(examples/veighna_trader/run.py):

from vnpy.event import EventEngine
from vnpy.trader.engine import MainEngine
from vnpy.trader.ui import MainWindow, create_qapp

from vnpy_ctp import CtpGateway
from vnpy_ctastrategy import CtaStrategyApp
from vnpy_ctabacktester import CtaBacktesterApp
from vnpy_datamanager import DataManagerApp


def main():
    qapp = create_qapp()                    # 创建 Qt 应用
    event_engine = EventEngine()            # 事件引擎
    main_engine = MainEngine(event_engine)  # 主引擎

    main_engine.add_gateway(CtpGateway)     # 注册交易接口
    main_engine.add_app(CtaStrategyApp)     # 注册功能应用
    main_engine.add_app(CtaBacktesterApp)
    main_engine.add_app(DataManagerApp)

    main_window = MainWindow(main_engine, event_engine)
    main_window.showMaximized()
    qapp.exec()


if __name__ == "__main__":
    main()

从源码可以看出,终端启动的实质是:

  1. 创建 Qt 应用对象 qapp(由 vnpy.trader.ui 的 create_qapp 提供);
  2. 创建事件引擎 EventEngine 与主引擎 MainEngine;
  3. 通过 add_gateway() 注册交易接口(如 CTP),通过 add_app() 注册功能应用(如 CTA 策略、回测、数据管理等);
  4. 实例化 MainWindow 主窗口并全屏显示。

示例中默认启用了 CtpGateway、CtaStrategyApp、CtaBacktesterApp 和 DataManagerApp,其余接口(如 vnpy_mini、vnpy_ib、vnpy_tts)与应用(如 SpreadTradingApp、AlgoTradingApp、RiskManagerApp)均以注释形式给出,按需取消注释并安装对应扩展包即可启用。注意 MainWindow 的标题会显示当前 VeighNa 版本号与运行时目录(vnpy/trader/ui/mainwindow.py),例如 VeighNa Trader 社区版 - 3.x.x [C:\Users\...\.vntrader]。

启动成功后,主界面默认布局如下(对应 mainwindow.py 的 init_dock):左侧为【交易】组件,右侧依次为【行情】【委托】【活动】(活动与委托以标签页形式堆叠)、【成交】,底部为【日志】【资金】【持仓】组件。

连接交易接口

以 SimNow 仿真登录 CTP 为例

在 VeighNa Trader 菜单栏点击【系统】->【连接CTP】,会弹出账号配置窗口。该窗口由 ConnectDialog 实现(vnpy/trader/ui/widget.py):它读取网关的 default_setting 动态生成表单,并将用户输入保存到运行时目录下的 connect_ctp.json,下次打开时会自动回填上次的配置。

使用 SimNow 仿真交易账号登录 CTP 时,各字段填写要求如下:

  • 用户名:xxxxxx(6 位纯数字账号,即 InvestorID)
  • 密码:xxxxxx(需要先修改一次密码用于盘后测试)
  • 经纪商代码:9999(SimNow 默认经纪商编号)
  • 交易服务器:180.168.146.187:10202(盘中测试)
  • 行情服务器:180.168.146.187:10212(盘中测试)
  • 产品名称:simnow_client_test
  • 授权编码:0000000000000000(16 个 0)

请注意:用户名需填写 InvestorID(6 位纯数字),而不是 SimNow 网站注册时的账号(手机号);此外,SimNow 注册的账号需要修改一次密码后才能登录。

连接成功以后,VeighNa Trader 主界面【日志】组件会立刻输出登录相关信息,同时用户可以在【资金】和【持仓】组件中看到账号信息、持仓信息,并通过【合约查询】功能检索合约。连接过程背后,MainEngine.connect() 会调用对应网关的 connect() 方法发起与柜台系统的会话,并将登录状态以事件形式推送回界面。

关于 IB 等特殊接口

对于 Interactive Brokers(IB)等接口,登录时无法自动获取全部合约信息,只有在用户手动订阅行情后才能获取对应合约。因此使用这类接口时,需要先在主界面手动订阅合约行情,才能查询到合约信息。

合约查询

成功连接交易接口后,点击菜单栏的【帮助】->【查询合约】,在弹出的对话框中直接点击右上角的【查询】按钮即可查询合约信息;查询条件留空时,将查询所有合约的价格信息。该功能由 ContractManager 实现,通过主引擎向已连接的网关发起合约查询请求,并把返回结果以表格形式展示。

合约查询结果中的代码是后续所有操作的基础——订阅行情、下单时输入的合约代码必须与查询到的一致(如 IF2206.CFFEX 这类包含交易所后缀的完整格式,参见下文)。

订阅行情

在左侧【交易】组件中输入交易所和合约代码,按回车键即可订阅行情。例如订阅股指期货时,交易所填写 CFFEX,代码填写对应的合约代码 IF2206。

订阅成功后,交易组件会显示合约名称,并在下方显示深度行情报价(最新价、买一价、卖一价等),【行情】组件会同步显示最新行情信息。从源码看,交易组件订阅了 EVENT_TICK 事件(widget.py),收到与当前 vt_symbol 匹配的 Tick 数据后更新最新价、五档买卖价与量,并根据昨收价计算涨跌幅。交易所枚举在 vnpy/trader/constant.py 中定义,包括 CFFEX、SHFE、CZCE、DCE、INE、GFEX 等国内交易所,以及 SSE、SZSE 等股票交易所。

委托交易

【交易】组件用于手动发起委托,除交易所和合约代码外,还需填写五个字段:方向、开平、类型、价格和数量。对应源码中 TradingWidget 的控件布局(widget.py):

  • 方向:多 / 空(Direction 枚举,见 constant.py)
  • 开平:开 / 平 / 平今 / 平昨(Offset 枚举)
  • 类型:限价 / 市价等(OrderType 枚举)
  • 价格:委托价格
  • 数量:委托数量

操作要点:

  • 若委托类型为市价单,委托价格可不填;
  • 若交易接口只支持单向持仓(接口持仓方向支持详见交易接口文档),可不填写开平方向;
  • 价格输入框带数值校验器,数量与价格均须为非负数。

发出委托后,本地会缓存委托相关信息,并显示到【委托】组件和【活动】组件,此时委托状态为【提交中】(对应 Status.SUBMITTING)。交易所收到委托后会将其插入中央订单簿进行撮合成交,并推送委托回报:

  • 若委托还未成交,【委托】和【活动】组件只更新时间和委托状态两个字段,状态变为【未成交】(NOTTRADED);
  • 若委托立刻成交,委托信息会从【活动】组件移除、新增至【成交】组件,状态变为【全部成交】(ALLTRADED)。

委托状态完整枚举见 constant.py:提交中、未成交、部分成交、全部成交、已撤销、拒单。此外,交易组件还提供【全撤】按钮一键撤销全部活动委托。

数据监控

数据监控由多个监控组件构成,并附带两个辅助功能:选中任一组件后,鼠标右键可以选择【调整列宽】(特别适用于屏幕分辨率较低的情况),或者选择【保存数据】(导出为 CSV 格式)。这两项功能由监控组件的基类 BaseMonitor 实现(widget.py),保存数据通过 QFileDialog 选择 CSV 输出路径。

各组件功能如下:

行情组件

用于对已订阅的行情进行实时监控,监控内容包括:

  • 合约信息:合约代码、交易所、合约名称;
  • 行情信息:最新价、成交量、开盘价、最高价、最低价、收盘价、买 1 价、买 1 量、卖 1 价、卖 1 量;
  • 其他信息:数据推送时间、接口。

活动组件

用于存放还未成交的委托,如限价单或没有立刻成交的市价单。在该组件中鼠标双击任一委托即可完成撤单操作。主窗口中【活动】与【委托】以标签页形式堆叠(tabifyDockWidget),便于切换查看。

成交组件

用于存放已成交的委托。该组件中的价格、数量和时间都是交易所推送过来的成交信息,而不是委托信息——例如一笔大委托发生多次部分成交时,成交组件会记录每一笔撮合回报。

委托组件

用于存放用户发出的所有委托信息,委托状态可为提交中、已撤销、部分成交、全部成交、拒单等。它是委托全生命周期的完整记录。

持仓组件

用于记录历史持仓,需要注意以下字段:

  • 方向:期货品种具有多空方向(多/空),而股票品种方向为【净】(NET)持仓;
  • 数量:总持仓,即今仓 + 昨仓;
  • 昨仓:其出现衍生于上期所特有的平今、平昨模式的需要;
  • 均价:历史成交的平均价格(某些巨型委托会发生多次部分成交,需要计算平均价格);
  • 盈亏:持仓盈亏。多仓情况下,盈利 = 当前价格 - 均价,空仓则反之。

若平仓离场,持仓数量清零,浮动盈亏变成实际盈亏从而影响账户余额变化,因此数量、昨仓、冻结、均价、盈亏这些字段均变为 0。主窗口将持仓组件的双击事件与交易组件联动:双击某一行持仓,可自动把该合约填入交易组件准备下单(mainwindow.py)。

资金组件

显示账户的基础信息,需要注意三个字段:

  • 可用资金:可以用于委托的现金;
  • 冻结:委托操作冻结的金额(与保证金不是一个概念);
  • 余额:总资金,即可用资金 + 保证金 + 浮动盈亏。

若全部平仓,浮动盈亏变成实际盈亏,保证金和浮动盈亏清零,总资金等于可用资金。

日志组件

用于显示接口登录信息以及委托报错信息,是排查连接与交易问题的重要入口。

应用模块

VeighNa 官方提供了开箱即用的量化交易应用模块。在启动 VeighNa Trader 时勾选所需的功能模块(如 CTA 策略、回测、数据管理等),启动成功后在菜单栏点击【功能】按钮,即可显示所勾选的功能模块。

从源码看,【功能】菜单是动态生成的(mainwindow.py):主引擎遍历所有已注册的 BaseApp,通过反射导入每个 App 的 UI 模块并实例化对应控件。因此菜单中出现的模块完全取决于启动时 add_app() 注册了哪些应用,社区版常用的包括 CTA 策略(vnpy_ctastrategy)、回测(vnpy_ctabacktester)、数据管理(vnpy_datamanager)、价差交易(vnpy_spreadtrading)、算法交易(vnpy_algotrading)、脚本交易(vnpy_scripttrader)、风险管理(vnpy_riskmanager)等,对应文档可见 docs/community/app/ 目录。

全局配置

点击 VeighNa Trader 菜单栏上的【配置】按钮,弹出【全局配置】窗口。该窗口编辑的是运行时目录下的 vt_setting.json 文件(SETTING_FILENAME),所有配置项的默认值定义在 vnpy/trader/setting.py 的 SETTINGS 字典中,程序启动时会用 vt_setting.json 中保存的值覆盖默认值。若用户目录下不存在 .vntrader 文件夹,程序会自动创建(vnpy/trader/utility.py),主引擎启动后也会将工作目录切换到该目录(engine.py)。

GUI 界面

  • font.family:设置 VeighNa Trader 图形界面的字体类型。当前仓库源码中的默认值为 微软雅黑,同时也支持 Courier New、System 等字体;
  • font.size:设置图形界面的字体大小,用户可以根据自己显示器的实际分辨率进行调整(源码默认值为 12)。

日志输出

log.active、log.level、log.console 和 log.file 用于配置日志输出:

  • log.active:控制是否启动 LogEngine,默认为 True。如果改为 False,则后续几项参数都将失效,VeighNa Trader 运行时不再输出日志或生成日志文件(可以降低部分系统延时);
  • log.level:控制日志输出级别。日志从轻到严重分为 DEBUG、INFO、WARNING、ERROR、CRITICAL 五个级别,分别对应整数值 10、20、30、40、50(与 Python 标准 logging 模块一致)。日志等级低于该项设置值的将会被忽略;如果想要记录更详细的系统运行信息,建议将该项整数值调低。当前源码中的默认值为 CRITICAL(50),即默认只记录最严重的日志;
  • log.console:console 指终端,如 Windows 上的 cmd 和 PowerShell,以及 Linux 上的 Terminal。当设置为 True 时,通过终端运行脚本(需要注册日志事件监听)启动 VeighNa Trader,日志信息会输出在终端中;如果通过 VeighNa Station 直接启动,则无 console 输出;
  • log.file:控制是否将日志输出到文件,建议设置为 True,否则无法记录生成的日志。

VeighNa Trader 的日志文件默认位于运行时目录的 .vntrader\log 目录下,完整路径为:

C:\users\administrator\.vntrader\log

其中 administrator 为当前 Windows 系统的登录用户名。该目录由 utility.py 的 get_folder_path 在运行时目录下自动创建。

邮件通知

以 email 为前缀的参数用于配置邮箱,可以在特定事件发生时(如委托成交、数据异常时)发送邮件实时通知。各参数含义如下:

  • email.server:SMTP 邮件服务器地址,默认填写好了 QQ 邮箱服务器地址 smtp.qq.com,可以直接使用;如需使用其他邮箱,需要自行查找对应的服务器地址;
  • email.port:SMTP 邮件服务器端口号,默认值为 465(QQ 邮箱 SSL 端口),可直接使用;
  • email.username:填写邮箱地址即可,如 xxxx@qq.com;
  • email.password:对于 QQ 邮箱,此处不是邮箱密码,而是开通 SMTP 服务后系统生成的授权码;
  • email.sender:发送邮箱名,与 email.username 一致;
  • email.receiver:接收邮件的邮箱地址。

配置完成后,可在【帮助】菜单中点击【测试邮件】验证配置是否生效(对应 MainWindow.send_test_email,mainwindow.py)。

datafeed 数据服务

与数据库适配器类似,数据服务有标准化的接口 BaseDatafeed(位于 vnpy.trader.datafeed,见 vnpy/trader/datafeed.py),实现了灵活的数据服务支持。具体字段含义如下:

  • datafeed.name:数据服务接口的名称,全称的小写英文字母;
  • datafeed.username:数据服务的用户名;
  • datafeed.password:数据服务的密码。

目前支持的数据服务实现包括:XT(迅投)、RQData(米筐)、Udata、TuShare、TQSDK(天勤)、Wind、iFinD(同花顺)、Tinysoft(天软)等,它们以独立扩展包的形式发布(如 vnpy_rqdata、vnpy_tushare、vnpy_wind),按需安装后在全局配置中填写对应服务商账号即可启用,主要用于为 CTA 回测、数据管理等应用补充历史数据下载能力。

数据库

以 database 为前缀的参数用于配置数据库服务。目前 VeighNa 支持 SQLite、MySQL、PostgreSQL、MongoDB、InfluxDB、DolphinDB、Arctic 和 LevelDB 八种数据库,具体配置方法详见项目文档的数据库配置部分(docs/community/info/database.md)。当前源码的默认配置为 sqlite,数据库文件为 database.db,并自动将时区设置为本地时区(setting.py),开箱即用,无需额外部署数据库服务。

附:常用路径与文件速查

用途 路径
脚本模式启动入口 examples/veighna_trader/run.py
全局配置默认值 vnpy/trader/setting.py
主窗口与菜单实现 vnpy/trader/ui/mainwindow.py
交易组件与监控组件实现 vnpy/trader/ui/widget.py
方向/开平/状态/类型等枚举 vnpy/trader/constant.py
运行时目录(.vntrader)逻辑 vnpy/trader/utility.py
主引擎与事件分发 vnpy/trader/engine.py
数据服务接口基类 vnpy/trader/datafeed.py

实际使用中,connect_ctp.json、vt_setting.json 等配置会持久化在 .vntrader 目录下,连接失败的排查应优先查看【日志】组件与 log 目录下的日志文件。至此,读者已可以独立完成 VeighNa Trader 的启动、接口连接、行情订阅、手动交易、数据监控与全局配置,并在此基础上进一步接入 CTA 策略、数据管理等官方应用模块。

登录后查看全文
vnpy