ExcelRtd - EXCEL RTD模块

功能简介

ExcelRtd是用于在Excel中访问VeighNa程序内任意数据信息的功能模块, RTD全称是RealTimeData,是微软提供的主要面向金融行业中实时数据需求设计的Excel数据对接方案。ExcelRtd依赖于PyXLLC模块(www.pyxll.com),该模块属于商业软件,需要购买才能使用(提供30天免费使用)。

安装PyXLL

为了使用ExcelRtd模块,需要安装PyXLL插件。步骤如下:

首先进入PyXLL官网,点击DownloadPyXLL,如下图所示:

https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/excel_rtd/excel_rtd_0.png

接着跳转到下载界面,如下图所示:

https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/excel_rtd/13.png

这时需要填写相应字段,其中Python Version选择Python3.10,而Excel Version则根据自己安装的Excel版本选择,一般为64bit(x64)。

填写完之后点击【Download PyXLL】,就会跳转到下载页面。将文件下载好之后,进入放置该文件的文件夹,按住shift键并且点击鼠标右键,选择【在此处打开PowerShell窗口】,运行以下命令:

pip install pyxll
pyxll install

接着按照软件要求就能成功安装了。

请注意,在执行到下图这一步时:

https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/excel_rtd/excel_rtd_9.png

如果没有具体指定路径,会安装到图中的默认位置(因为后面还需要进入这个文件夹,所以请记住这个路径)。

接着进入该目录下的examples目录,并把路径~/veighna_studio/Lib/site-packages/vnpy_excelrtd/下的vnpy_rtd.py放入该目录,如下图所示:

https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/excel_rtd/excel_rtd_5.png

如此就算正式安装完成了。

加载启动

VeighNa Station加载

启动登录VeighNa Station后,点击【交易】按钮,在配置对话框中的【应用模块】栏勾选【ExcelRtd】。

脚本加载

在启动脚本中添加如下代码:

# 写在顶部
from vnpy_excelrtd import ExcelRtdApp

# 写在创建main_engine对象后
main_engine.add_app(ExcelRtdApp)

启动模块

在启动模块之前,请先连接交易接口(连接方法详见基本使用篇的连接接口部分)。看到VeighNa Trader主界面【日志】栏输出“合约信息查询成功”之后再启动模块,如下图所示:

https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/cta_strategy/1.png

请注意,IB接口因为登录时无法自动获取所有的合约信息,只有在用户手动订阅行情时才能获取。因此需要在主界面上先行手动订阅合约行情,再启动模块。

成功连接交易接口后,在菜单栏中点击【功能】 -> 【Excel RTD】,或者点击左侧按钮栏的图表:

https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/excel_rtd/excel_rtd_6.png

即可进入Excel RTD模块的UI界面,如下图所示:

https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/excel_rtd/15.png

功能和配置

基础应用

在启动Excel RTD模块后,即可在Excel表格中通过PyXll调用该模块提供的功能(主要是通过rtd_tick_data函数获取实时数据)。

首先打开一个excel表格,并且在每个单元格中调用rtd_tick_data函数并传入相应参数则可获取对应的数据,如下图所示:

https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/excel_rtd/14.png

上图是获取豆油2205四个字段实时数据(分别是bid_price_1、high_price、low_price以及last_price)的例子。

从图中可以看出rtd_tick_data函数需要两个参数:一个是vt_symbol,另一个是VeighNa中定义的TickData的属性(具体属性可参考源代码vnpy.trader.object.TickData)。这两个参数都是字符串,第一个参数可以通过单元格的具体位置指定,比如“A1”表示A列第1行的数据。

与此同时,在Excel RTD模块的图形界面中也能看到相应输出,如下图所示:

https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/excel_rtd/16.png

进阶应用

当然,上面只是简单的展示了ExcelRtd模块的功能。至于具体获取哪些数据,以什么样的方式展示在excel上,则由用户根据自己的实际需求编写。这里提供几个进阶的案例,包括期货市场报价跟踪、市场深度行情跟踪以及价差监控:

期货市场报价跟踪

https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/excel_rtd/excel_rtd_10.png

市场深度行情跟踪

https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/excel_rtd/excel_rtd_11.png

价差监控

https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/excel_rtd/excel_rtd_12.png