创建MdApi实例
1 2 3 4 |
///@param pszFlowPath 存贮订阅信息文件的目录,默认为当前目录 ///@return 创建出的UserApi ///modify for udp marketdata static CThostFtdcMdApi *CreateFtdcMdApi(const char *pszFlowPath = "", const bool bIsUsingUdp=false, const bool bIsMulticast=false); |
注册回调接口
1 2 |
///@param pSpi 派生自回调接口类的实例 void RegisterSpi(CThostFtdcMdSpi *pSpi) = 0; |
注册前置
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
///@param pszFrontAddress:前置机网络地址。 ///@remark 网络地址的格式为:“protocol://ipaddress:port”,如:”tcp://127.0.0.1:17001”。 ///@remark “tcp”代表传输协议,“127.0.0.1”代表服务器地址。”17001”代表服务器端口号。 void RegisterFront(char *pszFrontAddress) = 0; ///注册名字服务器网络地址 ///@param pszNsAddress:名字服务器网络地址。 ///@remark 网络地址的格式为:“protocol://ipaddress:port”,如:”tcp://127.0.0.1:12001”。 ///@remark “tcp”代表传输协议,“127.0.0.1”代表服务器地址。”12001”代表服务器端口号。 ///@remark RegisterNameServer优先于RegisterFront void RegisterNameServer(char *pszNsAddress) = 0; ///注册名字服务器用户信息 ///@param pFensUserInfo:用户信息。 void RegisterFensUserInfo(CThostFtdcFensUserInfoField * pFensUserInfo) = 0; |
初始化运行环境
1 2 |
///@remark 只有调用后,接口才开始工作 void Init() = 0; |
连接建立
响应
1 2 |
///当客户端与交易后台建立起通信连接时(还未登录前),该方法被调用。 void OnFrontConnected() {}; |
连接异常
响应
1 2 3 4 5 6 7 8 9 10 11 12 |
///当客户端与交易后台通信连接断开时,该方法被调用。当发生这个情况后,API会自动重新连接,客户端可不做处理。 ///@param nReason 错误原因 /// 0x1001 网络读失败 4097 /// 0x1002 网络写失败 4098 /// 0x2001 接收心跳超时 8193 /// 0x2002 发送心跳失败 8194 /// 0x2003 收到错误报文 8195 void OnFrontDisconnected(int nReason) {}; ///当长时间未收到报文时,该方法被调用。 ///@param nTimeLapse 距离上次接收报文的时间 virtual void OnHeartBeatWarning(int nTimeLapse) {}; |
用户登录
请求
1 |
int ReqUserLogin(CThostFtdcReqUserLoginField *pReqUserLoginField, int nRequestID) = 0; |
响应
1 |
void OnRspUserLogin(CThostFtdcRspUserLoginField *pRspUserLogin, CThostFtdcRspInfoField *pRspInfo, int nRequestID, bool bIsLast) {}; |
/չ
CThostFtdcReqUserLoginField
/չ
CThostFtdcRspUserLoginField
用户登出
请求
1 |
int ReqUserLogout(CThostFtdcUserLogoutField *pUserLogout, int nRequestID) = 0; |
响应
1 |
void OnRspUserLogout(CThostFtdcUserLogoutField *pUserLogout, CThostFtdcRspInfoField *pRspInfo, int nRequestID, bool bIsLast) {}; |
/չ
CThostFtdcUserLogoutField
订阅行情
请求
1 2 3 |
///@param ppInstrumentID 合约ID ///@param nCount 要订阅/退订行情的合约个数 int SubscribeMarketData(char *ppInstrumentID[], int nCount) = 0; |
响应
1 2 3 4 |
///订阅行情应答 void OnRspSubMarketData(CThostFtdcSpecificInstrumentField *pSpecificInstrument, CThostFtdcRspInfoField *pRspInfo, int nRequestID, bool bIsLast) {}; ///深度行情通知 void OnRtnDepthMarketData(CThostFtdcDepthMarketDataField *pDepthMarketData) {}; |
/չ
CThostFtdcSpecificInstrumentField
/չ
CThostFtdcDepthMarketDataField
退订行情
请求
1 2 3 |
///@param ppInstrumentID 合约ID ///@param nCount 要订阅/退订行情的合约个数 int UnSubscribeMarketData(char *ppInstrumentID[], int nCount) = 0; |
响应
1 |
void OnRspUnSubMarketData(CThostFtdcSpecificInstrumentField *pSpecificInstrument, CThostFtdcRspInfoField *pRspInfo, int nRequestID, bool bIsLast) {}; |
订阅询价
请求
1 2 3 |
///@param ppInstrumentID 合约ID ///@param nCount 要订阅/退订行情的合约个数 int SubscribeForQuoteRsp(char *ppInstrumentID[], int nCount) = 0; |
响应
1 2 3 4 |
///订阅询价应答 void OnRspSubForQuoteRsp(CThostFtdcSpecificInstrumentField *pSpecificInstrument, CThostFtdcRspInfoField *pRspInfo, int nRequestID, bool bIsLast) {}; ///询价通知 void OnRtnForQuoteRsp(CThostFtdcForQuoteRspField *pForQuoteRsp) {}; |
/չ
CThostFtdcForQuoteRspField
退订询价
请求
1 2 3 |
///@param ppInstrumentID 合约ID ///@param nCount 要订阅/退订行情的合约个数 int UnSubscribeForQuoteRsp(char *ppInstrumentID[], int nCount) = 0; |
响应
1 |
void OnRspUnSubForQuoteRsp(CThostFtdcSpecificInstrumentField *pSpecificInstrument, CThostFtdcRspInfoField *pRspInfo, int nRequestID, bool bIsLast) {}; |
线程等待
1 2 |
///等待接口线程结束运行 int Join() = 0; |
获取API的版本信息
1 2 |
///@retrun 获取到的版本号 static const char *GetApiVersion(); |
获取当前交易日
1 2 3 |
///@retrun 获取到的交易日 ///@remark 只有登录成功后,才能得到正确的交易日 virtual const char *GetTradingDay() = 0; |
错误应答
响应
1 |
void OnRspError(CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {}; |
/չ
CThostFtdcRspInfoField
删除接口实例
1 2 3 |
///删除接口对象本身 ///@remark 不再使用本接口对象时,调用该函数删除接口对象 void Release() = 0; |
评论前必须登录!
注册