ExcelRtd - EXCEL RTD模块¶
功能简介¶
ExcelRtd是用于在Excel中访问VeighNa程序内任意数据信息的功能模块, RTD全称是RealTimeData,是微软提供的主要面向金融行业中实时数据需求设计的Excel数据对接方案。ExcelRtd依赖于PyXLLC模块(www.pyxll.com),该模块属于商业软件,需要购买才能使用(提供30天免费使用)。
安装PyXLL¶
为了使用ExcelRtd模块,需要安装PyXLL插件。步骤如下:
首先进入PyXLL官网,点击DownloadPyXLL,如下图所示:
接着跳转到下载界面,如下图所示:
这时需要填写相应字段,其中Python Version选择Python3.10,而Excel Version则根据自己安装的Excel版本选择,一般为64bit(x64)。
填写完之后点击【Download PyXLL】,就会跳转到下载页面。将文件下载好之后,进入放置该文件的文件夹,按住shift键并且点击鼠标右键,选择【在此处打开PowerShell窗口】,运行以下命令:
pip install pyxll
pyxll install
接着按照软件要求就能成功安装了。
请注意,在执行到下图这一步时:
如果没有具体指定路径,会安装到图中的默认位置(因为后面还需要进入这个文件夹,所以请记住这个路径)。
接着进入该目录下的examples目录,并把路径~/veighna_studio/Lib/site-packages/vnpy_excelrtd/下的vnpy_rtd.py放入该目录,如下图所示:
如此就算正式安装完成了。
加载启动¶
VeighNa Station加载¶
启动登录VeighNa Station后,点击【交易】按钮,在配置对话框中的【应用模块】栏勾选【ExcelRtd】。
脚本加载¶
在启动脚本中添加如下代码:
# 写在顶部
from vnpy_excelrtd import ExcelRtdApp
# 写在创建main_engine对象后
main_engine.add_app(ExcelRtdApp)
启动模块¶
在启动模块之前,请先连接交易接口(连接方法详见基本使用篇的连接接口部分)。看到VeighNa Trader主界面【日志】栏输出“合约信息查询成功”之后再启动模块,如下图所示:
请注意,IB接口因为登录时无法自动获取所有的合约信息,只有在用户手动订阅行情时才能获取。因此需要在主界面上先行手动订阅合约行情,再启动模块。
成功连接交易接口后,在菜单栏中点击【功能】 -> 【Excel RTD】,或者点击左侧按钮栏的图表:
即可进入Excel RTD模块的UI界面,如下图所示:
功能和配置¶
基础应用¶
在启动Excel RTD模块后,即可在Excel表格中通过PyXll调用该模块提供的功能(主要是通过rtd_tick_data函数获取实时数据)。
首先打开一个excel表格,并且在每个单元格中调用rtd_tick_data函数并传入相应参数则可获取对应的数据,如下图所示:
上图是获取豆油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模块的图形界面中也能看到相应输出,如下图所示: