综合交易平台API简介.pptVIP

综合交易平台API简介 大纲 Api概述 通用规则 交易业务 行情业务 参考资料 概述 综合交易平台Api包括交易Api和行情Api 交易Api建立在Tcp协议上，实现了客户端和综合交易平台之间的双向异步通讯。行情Api可以运行在Tcp或者在Udp协议上。 下面把综合交易平台简称为Thost，交易Api简称为TraderApi ，行情Api简称为MdUserApi。上述2种Api统称为Api。 概述 - 通讯模式 Api有3种通讯模式： 对话通讯模式：由客户端主动发起请求。Thost收到请求、处理请求后，返回1条或者多条响应纪录。例如登入、各项查询、报单、撤单等操作。 私有通讯模式：由Thost主动向客户端发出的相关信息。例如委托回报、成交回报、错单回报等 广播通讯模式：由Thost主动向所有客户端发出的公共信息，例如行情等。 概述 – 通讯模式 有3种方式订阅公有流和私有流 enum THOST_TE_RESUME_TYPE { // 从当天的第一条记录开始接收数据流 THOST_TERT_RESTART = 0, // 接收上次断线以后的数据流 THOST_TERT_RESUME, // 接收本次登入以后的数据流 THOST_TERT_QUICK }; 概述 - 初始化过程 MdUserApi的初始化过程比较简单， 默认按照Quick的方式订阅公有流和私有流。 概述 - 样例代码 TraderApi样例代码： testTraderApi 初始化，登入，确认结算结果，查询合约，查询资金，查询持仓，报单，收委托回报，撤单 MdUserApi样例代码： testMdUserApi 初始化，登入，订阅，收行情 概述 - 接口文件 TraderApi接口文件： ThostFtdcTraderApi.h： 定义了请求接口CThostFtdcUserApi，事件处理接口CThostFtdcUserSpi。 ThostFtdcUserApiStruct.h： 定义了接口方法中用到的数据结构。 ThostFtdcUserApiDataType.h： 定义了数据结构中用到数据类型，枚举描述。 thosttraderapi.lib：静态连接库 thosttraderapi.dll：动态链接库 MdUserApi接口文件： ThostFtdcMdApi.h： 定义了请求接口CThostFtdcMdApi，事件处理接口CThostFtdcMdSpi。 ThostFtdcUserApiStruct.h，ThostFtdcUserApiDataType.h： 和TraderApi公用。 thostMdapi.lib：静态连接库 thostMdapi.dll：动态链接库 通用规则 - 命名规则 Api的方法都是遵循一定的命名规则来设定。 请求指令：Req***, OnRsp***。如ReqUserLogin，OnRspUserLogin。 查询指令：ReqQry***，OnRspQry***。如ReqQryInstrument，OnRspQryInstrument。 回报消息：OnRtn***，如OnRtnOrder，OnRtnTrade。 错误回报：OnErrRtn***，如OnErrRtnOrderInsert，OnErrRtnOrderAction。 通用规则 – 查询/请求 请求查询合约 virtual int ReqQryInstrument(CThostFtdcQryInstrumentField *pQryInstrument, int nRequestID) = 0; 请求查询合约响应 virtual void OnRspQryInstrument(CThostFtdcInstrumentField *pInstrument, CThostFtdcRspInfoField *pRspInfo, int nRequestID, bool bIsLast) {}; 通用规则 – 查询/请求 查询参数 如果查询参数为空，说明需要查询所有数据。如果需要查询某个交易所的合约，就在查询参数中指定ExchangeID。 请求编号RequestID 发送请求时需要设定RequestID，TraderApi返回响应时返回相关请求的RequestID。 因为TraderApi是异步实现的，终端程序可能连续发出多个请求和查询指令。RequestID可以把请求/查询指令和相关的回报关联起来。 指令返回值 如果调用方法成功，返回0。否则表示不成功。 响应信息RspInfo 如果RspInfo为空，或者RspInfo的错误代码为0，说明查询成功。 否则RspInfo中会保存错误编码和错误信息。 ? 查询响应数