![]() |
Xlight API用户手册 v1.6.0.23
Xlight极速柜台接口文档
|
交易回调类 更多...
#include <xlt_trade_api.h>
Public 成员函数 | |
| virtual | ~XLTTradeSpi ()=default |
| virtual void | on_disconnect (uint64_t session_id) |
| 断线通知 用户断线之后需要重新调用login方法,建立连接并登录 | |
| virtual void | on_order_timeout (uint64_t session_id, uint64_t xid) |
| 订单超时通知 | |
| virtual void | on_login (uint64_t session_id, uint64_t request_id, const xlt_error_info_t *error_info) |
| 登录通知 | |
| virtual void | on_auth_trade (uint64_t session_id, uint64_t request_id, uint64_t trade_token, const xlt_error_info_t *error_info) |
| 认证通知 | |
| virtual void | on_subscribe_trade_message (uint64_t session_id, uint64_t request_id, uint64_t start_sequence, uint64_t latest_sequence, const xlt_error_info_t *error_info) |
| 订阅通知响应 | |
| virtual void | on_rebuild_trade_message (uint64_t session_id, uint64_t request_id, uint64_t start_sequence, uint64_t end_sequence, const xlt_error_info_t *error_info) |
| 重推通知响应 | |
| virtual void | on_query_positions (uint64_t session_id, uint64_t request_id, const XLTPositionList *positions, bool is_last, const xlt_error_info_t *error_info) |
| 持仓查询响应 | |
| virtual void | on_query_assets (uint64_t session_id, uint64_t request_id, const XLTAssetList *assets, bool is_last, const xlt_error_info_t *error_info) |
| 资金查询响应 | |
| virtual void | on_query_orders (uint64_t session_id, uint64_t request_id, const XLTOrderList *orders, bool is_last, const xlt_error_info_t *error_info) |
| 订单查询响应 | |
| virtual void | on_query_orders_by_page (uint64_t session_id, uint64_t request_id, const XLTOrderList *order_infos, uint64_t req_count, uint64_t rsp_count, const xlt_page_query_reference_t *query_reference, bool is_last, const xlt_error_info_t *error_info) |
| 分页请求查询报单响应 | |
| virtual void | on_query_trades (uint64_t session_id, uint64_t request_id, const XLTTradeReportList *trade_reports, bool is_last, const xlt_error_info_t *error_info) |
| 成交回报查询响应 | |
| virtual void | on_query_init_assets (uint64_t session_id, uint64_t request_id, const XLTInitAssetList *init_assets, bool is_last, const xlt_error_info_t *error_info) |
| 请求查询初始资产响应 | |
| virtual void | on_query_init_positions (uint64_t session_id, uint64_t request_id, const XLTInitPositionList *init_positions, bool is_last, const xlt_error_info_t *error_info) |
| 请求查询初始持仓响应 | |
| virtual void | on_query_trade_account_info (uint64_t session_id, uint64_t request_id, const XLTTradeAccountInfoList *trade_account_infos, bool is_last, const xlt_error_info_t *error_info) |
| 请求查询交易账号信息响应 | |
| virtual void | on_order_response (uint64_t session_id, const xlt_msg_desc_t *msg_desc, const xlt_order_response_t *order_response) |
| 新订单申报成功响应 此函数用于处理来自交易系统的申报成功响应。 subscribe_trade_message或rebuild_trade_message指定消息类型包含TradeMessageType::REPORT时,交易系统会在订单申报成功后推送该响应。 | |
| virtual void | on_cancel_response (uint64_t session_id, const xlt_msg_desc_t *msg_desc, const xlt_cancel_response_t *cancel_response) |
| 撤单成功响应 此函数用于处理来自交易系统的撤单成功响应。 subscribe_trade_message或rebuild_trade_message指定消息类型包含TradeMessageType::REPORT时,交易系统会在撤单成功后推送该响应。 | |
| virtual void | on_trade_report (uint64_t session_id, const xlt_msg_desc_t *msg_desc, const xlt_trade_report_t *trade_report) |
| 成交回报通知 此函数用于处理来自交易系统的成交回报通知。 subscribe_trade_message或rebuild_trade_message指定消息类型包含TradeMessageType::REPORT时,交易系统会在订单发生成交时推送该通知。 | |
| virtual void | on_order_error_response (uint64_t session_id, const xlt_msg_desc_t *msg_desc, const xlt_order_error_response_t *order_error_response) |
| 委托失败通知 此函数用于处理来自交易系统的委托失败通知。 包括内部拒单、交易所拒单、废单及撤单失败等情况。 subscribe_trade_message或rebuild_trade_message指定消息类型包含TradeMessageType::REPORT时,交易系统会在订单委托失败时推送该通知。 | |
| virtual void | on_order_end (uint64_t session_id, const xlt_msg_desc_t *msg_desc, const xlt_order_end_t *order_end) |
| 订单结束通知 本函数用于接收订单结束通知;当订单状态变为完全成交、撤单成功、废单等终结状态时,交易系统会发送该通知。 subscribe_trade_message或rebuild_trade_message指定消息类型包含TradeMessageType::REPORT时,交易系统会在订单结束时推送该通知。 | |
| virtual void | on_raw_report (uint64_t session_id, const xlt_msg_desc_t *msg_desc, uint8_t client_id, uint64_t xid, char report_id[32], ExchangeIndex exchange_index, uint16_t platform_type, uint16_t gateway_index, uint32_t report_size, char *raw_report) |
| 交易所原始订单执行报告(需用户自行解码) 此函数用于接收原始的订单执行报告。报告内容包括但不限于订单状态、执行细节等。 由于报告是原始形式,因此需要用户自行解码以获取具体信息。 subscribe_trade_message或rebuild_trade_message指定消息类型包含TradeMessageType::RAW_REPORT时,交易系统会在订单状态变更时推送该通知。 | |
| virtual void | on_counter_fund_transfer_request (uint64_t session_id, const xlt_msg_desc_t *msg_desc, const xlt_counter_fund_transfer_request_t *fund_transfer_request) |
| 主柜资金划拨请求推送 subscribe_trade_message或rebuild_trade_message指定任意消息类型时,交易系统会在收到主柜资金划拨请求时推送该通知。 | |
| virtual void | on_counter_fund_transfer_result (uint64_t session_id, const xlt_msg_desc_t *msg_desc, const xlt_counter_fund_transfer_result_t *fund_transfer_result) |
| 主柜资金划拨结果回调 subscribe_trade_message或rebuild_trade_message指定任意消息类型时,交易系统会在收到主柜资金划拨结果时推送该通知。 | |
| virtual void | on_cluster_fund_transfer_request (uint64_t session_id, const xlt_msg_desc_t *msg_desc, const xlt_cluster_fund_transfer_request_t *cluster_fund_transfer_request) |
| 双中心资金划拨请求推送 subscribe_trade_message或rebuild_trade_message指定任意消息类型时,交易系统会在收到双中心资金划拨请求时推送该通知。 | |
| virtual void | on_cluster_fund_transfer_result (uint64_t session_id, const xlt_msg_desc_t *msg_desc, const xlt_cluster_fund_transfer_result_t *cluster_fund_transfer_result) |
| 双中心资金划转结果回调 subscribe_trade_message或rebuild_trade_message指定任意消息类型时,交易系统会在收到双中心资金划拨结果时推送该通知。 | |
| virtual void | on_order_book_insert (uint64_t session_id, const xlt_msg_desc_t *msg_desc, const xlt_order_book_insert_t *order_insert) |
| 订单簿消息:新订单通知回调 | |
| virtual void | on_order_book_update (uint64_t session_id, const xlt_msg_desc_t *msg_desc, const xlt_order_book_update_t *order_update) |
| 订单簿消息:订单变动通知回调 | |
| virtual void | on_order_book_error (uint64_t session_id, const xlt_msg_desc_t *msg_desc, const xlt_order_book_error_t *order_error) |
| 订单簿消息:订单错误通知回调 | |
| virtual void | on_asset (uint64_t session_id, const xlt_msg_desc_t *msg_desc, const xlt_asset_info_t *asset_info) |
| 订单簿消息:资金变动通知回调 | |
| virtual void | on_position (uint64_t session_id, const xlt_msg_desc_t *msg_desc, const xlt_position_info_t *position_info) |
| 订单簿消息:持仓变动通知回调 | |
交易回调类
|
virtualdefault |
|
inlinevirtual |
订单簿消息:资金变动通知回调
| session_id | 会话ID |
| msg_desc | 消息描述信息 |
| asset_info | 资金变动明细 |
|
inlinevirtual |
认证通知
| session_id | 会话ID。 |
| request_id | 此消息响应函数对应的请求ID |
| trade_token | 交易令牌,登录成功且需要认证时返回的交易令牌,后续API请求需要携带此令牌进行交易。 |
| error_info | 认证请求发生错误时返回的错误信息,当error_info为空,或者error_info.error_id为0时,表明没有错误。 |
|
inlinevirtual |
撤单成功响应 此函数用于处理来自交易系统的撤单成功响应。 subscribe_trade_message或rebuild_trade_message指定消息类型包含TradeMessageType::REPORT时,交易系统会在撤单成功后推送该响应。
| session_id | 会话ID。 |
| msg_desc | 消息描述信息 |
| cancel_response | 撤单成功响应数据指针。 |
|
inlinevirtual |
双中心资金划拨请求推送 subscribe_trade_message或rebuild_trade_message指定任意消息类型时,交易系统会在收到双中心资金划拨请求时推送该通知。
| session_id | 会话id,登录时得到 |
| msg_desc | 消息描述信息 |
| cluster_fund_transfer_request | 双中心资金划拨请求 |
|
inlinevirtual |
双中心资金划转结果回调 subscribe_trade_message或rebuild_trade_message指定任意消息类型时,交易系统会在收到双中心资金划拨结果时推送该通知。
| session_id | 会话ID |
| msg_desc | 消息描述信息 |
| cluster_fund_transfer_result | 双中心资金划转结果 |
|
inlinevirtual |
主柜资金划拨请求推送 subscribe_trade_message或rebuild_trade_message指定任意消息类型时,交易系统会在收到主柜资金划拨请求时推送该通知。
| session_id | 会话id,登录时得到 |
| msg_desc | 消息描述信息 |
| fund_transfer_request | 资金划拨请求 |
|
inlinevirtual |
主柜资金划拨结果回调 subscribe_trade_message或rebuild_trade_message指定任意消息类型时,交易系统会在收到主柜资金划拨结果时推送该通知。
| session_id | 会话ID |
| msg_desc | 消息描述信息 |
| fund_transfer_result | 资金划转结果 |
|
inlinevirtual |
断线通知 用户断线之后需要重新调用login方法,建立连接并登录
| session_id | 会话ID。 |
|
inlinevirtual |
登录通知
| session_id | 本次登录生成的会话ID。如果登录失败则为0。 |
| request_id | 此消息响应函数对应的请求ID |
| error_info | 登录请求发生错误时返回的错误信息,当error_info为空,或者error_info.error_id为0时,表明没有错误。 |
|
inlinevirtual |
订单簿消息:订单错误通知回调
| session_id | 会话ID |
| msg_desc | 消息描述信息 |
| order_error | 订单错误明细 |
|
inlinevirtual |
订单簿消息:新订单通知回调
| session_id | 会话ID |
| msg_desc | 消息描述信息 |
| order_insert | 订单委托明细 |
|
inlinevirtual |
订单簿消息:订单变动通知回调
| session_id | 会话ID |
| msg_desc | 消息描述信息 |
| order_update | 订单响应明细 |
|
inlinevirtual |
订单结束通知 本函数用于接收订单结束通知;当订单状态变为完全成交、撤单成功、废单等终结状态时,交易系统会发送该通知。 subscribe_trade_message或rebuild_trade_message指定消息类型包含TradeMessageType::REPORT时,交易系统会在订单结束时推送该通知。
| session_id | 会话ID。 |
| msg_desc | 消息描述信息 |
| order_end | 包含订单结束信息的数据指针。 |
|
inlinevirtual |
委托失败通知 此函数用于处理来自交易系统的委托失败通知。 包括内部拒单、交易所拒单、废单及撤单失败等情况。 subscribe_trade_message或rebuild_trade_message指定消息类型包含TradeMessageType::REPORT时,交易系统会在订单委托失败时推送该通知。
| session_id | 会话ID。 |
| msg_desc | 消息描述信息 |
| order_error_response | 委托失败通知数据指针。 |
|
inlinevirtual |
新订单申报成功响应 此函数用于处理来自交易系统的申报成功响应。 subscribe_trade_message或rebuild_trade_message指定消息类型包含TradeMessageType::REPORT时,交易系统会在订单申报成功后推送该响应。
| session_id | 会话ID。 |
| msg_desc | 消息描述信息 |
| order_response | 申报成功响应数据指针。 |
|
inlinevirtual |
订单超时通知
| session_id | 会话id,登录时得到 |
| xid | 超时的订单标识 |
|
inlinevirtual |
订单簿消息:持仓变动通知回调
| session_id | 会话ID |
| msg_desc | 消息描述信息 |
| position_info | 持仓变动明细 |
|
inlinevirtual |
资金查询响应
| session_id | 会话id,登录时得到 |
| request_id | 此消息响应函数对应的请求ID |
| assets | 查询到的资金账户列表情况,个数由data_count决定 |
| is_last | 此消息响应函数是否为request_id这条请求所对应的最后一个响应,当为最后一个的时候为true,如果为false,表示还有其他后续消息响应 |
| error_info | 查询资金账户发生错误时返回的错误信息,当error_info为空,或者error_info.error_id为0时,表明没有错误 |
|
inlinevirtual |
请求查询初始资产响应
| session_id | 会话id,登录时得到 |
| request_id | 此消息响应函数对应的请求ID |
| init_assets | 查询到的初始化资产信息列表 |
| is_last | 此消息响应函数是否为request_id这条请求所对应的最后一个响应,当为最后一个的时候为true,如果为false,表示还有其他后续消息响应 |
| error_info | 查询发生错误时,返回的错误信息,当error_info为空,或者error_info.error_id为0时,表明没有错误 |
|
inlinevirtual |
请求查询初始持仓响应
| session_id | 会话id,登录时得到 |
| request_id | 此消息响应函数对应的请求ID |
| init_positions | 查询到的初始化持仓信息列表 |
| is_last | 此消息响应函数是否为request_id这条请求所对应的最后一个响应,当为最后一个的时候为true,如果为false,表示还有其他后续消息响应 |
| error_info | 查询发生错误时,返回的错误信息,当error_info为空,或者error_info.error_id为0时,表明没有错误 |
|
inlinevirtual |
订单查询响应
| session_id | 会话id,登录时得到 |
| request_id | 此消息响应函数对应的请求ID |
| orders | 本次响应返回的订单信息,个数由data_count决定 |
| is_last | 此消息响应函数是否为request_id这条请求所对应的最后一个响应,当为最后一个的时候为true,如果为false,表示还有其他后续消息响应 |
| error_info | 查询订单时发生错误时,返回的错误信息,当error_info为空,或者error_info.error_id为0时,表明没有错误 |
|
inlinevirtual |
分页请求查询报单响应
| session_id | 会话id,登录时得到 |
| request_id | 此消息响应函数对应的请求ID |
| order_infos | 查询到的订单列表 |
| req_count | 分页请求的最大数量 |
| rsp_count | 分页请求的当前回报数量 |
| query_reference | 当前报单信息所对应的查询索引,需要记录下来,在进行下一次分页查询的时候需要用到 |
| is_last | 此消息响应函数是否为request_id这条请求所对应的最后一个响应,当为最后一个的时候为true,如果为false,表示还有其他后续消息响应 |
| error_info | 查询报单时发生错误时,返回的错误信息,当error_info为空,或者error_info.error_id为0时,表明没有错误 |
|
inlinevirtual |
持仓查询响应
| session_id | 会话id,登录时得到 |
| request_id | 此消息响应函数对应的请求ID |
| positions | 本次响应返回的持仓列表,个数由data_count决定 |
| is_last | 此消息响应函数是否为request_id这条请求所对应的最后一个响应,当为最后一个的时候为true,如果为false,表示还有其他后续消息响应 |
| error_info | 查询账户持仓发生错误时返回的错误信息,当error_info为空,或者error_info.error_id为0时,表明没有错误 |
|
inlinevirtual |
请求查询交易账号信息响应
| session_id | 会话id,登录时得到 |
| request_id | 此消息响应函数对应的请求ID |
| trade_account_infos | 查询到的信息列表 |
| is_last | 此消息响应函数是否为request_id这条请求所对应的最后一个响应,当为最后一个的时候为true,如果为false,表示还有其他后续消息响应 |
| error_info | 查询发生错误时,返回的错误信息,当error_info为空,或者error_info.error_id为0时,表明没有错误 |
|
inlinevirtual |
成交回报查询响应
| session_id | 会话id,登录时得到 |
| request_id | 此消息响应函数对应的请求ID |
| trade_reports | 本次响应返回的成交信息,个数由data_count决定 |
| is_last | 此消息响应函数是否为request_id这条请求所对应的最后一个响应,当为最后一个的时候为true,如果为false,表示还有其他后续消息响应 |
| error_info | 查询发生错误时,返回的错误信息,当error_info为空,或者error_info.error_id为0时,表明没有错误 |
|
inlinevirtual |
交易所原始订单执行报告(需用户自行解码) 此函数用于接收原始的订单执行报告。报告内容包括但不限于订单状态、执行细节等。 由于报告是原始形式,因此需要用户自行解码以获取具体信息。 subscribe_trade_message或rebuild_trade_message指定消息类型包含TradeMessageType::RAW_REPORT时,交易系统会在订单状态变更时推送该通知。
| session_id | 会话ID。 |
| msg_desc | 消息描述信息 |
| client_id | 委托源标识,用户登录时自定义 |
| xid | 报单标识,通常是订单的唯一标识符。 |
| report_id | 回报标识,32字节,非字符串。 |
| exchange_index | 交易所索引,表示报告来自哪个交易所。 |
| platform_type | 平台类型 |
| gateway_index | 网关索引 |
| report_size | 回报长度 |
| raw_report | 报告数据的指针,具体内容依赖于报告类型,需用户自行解码。 |
|
inlinevirtual |
重推通知响应
| session_id | 会话ID。 |
| request_id | 此消息响应函数对应的请求ID |
| start_sequence | 重推请求起始序号,为用户请求的start_sequence |
| end_sequence | 重推请求结束序号,为用户请求的end_sequence |
| error_info | 发生错误时返回的错误信息,当error_info为空,或者error_info.error_id为0时,表明没有错误。 |
|
inlinevirtual |
订阅通知响应
| session_id | 会话ID。 |
| request_id | 此消息响应函数对应的请求ID |
| start_sequence | 订阅请求起始序号,如果是RESTART则为0,如果QUICK则为latest_sequence,如果SPECIFY则为用户请求的start_sequence |
| latest_sequence | AGW端最新的序列号 |
| error_info | 发生错误时返回的错误信息,当error_info为空,或者error_info.error_id为0时,表明没有错误。 |
|
inlinevirtual |
成交回报通知 此函数用于处理来自交易系统的成交回报通知。 subscribe_trade_message或rebuild_trade_message指定消息类型包含TradeMessageType::REPORT时,交易系统会在订单发生成交时推送该通知。
| session_id | 会话ID。 |
| msg_desc | 消息描述信息 |
| trade_report | 成交回报通知数据指针。 |