Excel RTD 报价与下单使用说明

MC中国版支持 Excel RTD 报价与下单使用说明

1 支持的 Excel 版本 & 产品版本

Excel版本：

32位：Microsoft office 2013或以上版

64位：Microsoft office 2013或以上版

MC产品版本：

MC12中国版、MC14专策版

2 使用前，设定加载项/增加权限

(1)使用之前，需联系业务MC小姐姐加Excel使用权限

(2)设定Excel加载项

① 需要透过 Excel 加载项，把 TC_Excel_Addin_2.xll 设定启用。

（若是64位EXCEL，需要加载对应的TC_Excel_Addin_2_64.xll，32位则是TC_Excel_Addin_2.xll，注意对应的是EXCEL的位数）

加载项位置有变更，请使用新路径：C:\MCTrader12\APPs\Excel 路径下的加载项元件（需要搭配新的对应EXCEL位数的交易模板：2_Demo_MC12_Excel_RTD-AutoTrade_32bit_v2.xls或者

2_Demo_MC12_Excel_RTD-AutoTrade_64bit_v2.xls）；

3 报价连接

在 MCTrader 上有一个， Excel 图标按钮，可以启动 RTD 实时数据传输（注意，excel 需要先激活，才可以传输RTD数据）。

4 交易模板

文件：新增MC12模板

2_Demo_MC12_Excel_RTD-AutoTrade_32bit_v2.xls

2_Demo_MC12_Excel_RTD-AutoTrade_64bit_v2.xls

含有：

下单、删单模块，委成回模块。

详细参数，可以阅读：1_Excel_Addin_Readme.txt 或本文第6章 VBA代码说明

注：

1、请根据使用的EXCEL位数，对应选取模板文件。

2、由于同时支持多个MC产品版本，VBA代码的函数有变更，请先阅读说明和模板代码再使用Excel的下单、回报模块。

3、回报的部分，也可以打开 MCTrader 上的交易总管，对比查看。

5 常见问题

(1)下单错误代码表：

错误代码	含义	备注
-1001	下单账号未登入，或账号错误
-11	买卖别错误
-12	复式单商品代码解析错误
-13	下单账号，不可下此交易所商品
-14	下单错误，不支持的价格或OrderType或TimeInForce
-20	交易连线未建立
-22	下单价格不是ticksize 的倍数
-23	下单数量不对
-24	下单数量不是最小单位的倍数
-25	价格小于0
1	委托成功
Error:Fail to connect System.	会员账号没有使用 Excel 的权限，需请技术支持开通。或者对应的MC产品没有开启。
-99	商品代码错误

(2)Excel 复制的报价不跳动：

Excel 文件关闭后，又快速开启，可能会出现复制好的 RTD 代码不跳动，建议不要在关闭后，快速打开。

(3)Excel 模板中 委成回 RTD 栏位“-”有意义：

这个栏位的值是：

=RTD("irtdq",,"System","MCTrader","45c48cce2e2d7fbdea1afc51c7c6ad26","C:\\MCTrader\\APPs\\EXCEL\\")

表示：Excel 透过 RTD 方式，从 MCTrader 获取行情和交易权限，不可擅自更改。

6 VBA代码说明

1. #PlaceOrder 下单

列表

说明

备注

功能

PlaceOrder 下单

代码

Private Declare Function PlaceOrderVB2 Lib "TC_Excel_Addin_2.xll" (ByVal ProductType As Integer, ByVal OrderInfo As String) As String

返回值

"1"	代表成功
"-11"	买卖别错误
"-12"	复式单商品代码解析错误
"-13"	下单账号，不可下此交易所商
"-14"	下单错误，不支持的价格或O
"-20"	交易连线未建立
"-22"	下单价格不是ticksize 的倍数
"-23"	下单数量不对
"-24"	下单数量不是最小单位的倍
"-25"	价格小于0
"-99"	商品代码错误
"-1001"	下单账号未登入，或账号错误
"Error:Fail to connect System."	会员账号没有使用 Excel 的权限，需请技术支持开通。或者对应的MC产品没有开启。

参数

(1)ProductType:产品代码

'%SystemName%=%ProductType%

1	MC14 专策版，MCTrader14
2	MC12 中国版，MCTrader12
3	光大金阳光智慧MC，MCTraderGDA

(2)OrderInfo:下单讯息,由下列参数组成

TYPE	F:Future,期货 S:Stock,证券 O:Option,期货期权，个股期权
ACCOUNT	交易帐号格式：BrokerID-账号，如：XX期货商的BrokerID是66666，资金账号是123，则写入：66666-123
SYMBOL	交易商品代码格式：期货:TC.F.交易所.商品.合约月份证券:TC.S.交易所.证券代码期权C:TC.O.交易所.商品.合约月份.C.行权价期权P:TC.O.交易所.商品.合约月份.P.行权价举例： TC.F.SHFE.ag.201905 TC.S.SSE.601788 TC.O.DCE.m.202001.C.2900 TC.O.DCE.m.202001.P.2900
ORDERTYPE	委托别 1:Market,市价 2:Limit,限价 3:Stop,停损价 4:Stop Limit,停损限价 20:BSR,最优价 21:BSTL,最优价转限价 22:5LvlMKT,五档市价 23:5LvlMTL,五档市价转限价 24:MTL,市价转限价
SIDE	买卖别 1:Buy,买入 2:Sell,卖出
PRICE	限价价格
STOPPRICE	停损价格
ORDERQTY	委托数量期货：手数，1 表示 1手期权：手数，1 表示 1手股票/基金：股数，100 表示 100股债券：张数，10 表示 10 张
USERKEY1	自定义，同步展示在交易总管的策略ID栏位
USERKEY2	自定义
POSITIONEFFECT	仓别 0: Open 1: Close 2: 平今 3: 平昨 4: 自动单
TIMEINFORCE	委托单有效期 1: Rod 2: IOC \| FAK 3: FOK

2.#CancelOrder 删单

列表

说明

备注

功能

CancelOrder 删单

代码

Private Declare Function CancelOrderVB2 Lib "TC_Excel_Addin_2.xll" (ByVal ProductType As Integer, ByVal OrderInfo As String) As String

返回值

"1" 代表成功

参数

(1)ProductType:产品代码

'%SystemName%=%ProductType%

1	MC14 专策版，MCTrader14
2	MC12 中国版，MCTrader12
3	光大金阳光智慧MC，MCTraderGDA

(2)OrderInfo:下单讯息,由下列参数组成

REPORTID 委托单号： ReportID

3.#GetOrderStatusStringVB 回报内容

列表

说明

备注

功能

CancelOrder 删单

代码

Private Declare Function GetOrderStatusStringVB2 Lib "TC_Excel_Addin_2.xll" (ByVal ProductType As Integer, ByVal ReportID As String, ByVal Field As String) As String

返回值

回传ReportID的栏位(Field)内容。

若 ReportID 为 "ReportReset"，可取得当下所有 ReportID，格式为 %ReportID1%;%ReportID2%;

参数

(1)ProductType:产品代码

'%SystemName%=%ProductType%

1	MC14 专策版，MCTrader14
2	MC12 中国版，MCTrader12
3	光大金阳光智慧MC，MCTraderGDA

(2) ReportID:委托单号

格式为 %ReportID1%;%ReportID2%;

(3) Field参数

Account	交易帐号
ReportID	ReportID
OrderID	单号
Exchange	交易所
Security	商品
Month	月份
SecurityType	F:Future S:Stock O:Option
Side	1:Buy 2:Sell
OrderQty	下单数量
TIMEINFORCE	1: Rod 2: IOC \| FAK 3: FOK
POSITIONEFFECT	0: Open 1: Close 2: 平今 3: 平昨 4: 自动单
CumQty	成交数量
AvgPrice	成交均价
ExecType	状态， 0: 委托成功 1: 部分委托成功其余处理中 2: 部分委托成功其余错误 3: 全部成交 4: 部分成交其馀委托处理中 5: 部分成交其馀删单 6: 部分成交尚有有效单 7: 部分成交其馀错误 8: 完全删单成功 9: 部分删单成功 10: 委托失败 11: 委托处理中 12: 删改单错误 15: 等待中，不可撤单
ExecTypeText	状态描述
TransactDate	日期
TransacttTime	时间(GMT+0)
USERKEY1	自定义
USERKEY2	自定义