CTP量化投资API手册(2)TraderApi初始化与登录

创建TraderApi实例

///@param pszFlowPath 存贮订阅信息文件的目录，默认为当前目录
static CThostFtdcTraderApi *CreateFtdcTraderApi(const char *pszFlowPath = "");

1 2	///@param pszFlowPath 存贮订阅信息文件的目录，默认为当前目录 static CThostFtdcTraderApi CreateFtdcTraderApi(const char pszFlowPath = "");

注册回调接口

///@param pSpi 派生自回调接口类的实例
void RegisterSpi(CThostFtdcTraderSpi *pSpi) = 0;

1 2	///@param pSpi 派生自回调接口类的实例 void RegisterSpi(CThostFtdcTraderSpi *pSpi) = 0;

订阅私有流

///@param nResumeType 私有流重传方式  
///        THOST_TERT_RESTART:从本交易日开始重传
///        THOST_TERT_RESUME:从上次收到的续传
///        THOST_TERT_QUICK:只传送登录后私有流的内容
///@remark 该方法要在Init方法前调用。若不调用则不会收到私有流的数据。
void SubscribePrivateTopic(THOST_TE_RESUME_TYPE nResumeType) = 0;

///@param nResumeType 私有流重传方式

/// THOST_TERT_RESTART:从本交易日开始重传

/// THOST_TERT_RESUME:从上次收到的续传

/// THOST_TERT_QUICK:只传送登录后私有流的内容

///@remark 该方法要在Init方法前调用。若不调用则不会收到私有流的数据。

void SubscribePrivateTopic(THOST_TE_RESUME_TYPE nResumeType) = 0;

订阅公共流

///@param nResumeType 公共流重传方式  
///        THOST_TERT_RESTART:从本交易日开始重传
///        THOST_TERT_RESUME:从上次收到的续传
///        THOST_TERT_QUICK:只传送登录后公共流的内容
///@remark 该方法要在Init方法前调用。若不调用则不会收到公共流的数据。
void SubscribePublicTopic(THOST_TE_RESUME_TYPE nResumeType) = 0;

///@param nResumeType 公共流重传方式

/// THOST_TERT_RESTART:从本交易日开始重传

/// THOST_TERT_RESUME:从上次收到的续传

/// THOST_TERT_QUICK:只传送登录后公共流的内容

///@remark 该方法要在Init方法前调用。若不调用则不会收到公共流的数据。

void SubscribePublicTopic(THOST_TE_RESUME_TYPE nResumeType) = 0;

注册前置

///@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;

///@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;

初始化运行环境

///@remark 只有调用后,接口才开始工作
void Init() = 0;

1 2	///@remark 只有调用后,接口才开始工作 void Init() = 0;

连接建立响应

///当客户端与交易后台建立起通信连接时（还未登录前），该方法被调用。
void OnFrontConnected() {};

1 2	///当客户端与交易后台建立起通信连接时（还未登录前），该方法被调用。 void OnFrontConnected() {};

连接异常响应

///当客户端与交易后台通信连接断开时，该方法被调用。当发生这个情况后，API会自动重新连接，客户端可不做处理。
///@param nReason 错误原因
///        0x1001 网络读失败 4097
///        0x1002 网络写失败 4098
///        0x2001 接收心跳超时 8193
///        0x2002 发送心跳失败 8194
///        0x2003 收到错误报文 8195
void OnFrontDisconnected(int nReason) {};

///当长时间未收到报文时，该方法被调用。
///@param nTimeLapse 距离上次接收报文的时间
virtual void OnHeartBeatWarning(int nTimeLapse) {};

///当客户端与交易后台通信连接断开时，该方法被调用。当发生这个情况后，API会自动重新连接，客户端可不做处理。

///@param nReason 错误原因

/// 0x1001 网络读失败 4097

/// 0x1002 网络写失败 4098

/// 0x2001 接收心跳超时 8193

/// 0x2002 发送心跳失败 8194

/// 0x2003 收到错误报文 8195

void OnFrontDisconnected(int nReason) {};

///当长时间未收到报文时，该方法被调用。

///@param nTimeLapse 距离上次接收报文的时间

virtual void OnHeartBeatWarning(int nTimeLapse) {};

认证客户端

请求

int ReqAuthenticate(CThostFtdcReqAuthenticateField *pReqAuthenticateField, int nRequestID) = 0;

1	int ReqAuthenticate(CThostFtdcReqAuthenticateField *pReqAuthenticateField, int nRequestID) = 0;

响应

void OnRspAuthenticate(CThostFtdcRspAuthenticateField* pRspAuthenticateField, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

1	void OnRspAuthenticate(CThostFtdcRspAuthenticateField* pRspAuthenticateField, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

收缩/展开

CThostFtdcReqAuthenticateField

查询认证模式

请求

int ReqUserAuthMethod(CThostFtdcReqUserAuthMethodField *pReqUserAuthMethod, int nRequestID) = 0;

1	int ReqUserAuthMethod(CThostFtdcReqUserAuthMethodField *pReqUserAuthMethod, int nRequestID) = 0;

响应

void OnRspUserAuthMethod(CThostFtdcRspUserAuthMethodField* pRspUserAuthMethod, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

1	void OnRspUserAuthMethod(CThostFtdcRspUserAuthMethodField* pRspUserAuthMethod, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

收缩/展开

CThostFtdcReqUserAuthMethodField

收缩/展开

CThostFtdcRspUserAuthMethodField

注册用户终端信息

///用于中继服务器多连接模式
///需要在终端认证成功后，用户登录前调用该接口
int RegisterUserSystemInfo(CThostFtdcUserSystemInfoField *pUserSystemInfo) = 0;

///用于中继服务器多连接模式

///需要在终端认证成功后，用户登录前调用该接口

int RegisterUserSystemInfo(CThostFtdcUserSystemInfoField *pUserSystemInfo) = 0;

用户登录

请求

///用户登录请求
int ReqUserLogin(CThostFtdcReqUserLoginField *pReqUserLoginField, int nRequestID) = 0;

///用户发出获取图形验证码请求
int ReqGenUserCaptcha(CThostFtdcReqGenUserCaptchaField *pReqGenUserCaptcha, int nRequestID) = 0;
///用户发出带有图片验证码的登陆请求
int ReqUserLoginWithCaptcha(CThostFtdcReqUserLoginWithCaptchaField *pReqUserLoginWithCaptcha, int nRequestID) = 0;

///用户发出获取短信验证码请求
int ReqGenUserText(CThostFtdcReqGenUserTextField *pReqGenUserText, int nRequestID) = 0;
///用户发出带有短信验证码的登陆请求
int ReqUserLoginWithText(CThostFtdcReqUserLoginWithTextField *pReqUserLoginWithText, int nRequestID) = 0;

///用户发出带有动态口令的登陆请求
int ReqUserLoginWithOTP(CThostFtdcReqUserLoginWithOTPField *pReqUserLoginWithOTP, int nRequestID) = 0;

///用户登录请求

int ReqUserLogin(CThostFtdcReqUserLoginField *pReqUserLoginField, int nRequestID) = 0;

///用户发出获取图形验证码请求

int ReqGenUserCaptcha(CThostFtdcReqGenUserCaptchaField *pReqGenUserCaptcha, int nRequestID) = 0;

///用户发出带有图片验证码的登陆请求

int ReqUserLoginWithCaptcha(CThostFtdcReqUserLoginWithCaptchaField *pReqUserLoginWithCaptcha, int nRequestID) = 0;

///用户发出获取短信验证码请求

int ReqGenUserText(CThostFtdcReqGenUserTextField *pReqGenUserText, int nRequestID) = 0;

///用户发出带有短信验证码的登陆请求

int ReqUserLoginWithText(CThostFtdcReqUserLoginWithTextField *pReqUserLoginWithText, int nRequestID) = 0;

///用户发出带有动态口令的登陆请求

int ReqUserLoginWithOTP(CThostFtdcReqUserLoginWithOTPField *pReqUserLoginWithOTP, int nRequestID) = 0;

响应

///登录请求响应
void OnRspUserLogin(CThostFtdcRspUserLoginField* pRspUserLogin, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

///获取图形验证码请求的回复
virtual void OnRspGenUserCaptcha(CThostFtdcRspGenUserCaptchaField* pRspGenUserCaptcha, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};
///获取短信验证码请求的回复
virtual void OnRspGenUserText(CThostFtdcRspGenUserTextField* pRspGenUserText, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

///登录请求响应

void OnRspUserLogin(CThostFtdcRspUserLoginField* pRspUserLogin, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

///获取图形验证码请求的回复

virtual void OnRspGenUserCaptcha(CThostFtdcRspGenUserCaptchaField* pRspGenUserCaptcha, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

///获取短信验证码请求的回复

virtual void OnRspGenUserText(CThostFtdcRspGenUserTextField* pRspGenUserText, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

收缩/展开

CThostFtdcReqUserLoginField

收缩/展开

CThostFtdcRspUserLoginField

用户登出

请求

int ReqUserLogout(CThostFtdcUserLogoutField *pUserLogout, int nRequestID) = 0;

1	int ReqUserLogout(CThostFtdcUserLogoutField *pUserLogout, int nRequestID) = 0;

响应

void OnRspUserLogout(CThostFtdcUserLogoutField* pUserLogout, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

1	void OnRspUserLogout(CThostFtdcUserLogoutField* pUserLogout, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

收缩/展开

CThostFtdcUserLogoutField

查询投资者

请求

int ReqQryInvestor(CThostFtdcQryInvestorField *pQryInvestor, int nRequestID) = 0;

1	int ReqQryInvestor(CThostFtdcQryInvestorField *pQryInvestor, int nRequestID) = 0;

响应

void OnRspQryInvestor(CThostFtdcInvestorField* pInvestor, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

1	void OnRspQryInvestor(CThostFtdcInvestorField* pInvestor, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

收缩/展开

CThostFtdcQryInvestorField

更新用户口令

请求

int ReqUserPasswordUpdate(CThostFtdcUserPasswordUpdateField *pUserPasswordUpdate, int nRequestID) = 0;

1	int ReqUserPasswordUpdate(CThostFtdcUserPasswordUpdateField *pUserPasswordUpdate, int nRequestID) = 0;

响应

void OnRspUserPasswordUpdate(CThostFtdcUserPasswordUpdateField* pUserPasswordUpdate, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

1	void OnRspUserPasswordUpdate(CThostFtdcUserPasswordUpdateField* pUserPasswordUpdate, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

收缩/展开

CThostFtdcUserPasswordUpdateField

更新资金账户口令

请求

int ReqTradingAccountPasswordUpdate(CThostFtdcTradingAccountPasswordUpdateField *pTradingAccountPasswordUpdate, int nRequestID) = 0;

1	int ReqTradingAccountPasswordUpdate(CThostFtdcTradingAccountPasswordUpdateField *pTradingAccountPasswordUpdate, int nRequestID) = 0;

响应

void OnRspTradingAccountPasswordUpdate(CThostFtdcTradingAccountPasswordUpdateField* pTradingAccountPasswordUpdate, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

1	void OnRspTradingAccountPasswordUpdate(CThostFtdcTradingAccountPasswordUpdateField* pTradingAccountPasswordUpdate, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

收缩/展开

CThostFtdcTradingAccountPasswordUpdateField

查询监控中心用户令牌

请求

int ReqQueryCFMMCTradingAccountToken(CThostFtdcQueryCFMMCTradingAccountTokenField *pQueryCFMMCTradingAccountToken, int nRequestID) = 0;

1	int ReqQueryCFMMCTradingAccountToken(CThostFtdcQueryCFMMCTradingAccountTokenField *pQueryCFMMCTradingAccountToken, int nRequestID) = 0;

响应

void OnRspQueryCFMMCTradingAccountToken(CThostFtdcQueryCFMMCTradingAccountTokenField* pQueryCFMMCTradingAccountToken, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};
///保证金监控中心用户令牌
void OnRtnCFMMCTradingAccountToken(CThostFtdcCFMMCTradingAccountTokenField* pCFMMCTradingAccountToken) {};

void OnRspQueryCFMMCTradingAccountToken(CThostFtdcQueryCFMMCTradingAccountTokenField* pQueryCFMMCTradingAccountToken, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

///保证金监控中心用户令牌

void OnRtnCFMMCTradingAccountToken(CThostFtdcCFMMCTradingAccountTokenField* pCFMMCTradingAccountToken) {};

收缩/展开

CThostFtdcQueryCFMMCTradingAccountTokenField

确认结算单

请求

int ReqSettlementInfoConfirm(CThostFtdcSettlementInfoConfirmField *pSettlementInfoConfirm, int nRequestID) = 0;

1	int ReqSettlementInfoConfirm(CThostFtdcSettlementInfoConfirmField *pSettlementInfoConfirm, int nRequestID) = 0;

响应

void OnRspSettlementInfoConfirm(CThostFtdcSettlementInfoConfirmField* pSettlementInfoConfirm, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

1	void OnRspSettlementInfoConfirm(CThostFtdcSettlementInfoConfirmField* pSettlementInfoConfirm, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

收缩/展开

CThostFtdcSettlementInfoConfirmField

查询结算单确认信息

请求

int ReqQrySettlementInfoConfirm(CThostFtdcQrySettlementInfoConfirmField *pQrySettlementInfoConfirm, int nRequestID) = 0;

1	int ReqQrySettlementInfoConfirm(CThostFtdcQrySettlementInfoConfirmField *pQrySettlementInfoConfirm, int nRequestID) = 0;

响应

void OnRspQrySettlementInfoConfirm(CThostFtdcSettlementInfoConfirmField* pSettlementInfoConfirm, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

1	void OnRspQrySettlementInfoConfirm(CThostFtdcSettlementInfoConfirmField* pSettlementInfoConfirm, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

收缩/展开

CThostFtdcQrySettlementInfoConfirmField

查询结算单信息

请求

int ReqQrySettlementInfo(CThostFtdcQrySettlementInfoField *pQrySettlementInfo, int nRequestID) = 0;

1	int ReqQrySettlementInfo(CThostFtdcQrySettlementInfoField *pQrySettlementInfo, int nRequestID) = 0;

响应

void OnRspQrySettlementInfo(CThostFtdcSettlementInfoField* pSettlementInfo, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

1	void OnRspQrySettlementInfo(CThostFtdcSettlementInfoField* pSettlementInfo, CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

收缩/展开

CThostFtdcQrySettlementInfoField

线程等待

///等待接口线程结束运行
int Join() = 0;

1 2	///等待接口线程结束运行 int Join() = 0;

合约交易状态通知

void OnRtnInstrumentStatus(CThostFtdcInstrumentStatusField* pInstrumentStatus) {};

1	void OnRtnInstrumentStatus(CThostFtdcInstrumentStatusField* pInstrumentStatus) {};

获取API的版本信息

///@retrun 获取到的版本号
static const char *GetApiVersion();

1 2	///@retrun 获取到的版本号 static const char *GetApiVersion();

获取当前交易日

///@retrun 获取到的交易日
///@remark 只有登录成功后,才能得到正确的交易日
virtual const char *GetTradingDay() = 0;

///@retrun 获取到的交易日

///@remark 只有登录成功后,才能得到正确的交易日

virtual const char *GetTradingDay() = 0;

上报用户终端信息

///用于中继服务器操作员登录模式
///操作员登录后，可以多次调用该接口上报客户信息
int SubmitUserSystemInfo(CThostFtdcUserSystemInfoField *pUserSystemInfo) = 0;

///用于中继服务器操作员登录模式

///操作员登录后，可以多次调用该接口上报客户信息

int SubmitUserSystemInfo(CThostFtdcUserSystemInfoField *pUserSystemInfo) = 0;

错误应答

响应

void OnRspError(CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

1	void OnRspError(CThostFtdcRspInfoField* pRspInfo, int nRequestID, bool bIsLast) {};

收缩/展开

CThostFtdcRspInfoField

删除接口实例

///删除接口对象本身
///@remark 不再使用本接口对象时,调用该函数删除接口对象
void Release() = 0;

///删除接口对象本身

///@remark 不再使用本接口对象时,调用该函数删除接口对象

void Release() = 0;

AuthCode	认证码	char(17)
BrokerID	经纪公司代码	char(11)
UserID	用户代码	char(16)
UserProductInfo	用户端产品信息	char(11)

BrokerID	经纪公司代码	char(11)
UserID	用户代码	char(16)
UserProductInfo	用户端产品信息	char(11)

TradingDay	认证码	char(17)
BrokerID	经纪公司代码	char(11)
UserID	用户代码	char(16)

BrokerID	经纪公司代码	char(11)
ClientIPAddress	终端IP地址	char(16)
InterfaceProductInfo	接口端产品信息	char(11)
LoginRemark	登录备注	char(36)
MacAddress	Mac地址	char(21)
OneTimePassword	动态密码	char(41)
Password	密码	char(41)
ProtocolInfo	协议信息	char(11)
TradingDay	交易日	char(9)
UserID	用户代码	char(16)
UserProductInfo	用户端产品信息	char(11)

BrokerID	经纪公司代码	char(11)
CZCETime	郑商所时间	char(9)
DCETime	大商所时间	char(9)
FFEXTime	中金所时间	char(9)
FrontID	前置编号	int
INETime	能源中心时间	char(9)
LoginTime	登录成功时间	char(9)
MaxOrderRef	最大报单引用	char(13)
SHFETime	上期所时间	char(9)
SessionID	会话编号	int
SystemName	交易系统名称	char(41)
TradingDay	交易日	char(9)
UserID	用户代码	char(16)

Address	通讯地址	char(101)
BrokerID	经纪公司代码	char(11)
CommModelID	手续费率模板代码	char(13)
IdentifiedCardNo	证件号码	char(51)
IdentifiedCardType	证件类型	char(1) (‘组织机构代码 : 0’,) (‘中国公民身份证 : 1’,) (‘军官证 : 2’,) (‘警官证 : 3’,) (‘士兵证 : 4’,) (‘户口簿 : 5’,) (‘护照 : 6’,) (‘台胞证 : 7’,) (‘回乡证 : 8’,) (‘营业执照号 : 9’,) (‘税务登记号/当地纳税ID : A’,) (‘港澳居民来往内地通行证 : B’,) (‘台湾居民来往大陆通行证 : C’,) (‘驾照 : D’,) (‘当地社保ID : F’,) (‘当地身份证 : G’,) (‘商业登记证 : H’,) (‘港澳永久性居民身份证 : I’,) (‘人行开户许可证 : J’,) (‘其他证件 : x’,)
InvestorGroupID	投资者分组代码	char(13)
InvestorID	投资者代码	char(13)
InvestorName	投资者名称	char(81)
IsActive	是否活跃	int
MarginModelID	保证金率模板代码	char(13)
Mobile	手机	char(41)
OpenDate	开户日期	char(9)
Telephone	联系电话	char(41)

AccountID	投资者帐号	char(13)
BrokerID	经纪公司代码	char(11)
CurrencyID	币种代码	char(4)
NewPassword	新的口令	char(41)
OldPassword	原来的口令	char(41)

AccountID	投资者帐号	char(13)
BrokerID	经纪公司代码	char(11)
KeyID	密钥编号	int
ParticipantID	经纪公司统一编码	char(11)
Token	动态令牌	char(21)

创建TraderApi实例

注册回调接口

订阅私有流

订阅公共流

注册前置

初始化运行环境

连接建立响应

连接异常响应

认证客户端

请求

响应

查询认证模式

请求

响应

注册用户终端信息

用户登录

请求

响应

用户登出

请求

响应

查询投资者

请求

响应

更新用户口令

请求

响应

更新资金账户口令

请求

响应

查询监控中心用户令牌

请求

响应

确认结算单

请求

响应

查询结算单确认信息

请求

响应

查询结算单信息

请求

响应

线程等待

合约交易状态通知

获取API的版本信息

获取当前交易日

上报用户终端信息

错误应答

响应

删除接口实例

AlgoPlus

相关推荐

评论 抢沙发

评论前必须登录！

分类目录

云端套利条件单程序

当SimNow无法正常访问时

热门标签

知者不惑，仁者不忧，勇者不惧

你的认可是我们最大的动力！

微信扫一扫打赏

关注微信

回顶部

评论抢沙发