使用说明文件

RTCTradeAPI和RTCQuoteAPI介面是基于C++类实现且仿CTP交易系统，支持下单、撤单、资金查询、持仓查询、委托查询、成交查询...等功能。

类库文件说明

文件名	文件描述
RTCTradeAPI.h	交易介面
RTCQuoteAPI.h	报价介面
RTCUserApiStruct.h	定义介面所需要的资料结构
RTCUserApiDataType.h	定义介面所需要的资料类型
RTCErrorCode.h	回传的错误码讯息
RTCQuoteAPI.dll	报价的lib
RTCTradeAPI.dll	交易的lib

支援Microsoft Visual studio 2010开发环境

API包括两部分，交易API(RTCTradeAPI)和报价API(RTCQuoteAPI)，交易API主要用来下单、删单、查询资金、查询持仓...等功能，报价API主要用来获取行情资讯。

系统架构

系统架构

API介面会把查询、下单资讯送到TCore后会透过adapter送到交易所，后台返回的资料 adapter会送到TCore进行处理过后才会送到API介面

API内部架构

RTCTradeAPI和RTCQuoteAPI内部架构都是一样的，都有个callback执行绪在处理TCore的回 传资料，而客户端在接收每一个callback时建议自行维护一个​队列，以避免影响后续资料。

API界面开发规则

开发流程

1.在使用API​​功能前，请务必进行TCore连接RegisterFront()。

2.请求和callback是在不同的执行绪，且收到callback时建议自行用到另一个执行绪中处理，以避免后面资料阻塞。

3.每一个函数入参所需的结构强烈建议清空，以避免未知的数值出现。

4.由于RTCTradeAPI和和RTCQuoteAPI是仿CTP，并不是每一个功能都有实现，而没有实现的功能API一律返回-1000，请依照下文内容中有说明的函数进行调用。

5.使用查询类型函数时，参数结构如果带空则全查。

6.交易和报价API必须要收到OnFrontConnected() callback才可做后续的功能。

7.使用API​​前，务必启动咏春大师2量化版 客户端(TCore)

8.中文编码都采用UTF8

API Spi介面

RTCTradeAPISpi和RTCQuoteAPISpi介面定义了事件通知，开发人员务必继承此类，编写对 应的事件处理。

RequestID栏位

由于查询资讯都是在不同的执行绪进行处理，介面定义了每次请求与回应资讯的唯一识别ID。

连接断开

当与TCore连线断开时，OnFrontDisconnected() callback会通知客户端，该API并不会自动重 连。

IsLast栏位

在callback中，当资料有多笔的时候，读取此栏位可以得知是否是最后一笔资料。

ICERspInfoField异常讯息结构

ICERspInfoField
ICEErrorIDType	错误码(请参考RTCErrorCode.h)
ICEErrorMsgType	错误的讯息

API错误码（RTCErrorCode.h）

错误码	说明
0	正确
-1000	不支援的API
-1001	资料元件初始化失败
-1002	取资料失败
-1003	商品名称错误
-1004	查询失败