接入重庆电信测速

中信建投期货CTP系统外部接入操作指引根据中国证监会《关于进一步加强期货经营机构客户交易终端信息采集有关事项的公告》(证监会公告[2018]27号)和中国期货市场监控中心《期货公司客户交易终端信息采集及接入认证技术规范》要求,为进一步加强期货市场看穿式监管要求,客户自开发交易软件以及第三方开发的交易软件均需通过期货公司的接入认证,期货公司应审查客户软件功能,测试评估其是否已集成符合监管要求的信息采集动态链接库,是否能够准确采集客户终端信息.
对于符合监管要求的终端软件,期货公司会在交易系统中配置该软件的AppID和授权码,开通准入权限.
根据监管要求,各操作系统需要采集的内容如下:操作系统WindowsLinuxMacOS移动终端ios移动终端Android采集指标信息采集时间私网IP网卡MAC地址设备名操作系统版本硬盘序列号CPU序列号BIOS序列号系统盘分区信息信息采集时间私网IP网卡MAC地址设备名操作系统版本硬盘序列号CPU序列号BIOS序列号信息采集时间私网IP网卡MAC地址设备名操作系统版本硬盘序列号设备序列号信息采集时间移动终端IP地理位置信息操作系统版本设备名设备类型网络运营商通用唯一识别码(UUID)信息采集时间移动终端IP地理位置信息操作系统版本设备名设备类型国际移动设备识别码(IMEI)移动设备识别码(MEID)设备MAC地址手机号码设备序列号国际移动用户识别码(IMSI)IC卡的唯一识别号码(ICCID)特别注意:1、CTP交易系统的授权码与客户交易软件的AppID或RelayAppID绑定,客户交易软件的AppID如果发生改变,需要向期货公司重新申请授权码,在不改变AppID的情况下,客户可以任意更改交易程序、软件功能等内容.
2、用户采集信息由期货公司每日结算后生成加密文件直接报送给中国期货市场监控中心,中国期货市场监控中心共享给期货交易所,期货公司无法获取用户的采集信息.
中信建投期货CTP系统外部接入操作指引CTP主席系统外部接入操作指引一、确定AppID名称和版本号,获取授权码客户填写《中信建投期货有限公司外部接入系统客户情况登记表》,确定AppID名称和版本号,留存获取授权码的联系方式.
个人开发的程序统一命名格式为"client_终端名称_版本号",其中下划线不得更改;终端名称可以是纯英文字母或纯数字或英文字母和数字的组合,英文字母可区分大小写,不能是中文汉字,字段最大为10字节;版本号最大长度为8字节.
我司信息技术部将根据客户的AppID生成CTP评测系统授权码,我部将及时发送给客户,并告知生效日期,该授权码用于接入CTP评测系统、CTP主席正式实盘系统、CTP仿真系统.
二、使用看穿式监管评测版本API接入评测系统进行评测1、登录上期技术官网http://www.
sfit.
com.
cn/5_2_DocumentDown_2.
htm,下载看穿式监管评测版本api(v6.
3.
16_T1),该版本api仅用于接入CTP评测系统;2、评测系统接入参数;评测系统BrokerID:6666中信建投期货CTP系统外部接入操作指引评测系统交易地址:61.
186.
254.
131:42205评测系统行情地址:61.
186.
254.
131:422133、评测系统帐号,仅登录即可;资金帐号:12345678登录密码:CS123456(CS为大写)4、客户完成评测系统登录后,请及时告知我部,为您查询评测结果;5、评测通过认证的范例,通过认证案例如下图:三、通过评测,客户AppID和授权码录入CTP主席系统客户通过评测,待我司录入系统后,可以使用授权码进行接入(获取授权码的下一交易日).
CTP主席系统看穿式监管版互联网接入地址见下表:API接口版本号:v6.
3.
15(下载地址见下文第四条的截图)BrokerID:9080交易端口:42205行情端口:42213中信建投期货CTP系统外部接入操作指引上海电信1180.
153.
15.
150上海电信2180.
153.
15.
146上海电信3101.
231.
128.
133上海移动117.
184.
124.
37广州电信59.
42.
241.
91北京网通1202.
130.
235.
165北京网通2202.
130.
235.
168重庆电信61.
186.
254.
135重庆联通113.
204.
21.
162盘后查询站点D交易日17:00后,可查询D日全部交易数据,周末可查询上一交易日日盘数据180.
166.
25.
21注:表中各站点的行情地址和交易地址相同,除上海电信3以外,其他站点的行情支持上期所、能源中心五档行情.
CTP主席系统看穿式监管版上期张江机房内网接入地址见下表:API接口版本号:v6.
3.
15(下载地址见下文第四条的截图)BrokerID:9080内网地址110.
124.
34.
51交易:42205行情:42213内网地址210.
124.
34.
52交易:42205行情:42213内网地址310.
124.
34.
53交易:42205行情:42213上期二代行情内网服务器地址10.
124.
34.
27行情端口:19213中信建投期货CTP系统外部接入操作指引四、测试环境:CTP仿真系统测试1、为了保障客户接入无误,建议客户在获取授权码后接入CTP仿真系统进行测试验证.
登录上期技术官网http://www.
sfit.
com.
cn/5_2_DocumentDown_2.
htm,下载生产版本api(v6.
3.
1),该版本与我司正式实盘系统版本一致;2、仿真系统接入参数;仿真系统BrokerID:6666仿真系统交易地址:61.
186.
254.
137:33433仿真系统行情地址:61.
186.
254.
137:334353、仿真系统帐号,任选其一;资金帐号:50100267,登录密码:CS123456(CS为大写)资金帐号:50100268,登录密码:CS123456资金帐号:50100282,登录密码:CS123456五、签署协议客户签署《中信建投期货有限公司外部交易系统接入协议》、《中信建投期货有限公司外部接入评测结果确认书》、《中信建投期货有限公司程序化交易客户承诺书》、《中信建投期货有限公司程序化交易系统自测表》.
回寄客户经理地址:上海市浦东新区世纪大道1589号810室.
中信建投期货CTP系统外部接入操作指引CTP次席系统(第三交易中心)外部接入操作指引接入流程和API文件同"CTP主席系统外部接入操作指引".
CTP次席系统(第三交易中心)看穿式监管版互联网接入地址见下表:API接口版本号:v6.
3.
15BrokerID:9080交易端口:42205行情端口:42213电信站点180.
166.
25.
17联通站点27.
115.
57.
105注:CTP次席系统的行情站点不支持上期二代行情,如有需要,可选择连接CTP主席中除上海电信3以外的其他行情站点.
CTP次席系统(第三交易中心)看穿式监管版上期张江机房内网接入地址见下表:API接口版本号:v6.
3.
15BrokerID:9080内网地址10.
124.
34.
1交易:42205行情:42213上期二代行情内网服务器地址10.
124.
34.
27行情端口:19213中信建投期货CTP系统外部接入操作指引CTPmini2系统(第七交易中心)外部接入操作指引接入流程同"CTP主席系统外部接入操作指引".
看穿式监管版本API文件下载:登录上期技术官网http://www.
sfit.
com.
cn/5_2_DocumentDown_4.
htm,下载生产版本api(v1.
4)CTPmini2系统(第七交易中心)看穿式监管版接入地址见下表:API接口版本号:v1.
4BrokerID:9080互联网地址(上期一代行情)接入地址:101.
231.
128.
137交易端口31803,查询端口31804,行情端口31807上期张江机房内网地址接入地址:10.
124.
34.
92交易端口31803,查询端口31804,行情端口:31807上期二代行情内网服务器地址10.
124.
34.
27行情端口:19213中信建投期货CTP系统外部接入操作指引参考1:终端认证调试CTP-Linux1、准备工作版本说明:1、6.
3.
13用于采集客户终端信息,完成客户端的接入认证.
2、6.
3.
15用于仿真环境和生产环境.
由于Linux的发行版众多,不同发行版的GCC/G++编译器的版本和集成度也有一定的区别,但基本编译原理是一致的.
本文将以64位的Ubantu-18.
10做为开发者宿主机环境.
本文中使用的开发IDE为SourceInsight3.
5,需要在宿主机上安装GCC/G++编译器.
如果程序中使用第三方库请自行完善环境及Makefile编译文件.
安装GCC:sudoapt-getinstallgcc安装G++:sudoapt-getinstallg++2、建立项目解决方案说明:CTP6.
3.
13版本和6.
3.
15版本在客户端接入及认证部分是一致的,本文以6.
3.
15版本为例进行说明.
实际上由于客户接入流程的原因,客户自开发程序需要同时拥有两个版本的解决方案.
用户需要先通过6.
3.
13进行客户端数据采集及验证,待期货公司完成数据验证后再通过6.
3.
15版本进行正常交易.
2.
1、建立项目工程打开SourceInsight,创建C/C++工程解决方案.
中信建投期货CTP系统外部接入操作指引2.
2、集成CTPAPI到工程中需要把CTPAPI包拷贝到本地文件系统的工程目录中,拷贝的APIDLL和头文件位于v6.
3.
15_20190220_api_clientdatacollectdll_linux64、v6.
3.
15_20190220_api_tradeapi_se_linux64目录中.
v6.
3.
15_20190220_api_clientdatacollectdll_linux64用于客户端信息的采集.
v6.
3.
15_20190220_api_tradeapi_se_linux64用于行情、交易等功能.
注:带有64字符的包表示是用于64位Linux操作系统的,上期技术没有提供32位版本的linux库文件.
1、在工程目录中建立ctplib64目录,把CTPAPI头文件、DLL拷贝到ctplib64目录中.
ctplib64目录名称可以自定义,用于在工程中附加库路径.
2、在工程目录中建立两个目录,分别用于交易流和行情流数据的保存.
3、在解决方案中添加API包的头文件(.
h)到工程中4、引入CTP库文件与编写编译指令文件(Makefile)中信建投期货CTP系统外部接入操作指引说明:上图中的内容仅作为一个Makefile参考模板,编译文件中的文件数量以及链接库需要根据实际情况进行编写.
上图中的四个主要文件作用:Main.
c:程序主线程完成交易类和行情类的初始化工作.
Getconfig.
c:程序的配置选项.
保存交易前置、行情前置地址、投资者账号、密码等信息.
CTraderApi.
c:继承CTP交易类API的自定义实现.
CTraderSPi.
c:继承CTP交易类SPI的自定义实现.
Makefile文件的$(CC)标记处都链接了.
so库和lpthread库.
这里仅作为文件编写参考,实际上不需要每个文件都重复链接相同的库.
5、至此API包已经和工程集成了.
2.
3、接入相关的主要代码1、创建交易类CTraderApi*pUserApi=newCTraderApi;/*CTraderApi继承CThostFtdcTraderApi.
CThostFtdcTraderApi类提供了交易api的初始化、登录、报单和查询等功能.
由于CTP定义的交易和行情类都是抽象的虚函数,所以在CTraderApi.
cpp需要全部实现但可以不用重写.
详情请参考CTP技术手册*/2、创建交易流目录pUserApi->CreateFtdcTraderApi(".
\\citics-flow1\\");/*pUserApi->CreateFtdcTraderApi(".
\\citics-flow1\\");程序可以通过CThostFtdcTraderApi发出操作请求,通过继承CThostFtdcTraderSpi并重载回调函数来处理后台服务的响应.
如果创建多个api实例,则每个实例的flow目录都要区分开,否则可能会导致报单回报丢失.
程序运行之前,流目录必须提前创建好,否则会报错"RuntimeError:cannotopenCFlowfileinline279offile.
.
\.
.
\source\userapi\ThostFtdcUserApiImplBase.
cpp".
这里仅仅为了接入演示,所以手动在文件夹中建立好"citics-flow1"目录*/3、初始化交易线程CustomTraderHandlersh(pUserApi);pUserApi->RegisterSpi(&sh);pUserApi->SubscribePrivateTopic(THOST_TERT_QUICK);中信建投期货CTP系统外部接入操作指引pUserApi->SubscribePublicTopic(THOST_TERT_QUICK);pUserApi->RegisterFront("交易前置地址");pUserApi->Init();/*CustomTraderHandler继承CTraderSpi,用于客户的自定义业务逻辑*/4、信息采集及认证m_pUserApi->ReqAuthenticate(&pReqAuthenticateField,1);/*ReqAuthenticate函数原型为virtualintReqAuthenticate(CThostFtdcReqAuthenticateField*pReqAuthenticateField,intnRequestID)=0;参数及返回值请参考CTP手册*/5、账号登录pUserApi->ReqUserLogin(&reqUserLogin,nRequestID++);3、Linux接入程序中的注意事项3.
1、字符串长度(重要)字符串是连续的字符序列,最后以空字符'\0'作为终止符.
一个字符串的长度指所有字符的数量,但不包括终止符.
在C语言中,没有字符串类型,自然也就没有运算符以字符串为操作数.
字符串被存储在元素类型为char或宽字符类型数组中(宽字符类型指wchar_t、char16_t或char32_t).
存储字符串的数组一定比字符串长度多一个元素,以容纳下字符串终止符(空字符'\0').
LinuxCTP接入中要注意字符串长度,长度不正确CTP后台会返回错误信息.
例如:假设投资者账号为"123456".
在c语言中用char数组保存这个字符串实际上需要占用7字节加上末尾的'\0'结束符.
如果直接使用这个char数组用于登录接口调用,CTP会返回登录失败.
Linux中CTP能正确识别的字符串需要去掉字符数组最后的结束符.
如果投资者账号为"123456",在调用CTP接口时只能把6字节的"123456"作为参数传入.
3.
2、线程同步Linux中设计线程同步方案可使用锁、信号量等机制.
下面给出线程锁的同步方案作为参考,关于锁的技术原理请参考相关资料.
1、初始化静态锁/*初始化静态方式锁*/pthread_mutex_tmutex=PTHREAD_MUTEX_INITIALIZER;pthread_cond_tflag=PTHREAD_COND_INITIALIZER;2、线程加锁/*初始化自定义交易类--start*/pthread_mutex_lock(&mutex);//加锁CustomTraderHandlersh(pUserApi);pUserApi->RegisterSpi(&sh);pUserApi->SubscribePrivateTopic(THOST_TERT_QUICK);pUserApi->SubscribePublicTopic(THOST_TERT_QUICK);pUserApi->RegisterFront(const_cast(g_chFrontaddr.
c_str()));中信建投期货CTP系统外部接入操作指引pUserApi->Init();pthread_cond_wait(&flag,&mutex);//等待flag置位pthread_mutex_unlock(&mutex);//解锁3、对应的线程回调中置位flag标志/*前置连接后的回调中置位锁*/virtualvoidOnFrontConnected(){/*用户自定义实现的业务逻辑*//*置位锁*/pthread_mutex_lock(&mutex);pthread_mutex_unlock(&mutex);pthread_cond_signal(&flag);}中信建投期货CTP系统外部接入操作指引参考2:终端认证调试CTP-windows1、准备工作版本说明:1、6.
3.
13用于采集客户终端信息,完成客户端的接入认证.
2、6.
3.
15用于仿真环境和生产环境.
在开发者宿主机上安装C/C++IDE及开发环境,如VisualStudio、QtCreator.
本说明文档采用VisualStudio作为开发环境IDE进行后续项目工程的开发.
2、建立项目解决方案说明:CTP6.
3.
13版本和6.
3.
15版本在客户端接入及认证部分是一致的,本文以6.
3.
15版本为例进行说明.
实际上由于客户接入流程的原因,客户自开发程序需要同时拥有两个版本的解决方案.
用户需要先通过6.
3.
13进行客户端数据采集及验证,待期货公司完成数据验证后再通过6.
3.
15版本进行正常交易.
2.
1、建立项目工程打开VisualStudio,创建C++/win32工程解决方案.
本文使用的VisualStudio是2019版本,其他版本在功能上是一致的界面上会有一定的区别.
(建议使用VisualStudio2012以上的版本进行开发)2.
2、集成CTPAPI到工程中需要把CTPAPI包拷贝到本地文件系统的工程目录中,拷贝的APIDLL和头文件位于6.
3.
15_20190220_clientdll64_windows、6.
3.
15_20190220_tradeapi64_se_windows目录中.
6.
3.
15_20190220_clientdll64_windows用于客户端信息的采集.
6.
3.
15_20190220_tradeapi64_se_windows用于行情、交易等功能.
注:带有64字符的包表示是用于windows64位操作系统的,没有64字符的包表示用于windows32位操作系统.
1、在工程目录中建立winapi_64目录,把CTPAPI头文件、DLL拷贝到winapi_64目录中.
Winapi_64目录名称可以自定义,用于在工程中附加库路径.
中信建投期货CTP系统外部接入操作指引2、在工程目录中建立两个目录,分别用于交易流和行情流数据的保存.
3、在解决方案中添加API包的头文件(.
h)到工程中4、在工程中引用DLL文件中信建投期货CTP系统外部接入操作指引5、至此API包已经和工程集成了.
2.
3、接入相关的主要代码1、创建交易类CTraderApi*pUserApi=newCTraderApi;/*中信建投期货CTP系统外部接入操作指引CTraderApi继承CThostFtdcTraderApi.
CThostFtdcTraderApi类提供了交易api的初始化、登录、报单和查询等功能.
由于CTP定义的交易和行情类都是抽象的虚函数,所以在CTraderApi.
cpp需要全部实现但可以不用重写.
详情请参考CTP技术手册*/2、创建交易流目录pUserApi->CreateFtdcTraderApi(".
\\citics-flow1\\");/*pUserApi->CreateFtdcTraderApi(".
\\citics-flow1\\");程序可以通过CThostFtdcTraderApi发出操作请求,通过继承CThostFtdcTraderSpi并重载回调函数来处理后台服务的响应.
如果创建多个api实例,则每个实例的flow目录都要区分开,否则可能会导致报单回报丢失.
程序运行之前,流目录必须提前创建好,否则会报错"RuntimeError:cannotopenCFlowfileinline279offile.
.
\.
.
\source\userapi\ThostFtdcUserApiImplBase.
cpp".
这里仅仅为了接入演示,所以手动在文件夹中建立好"citics-flow1"目录*/3、初始化交易线程CustomTraderHandlersh(pUserApi);pUserApi->RegisterSpi(&sh);pUserApi->SubscribePrivateTopic(THOST_TERT_QUICK);pUserApi->SubscribePublicTopic(THOST_TERT_QUICK);pUserApi->RegisterFront("交易前置地址");pUserApi->Init();/*CustomTraderHandler继承CTraderSpi,用于客户的自定义业务逻辑*/4、信息采集及认证m_pUserApi->ReqAuthenticate(&pReqAuthenticateField,1);/*ReqAuthenticate函数原型为virtualintReqAuthenticate(CThostFtdcReqAuthenticateField*pReqAuthenticateField,intnRequestID)=0;参数及返回值请参考CTP手册*/5、账号登录pUserApi->ReqUserLogin(&reqUserLogin,nRequestID++);