新版CTP客户端开发指南
达钱CTP操作手册
13
第四章 交易群组设置
达钱提供交易账号群组管理功能， 您可以自行定义交易群组， 与自动交易服务配合，透过「下单倍 數」的设定可针对不同的交易账号进行「下单數量」的控制。
设定群组账号 依据您所登入的交易账号，可进行交易群组的设定。 1. 选择「登入交易帐号」 「交易群组设置」
4
7. 请 您 「 检 视 」 安 装 信 息 ， 按 「 下 一 步 」 继 续 安 装 。
8. 「 安 装 过 程 进 行 中 」 ，按「取消」可停止 达钱 程序安装。
5
9. 「 安 装 完 成 」 ，您可以由桌面的快捷方式执行「达钱」 。
2. 按下「新增」建立一个新的群组， 您可以单击「群组名称」來改变您的群组名称。
14
3. 由「交易账号列表」中点选欲加入的「交易账号」， 按下 可加入至选定的群组。
4. 当您完成群组设定动作后，请务必按下「储存设定」， 更新您的群组狀态。
15
5. 您 可 以 自 行 选 择 「 开 始 菜 单 」 的 快 捷 方 式 位 置 ， 按 「 下 一 步 」 继 续 安 装 。
3
6. 您 可 以 自 行 选 择 是 否 建 立 「 桌 面 」 的 快 捷 方 式 ， 按 「 下 一 步 」 继 续 安 装 。
下单与帐务 回报查询
期货下单盒 委托回报 成交回报 交易记录 权益数查询 部位查询 即时损益试算 银期转帐
加值插件
闪电下单模块
11
(3) 将 组 件 配 置 到 理 想 的 位 置 当 您 选 择 了 您 欲 使 用 的「 窗 口 组 件 」后 ，您 可 以 使 用「 鼠 标 」拖 曳「 窗 口 组 件 」同 时在画面会出现一个「十字符号」如下图所示。
ctp开发手册
ctp开发手册CTP开发手册概述CTP（中国期货市场交易系统）是中国期货市场的官方交易系统，它为期货投资者提供了一种高效、稳定的交易平台。
为了方便期货交易者更好地使用CTP平台，官方发布了一份CTP开发手册，介绍了CTP 的基本架构以及主要的接口函数和规范。
本文将为读者详细介绍CTP开发手册的主要内容。
CTP开发手册的内容1. CTP架构在CTP开发手册中，首先介绍了CTP的基本架构，包括前置服务、交易路由、后台服务和客户端等组件。
每个组件都有特定的作用和职责，前置服务负责客户端的数据请求和转发，交易路由负责处理客户端请求并向交易所发送交易指令，后台服务负责处理交易所的返回数据，客户端则提供了用户交互界面以及调用接口的方法。
2. CTP接口在CTP开发手册中，介绍了各种CTP接口函数，包括行情相关函数、交易相关函数、用户管理函数等。
这些接口可以实现行情获取、订单发送、查询等功能。
3. 配置文件CTP开发手册还介绍了一些配置文件的格式和参数，包括账户信息、交易代码列表、日志配置等。
读者可以按照手册中的说明编辑配置文件，以满足特定的需求。
4. 示例代码为了帮助开发者更好地了解CTP平台和接口函数的使用，手册提供了丰富的示例代码。
这些代码展示了如何获取市场行情、如何下单、如何查询订单等常见的操作。
5. 错误处理手册还介绍了错误代码和错误处理的方法。
开发者在使用CTP接口时，可能会遇到一些错误。
手册提供了详细的错误代码列表，以及错误处理的建议。
结语通过学习CTP开发手册，开发者可以更好地了解CTP平台的架构和接口规范，掌握各种接口函数的使用方法，最终能够开发出更加完善的交易系统。
本文简要介绍了CTP开发手册的主要内容，读者可以根据自己的需求和兴趣深入学习。
新版CTP客户端开发指南
乔煜
3.1
1. 修改 Demo 代码
乔煜
2. 添加报单流程图解，状态变化解释
3. 添加更多业务点介绍
更新：2015-10-16 １
CTP 客户端开发指南
前言
这是一份由上期技术提供的旨在帮助开发者快速了解、学习与综合交易平台进行对接的开发接口的文档。这 份文档提供了综合交易平台接口的整体介绍，解释了接口的运行机制，简述了使用相应的接口开发客户端的 常规步骤。文档中还会列举出其他开发人员咨询的问题及我们给出的回复。
更多上期技术实时信息请关注上期技术微信公众平台
上海期货信息技术有限公司
２
CTP 客户端南 ..................................................................................................................................................１ 前言 ...............................................................................................................................................................................２ 目录 ...............................................................................................................................................................................３ 1 CTP ..............................................................................................................................................................................５
多账户-多策略期货交易程序(ctp开发经验分享)
CTP多账户多策略-交易程序C++c t p接口程序化交易经验分享CTP简介综合交易平台CTP（Comprehensive Transaction Platform）是由上海期货信息技术有限公司（上海期货交易所的全资子公司）开发的期货交易平台，CTP平台以“新一代交易所系统”的核心技术为基础，稳定、高速、开放式接口，适合程序化交易软件运用和短线炒单客户使用。
ctp接口下载地址本文目的该程序是我大二暑假参加一个金融软件比赛写的，是比赛作品的其中一部分，专门用来进行交易的。
作品的目标是多账户、多策略。
其中交易策略用别的语言编写，它们产生并发送交易指令（交易账户、交易合约等信息）给交易主机(即这个项目)进行买卖。
因此交易主机的主要职责是接收、解析并执行交易指令，跟踪汇报指令的交易情况。
具体情况可以看我我上传的介绍视频，那是后来提交作品时录的。
后来有几个人问起我这个程序，其中有位老师想在实盘中测试下自己的交易策略怎样，就找了两位师弟给他做那个东西，然后让我去给他们讲要注意些什么东西，这让我想起自己一开始接触ctp的接口时，花了不少时间去测试接口看是怎么一回事。
鉴于网上ctp的开发介绍不多，我就借这个项目分享下经验，让大家能少走些弯路就尽量少走一些。
有以下地方需要注意：环境：VS2013 + Qt5.3(32位) + mysql(32位)(在我写这个项目时ctp在windows平台上只有32位的库)刚接触的话先粗略浏览下“开发资料”中的内容，里面的PPT是需要细看的。
我下面讲的是些开发的经验，并不是起步教程，理解资料中的PPT是起步的关键在初步理解概念后试着自己写一个登录发请求的例子，试着调用不同的API函数，这些可以参考noQtCTP.rar里的内容（结合文档中的示例）。
这是我开始接触ctp接口时为了理解写的一些代码（就是登录、调用简单的API），不需要Qt库也可以编译当需要测试交易API时，可以参考tdspiTestWithQt.rar里的内容，这是我学交易API操作和研究回调函数时用得最多的工具了！需要Qt进行编译，可以不断修改里面的tdspiTestWithQt里有这样的功能（大把模拟账号没人用的，不用担心影响到别人）3. 无论是行情还是交易API，里面都有两个类，一个是xxxSpi，另一个是xxxApi，分别代表着回调和调用。
CTPIIMini API 应用开发参考手册说明书
（Ver 1.4）上海期货信息技术有限公司2022年11月修订历史记录3)交易接口增加章节3.1.47~3.1.50目录修订历史记录 (2)目录 (5)1系统介绍 (11)1.1概述 (11)1.2架构 (11)1.3特点 (12)2API介绍 (13)2.1基本文件 (13)2.2开发平台 (14)2.3版本变更 (14)2.3.1之前版本 (14)2.3.2V1.5.8 (15)2.3.3V1.5.9 (27)2.3.4V1.6.0 (29)2.3.5V1.6.1 (30)2.3.6V1.6.2 (31)2.3.7V1.6.3 (32)2.4网络通信 (32)2.4.1通讯模式 (32)2.4.2通讯实现 (34)2.5接口分类 (36)2.5.1管理接口 (36)2.5.2业务接口 (37)2.6接口流程 (41)2.6.1交易 (41)2.6.2行情 (44)3交易接口 (45)3.1CT HOST F TDC T RADER A PI (45)3.1.1CreateFtdcTraderApi (45)3.1.2GetApiVersion (46)3.1.3Release (47)3.1.4Init (48)3.1.5Join (48)3.1.6GetTradingDay (48)3.1.7RegisterFront (49)3.1.8RegisterSpi (49)3.1.9SubscribePrivateTopic (49)3.1.10SubscribePublicTopic (50)3.1.11ReqAuthenticate (50)3.1.12ReqUserLogin (51)3.1.13ReqUserLoginEncrypt (52)3.1.14ReqUserLogout (53)3.1.15ReqOrderInsert (54)3.1.16ReqOrderAction (57)3.1.17ReqExecOrderInsert (58)3.1.18ReqExecOrderAction (60)3.1.19ReqForQuoteInsert (61)3.1.20ReqQuoteInsert (62)3.1.21ReqQuoteAction (64)3.1.22ReqOptionSelfCloseInsert (66)3.1.23ReqOptionSelfCloseAction (67)3.1.24ReqQryOrder (68)3.1.25ReqQryTrade (69)3.1.26ReqQryInvestorPosition (70)3.1.27ReqQryTradingAccount (70)3.1.28ReqQryInvestor (71)3.1.29ReqQryTradingCode (72)3.1.30ReqQryInstrumentMarginRate (72)3.1.31ReqQryInstrumentCommissionRate (73)3.1.32ReqQryExchange (74)3.1.34ReqQryDepthMarketData (76)3.1.35ReqQryOptionSelfClose (76)3.1.36ReqQryInstrumentStatus (77)3.1.37ReqQryInvestorPositionDetail (78)3.1.38ReqQryInvestorPositionCombineDetail (78)3.1.39ReqQryExchangeMarginRate (79)3.1.40ReqQryExchangeMarginRateAdjust (80)3.1.41ReqQryOptionInstrTradeCost (80)3.1.42ReqQryOptionInstrCommRate (81)3.1.43ReqQryExecOrder (82)3.1.44ReqQryForQuote (83)3.1.45ReqQryQuote (83)3.1.46ReqQryInstrumentOrderCommRate (84)3.1.47ReqCombActionInsert (85)3.1.48ReqQryCombAction (86)3.1.49ReqQryCombInstrument (86)3.1.50ReqQryInvestorPositionForComb (87)3.1.51ReqQryForQuoteParam (87)3.1.52ReqMKBatchOrderAction (88)3.1.53SubscribeFlowCtrlWarning (90)3.1.54UnSubscribeFlowCtrlWarning (90)3.1.55ReqQryTraderOffer (91)3.1.56ReqQryInvestorProdSPBMDetail (92)3.2CT HOST F TDC T RADER S PI (92)3.2.1OnFrontConnected (92)3.2.2OnFrontDisconnected (93)3.2.3OnRspUserLogin (93)3.2.4OnRspAuthenticate (94)3.2.5OnRspOrderInsert (94)3.2.6OnRspOrderAction (95)3.2.7OnRspExecOrderInsert (95)3.2.8OnRspExecOrderAction (96)3.2.9OnRspForQuoteInsert (96)3.2.12OnRspOptionSelfCloseInsert (97)3.2.13OnRspOptionSelfCloseAction (98)3.2.14OnRspQryOrder (98)3.2.15OnRspQryTrade (100)3.2.16OnRspQryInvestorPosition (101)3.2.17OnRspQryTradingAccount (103)3.2.18OnRspQryInvestor (105)3.2.19OnRspQryTradingCode (105)3.2.20OnRspQryInstrumentMarginRate (106)3.2.21OnRspQryInstrumentCommissionRate (107)3.2.22OnRspQryExchange (107)3.2.23OnRspQryInstrument (108)3.2.24OnRspQryDepthMarketData (109)3.2.25OnRspQryInstrumentStatus (110)3.2.26OnRspQryInvestorPositionDetail (111)3.2.27OnRspQryInvestorPositionCombineDetail (112)3.2.28OnRspQryExchangeMarginRate (113)3.2.29OnRspQryExchangeMarginRateAdjust (114)3.2.30OnRspQryOptionInstrTradeCost (115)3.2.31OnRspQryOptionInstrCommRate (116)3.2.32OnRspQryExecOrder (116)3.2.33OnRspQryForQuote (118)3.2.34OnRspQryQuote (119)3.2.35OnRspQryOptionSelfClose (120)3.2.36OnRtnOrder (122)3.2.37OnRtnTrade (123)3.2.38OnErrRtnOrderAction (124)3.2.39OnRtnInstrumentStatus (125)3.2.40OnRtnExecOrder (125)3.2.41OnErrRtnExecOrderAction (125)3.2.42OnErrRtnForQuoteInsert (126)3.2.43OnRtnQuote (127)3.2.44OnErrRtnQuoteAction (127)3.2.47OnErrRtnOptionSelfCloseAction (129)3.2.48OnRspQryInstrumentOrderCommRate (130)3.2.49OnRspCombActionInsert (130)3.2.50OnRtnCombAction (131)3.2.51OnRspQryCombAction (132)3.2.52OnRspQryCombInstrument (132)3.2.53OnRspQryInvestorPositionForComb (133)3.2.54OnRspQryForQuoteParam (134)3.2.55OnRspMKBatchOrderAction (134)3.2.56OnRspSubscribeFlowCtrlWarning (135)3.2.57OnRspUnSubscribeFlowCtrlWarning (135)3.2.58OnRtnFlowCtrlWarning (136)3.2.59OnRspQryTraderOffer (136)3.2.60OnRspQryInvestorProdSPBMDetail (137)4行情接口 (138)4.1CT HOST F TDC M D A PI (138)4.1.1CreateFtdcMdApi (138)4.1.2GetApiVersion (139)4.1.3Release (140)4.1.4Init (140)4.1.5Join (141)4.1.6GetTradingDay (141)4.1.7RegisterFront (141)4.1.8RegisterSpi (142)4.1.9SubscribeMarketData (142)4.1.10UnSubscribeMarketData (143)4.1.11SubscribeForQuoteRsp (143)4.1.12UnSubscribeForQuoteRsp (144)4.1.13ReqUserLogin (144)4.2CT HOST F TDC M D S PI (145)4.2.1OnFrontConnected (145)4.2.2OnFrontDisconnected (145)4.2.3OnRspUserLogin (146)4.2.5OnRspUnSubMarketData (147)4.2.6OnRspSubForQuoteRsp (147)4.2.7OnRspUnSubForQuoteRsp (147)4.2.8OnRtnDepthMarketData (148)4.2.9OnRtnForQuoteRsp (150)1系统介绍为了方便广大CTPIIMini API开发者更好了解CTPIIMini产品，本章对产品做一个概括介绍，希望从整体上帮助到每个开发者。
CTP接口开发指南
十一、 报单 标识 FrontID + SessionID + OrderRef OrderRef(int atoi 注意长度) BrokerID + BrokerOrderSeq ExchangeID + OrderSysID ReqOrderInsert OnRspOrderInsert Thost 收到报单指令，如果没有通过参数校验，拒绝接受报单指令 OnErrRtnOrderInsert 交易所收到报单后认为报单错误 OnRtnOrder 报单委托状态 ///TFtdcOrderStatusType 是一个报单状态类型 ///全部成交 #define THOST_FTDC_OST_AllTraded '0'
到张江托管中心的搬迁。主机托管会员在享有较低费用支出的基础上,享有更优 质的托管服务。10 月,托管中心正式推出针对 VIP 会员的机房托管模式。国金期 货和东证期货作为首批机房托管用户正式入驻。
2010 年 继往开来,合作共赢,共创辉煌:2010 年 6 月底,CTP 已完成 21 家应用托管客户的 签约待上线。张江交易管托中心,托管服务已细分为机房托管、主机托管、零星 托管、应用托管等诸多类型,会员市场从最初的小会员公司,发展到现在占有全 行业 70%的托管市场,机房面积从 100 多平米,发展到目前的 2000 多平米。
回 1 条或者多条响应纪录。例如登入、各项查询、报单、撤单等操作。 私有通讯模式：由 Thost 主动向客户端发出的相关信息。例如委托回报、
成交回报、错单回报等 广播通讯模式：由 Thost 主动向所有客户端发出的公共信息，例如行情等 数据流重传方式 通常使用 Restart 模式较为方便 本地数据落地可用 Resume 模式
CTPAPI开发之二：制作CTPjava版API
CTPAPI开发之⼆：制作CTPjava版API⽬前上期技术CTP系统提供的API版本是C++版本SWIG是⼀个能将C/C++接⼝转换为其他语⾔的⼯具，⽬前可以⽀持Python,Java,R等语⾔。
本⽂主要介绍Windows 32/64位平台下利⽤Swig⼯具将CTP C++接⼝API转换为Java可调⽤的接⼝。
1、从CTP官⽹下载最新API包，包中包含32位和64位。
API⽂件包清单：2、下载安装Swig软件：3、在API⽂件包中创建thostapi.i 和various.i⽂件，thostapi.i是⼀个接⼝⽂件，⽤于告诉swig为哪些类和⽅法创建接⼝various.i是⽤于将C++接⼝中的数组参数转换为java 的Array的⼯具类%module(directors="1") thosttraderapi%include "various.i"%apply char **STRING_ARRAY { char *ppInstrumentID[] }%{#include "ThostFtdcMdApi.h"#include "ThostFtdcTraderApi.h"%}%feature("director") CThostFtdcMdSpi;%include "ThostFtdcUserApiDataType.h"%include "ThostFtdcUserApiStruct.h"%include "ThostFtdcMdApi.h"%feature("director") CThostFtdcTraderSpi;%include "ThostFtdcTraderApi.h"4、⽣成java接⼝：在当前⽂件夹创建src/ctp⽂件夹⽤于放置⽣成的java⽂件..\..\swigwin-2.0.11\swig.exe -c++ -java -package ctp.thosttraderapi -outdir src -o thosttraderapi_wrap.cpp thostapi.i运⾏完成之后，可在当前⽂件夹中看到⽤于包装原来C++接⼝的⽂件：5、通过C++得到java可调⽤的动态库创建⼀个C++⼯程，应⽤程序类型选择DLL,将以下⽂件添加到⼯程中去:将dk⽬录\Java\jdk1.8.0_111\include下的jni.h和win32⽂件夹下的jni_md.h, jawt_md.h⼀共三个⽂件拷贝到安装vs的include⽬录底下\Microsoft Visual Studio 12.0\VC\include。
CTP1.0_产品使用说明书
CTP产品使用说明书1CTP通讯配置本章节主要介绍海信通讯服务器的配置相关内容，在安装数据通讯服务器后，可以参阅本章节的内容分别配置。
1.1 业务组件配置信息点击【配置】菜单，选择【数据库配置】，进入数据库配置界面。
配置项目：【类型】：选择数据库类型，目前支持SQLServer和Oracle两种数据库。
●SQL Server数据库需要配置信息请参照下图：●Oracle数据配置参照下面界面：配置后按测试按钮测试配置参数是否正确。
如果出现下面窗体表示配置成功。
1.2 通讯项目配置CTP通讯平台为用户提供了通用的通讯配置界面，用户可以通过本界面增加或者修改通讯项目。
点击【配置】菜单，选择【通讯项目配置】，进入通讯项目配置界面。
1.2.1通讯接口通讯接口可以实现不同的产品，不同业态的分店使用不同的通讯项目集合。
按【增加】按钮可以增加新的通讯项目接口编码：要求唯一。
接口名称：当前定义的接口名称。
服务名称：定义接口对应的业务处理组件。
默认的业务处理组件是MtsComSvr.HisCom【删除】：按该按钮会删除当前接口下对应的所有通讯项目，并且不可恢复，所以删除通讯项目一定要慎用。
1.2.2通讯项目配置一般一个需要通讯的业务关联的数据都配置为一个通讯项目。
对于通讯项目，需要配置下面的内容：【项目编码】：项目编码是一个通讯业务的代码，在一个通讯接口下必须是唯一的。
【项目名称】：通讯数据对应的业务名称。
【同步方式】：同步方式包含三种：0-业务启动同步本方式由业务系统特定业务过程调用，例如单据审核，记账等业务处理触发。
用户自定义的通讯项目不要采用该方法。
实时性要求比较强。
1-手动启动同步通过界面按钮或者菜单手工启动的通讯过程。
用户自定义的通讯项目不要采用该方法。
2-定时启动同步通过系统定时器，定时自动触发的通讯项目。
一般用户通讯项目应该配置该类型。
【数据类型】：分为三类类型0-按照条件发送适用条件：该类型只能用于客户端向总部的发送。
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
更多上期技术实时信息请关注上期技术微信公众平台
上海期货信息技术有限公司
２
CTP 客户端开发指南
目录
CTP 客户端开发指南 ..................................................................................................................................................１ 前言 ...............................................................................................................................................................................２ 目录 ...............................................................................................................................................................................３ 1 CTP ..............................................................................................................................................................................５
这份指南是在参考了已有的一些文档的基础上，对以前的文档内容进行了总结和归纳，并补充了最新版本接 口中新增的特性。
如果读者认为本文档中还有可以完善的地方或还有需要重点指出但没有覆盖到的地方，欢迎提出宝贵的意见 和建议。
联系方式 上期技术,金融事业部 apiSupport@
1.2.1 通讯模式 ..............................................................................................................................................６ 1.2.2 数据流..................................................................................................................................................８ 1.3 两种数据交换模式 ........................................................................................................................................９ 1.3.1 请求/应答模式 .....................................................................................................................................９ 1.3.2 发布/订阅模式.....................................................................................................................................９ 1.4 CTP 系统架构 ..............................................................................................................................................１０ 2 API ..........................................................................................................................................................................１２ 2.1 介绍............................................................................................................................................................１２ 2.1.1 接口文件 ..........................................................................................................................................１３ 2.2 通用规则....................................................................................................................................................１４ 2.2.1 命名规则..........................................................................................................................................１４ 2.2.2 接口类 .............................................................................................................................................１４ 2.2.3 通用参数 .........................................................................................................................................１５ 2.2.4 接口的初始化步骤 .........................................................................................................................１５ DEMO 开发...............................................................................................................................................................１７ 3 行情 DEMO 开发 ..................................................................................................................................................１７ 3.1 准备工作....................................................................................................................................................１７ 3.2 行情接口的初始化....................................................................................................................................１９ 3.3 登录............................................................................................................................................................２０ 3.4 订阅行情....................................................................................................................................................２１ 3.5 订阅和接收询价........................................................................................................................................２２ 3.6 CTP 行情推送规则详解..............................................................................................................................２３ 4 交易 DEMO 开发..................................................................................................................................................２３ 4.1 交易接口的初始化....................................................................................................................................２３ 4.2 登陆系统....................................................................................................................................................２５ 4.3 结算单确认................................................................................................................................................２５ 4.4 持仓计算....................................................................................................................................................２６ 4.5 报单流程....................................................................................................................................................２６ 4.6 处理报单的函数........................................................................................................................................２９ 4.7 报单............................................................................................................................................................３２ 4.7.1 FOK & FAk.........................................................................................................................................３３ 4.7.2 报单序列号 .....................................................................................................................................３５ 4.7.3 报单类型组合 .................................................................................................................................３６ 4.7.4 报单回报.........................................................................................................................................３７ 4.7.5 成交回报.........................................................................................................................................３７