| Xlight API用户手册 v1.6.0.23 Xlight极速柜台接口文档

载入中...
搜索中...
未找到
Public 成员函数 | 所有成员列表
x1::XLTTradeSpi类 参考

交易回调类 更多...

`#include <xlt_trade_api.h>`

类 x1::XLTTradeSpi 继承关系图:

## 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)
| 订单簿消息：持仓变动通知回调

## 详细描述

交易回调类

## 构造及析构函数说明

## ◆ ~XLTTradeSpi()

virtual x1::XLTTradeSpi::~XLTTradeSpi | ( |  | ) |
| virtual default

## 成员函数说明

## ◆ on_asset()

virtual void x1::XLTTradeSpi::on_asset | ( | uint64_t | session_id,
|  | const xlt_msg_desc_t * | msg_desc,
|  | const xlt_asset_info_t * | asset_info )
| inline virtual

订单簿消息：资金变动通知回调

参数

  session_id | 会话ID
  msg_desc | 消息描述信息
  asset_info | 资金变动明细

## ◆ on_auth_trade()

virtual void x1::XLTTradeSpi::on_auth_trade | ( | uint64_t | session_id,
|  | uint64_t | request_id,
|  | uint64_t | trade_token,
|  | const xlt_error_info_t * | error_info )
| inline virtual

认证通知

参数

  session_id | 会话ID。
  request_id | 此消息响应函数对应的请求ID
  trade_token | 交易令牌，登录成功且需要认证时返回的交易令牌，后续API请求需要携带此令牌进行交易。
  error_info | 认证请求发生错误时返回的错误信息，当error_info为空，或者error_info.error_id为0时，表明没有错误。

## ◆ on_cancel_response()

virtual void x1::XLTTradeSpi::on_cancel_response | ( | uint64_t | session_id,
|  | const xlt_msg_desc_t * | msg_desc,
|  | const xlt_cancel_response_t * | cancel_response )
| inline virtual

撤单成功响应 此函数用于处理来自交易系统的撤单成功响应。 subscribe_trade_message或rebuild_trade_message指定消息类型包含TradeMessageType::REPORT时，交易系统会在撤单成功后推送该响应。

参数

  session_id | 会话ID。
  msg_desc | 消息描述信息
  cancel_response | 撤单成功响应数据指针。

## ◆ on_cluster_fund_transfer_request()

virtual void x1::XLTTradeSpi::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 )
| inline virtual

双中心资金划拨请求推送 subscribe_trade_message或rebuild_trade_message指定任意消息类型时，交易系统会在收到双中心资金划拨请求时推送该通知。

参数

  session_id | 会话id，登录时得到
  msg_desc | 消息描述信息
  cluster_fund_transfer_request | 双中心资金划拨请求

## ◆ on_cluster_fund_transfer_result()

virtual void x1::XLTTradeSpi::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 )
| inline virtual

双中心资金划转结果回调 subscribe_trade_message或rebuild_trade_message指定任意消息类型时，交易系统会在收到双中心资金划拨结果时推送该通知。

参数

  session_id | 会话ID
  msg_desc | 消息描述信息
  cluster_fund_transfer_result | 双中心资金划转结果

## ◆ on_counter_fund_transfer_request()

virtual void x1::XLTTradeSpi::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 )
| inline virtual

主柜资金划拨请求推送 subscribe_trade_message或rebuild_trade_message指定任意消息类型时，交易系统会在收到主柜资金划拨请求时推送该通知。

参数

  session_id | 会话id，登录时得到
  msg_desc | 消息描述信息
  fund_transfer_request | 资金划拨请求

## ◆ on_counter_fund_transfer_result()

virtual void x1::XLTTradeSpi::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 )
| inline virtual

主柜资金划拨结果回调 subscribe_trade_message或rebuild_trade_message指定任意消息类型时，交易系统会在收到主柜资金划拨结果时推送该通知。

参数

  session_id | 会话ID
  msg_desc | 消息描述信息
  fund_transfer_result | 资金划转结果

## ◆ on_disconnect()

virtual void x1::XLTTradeSpi::on_disconnect | ( | uint64_t | session_id | ) |
| inline virtual

断线通知 用户断线之后需要重新调用login方法，建立连接并登录

参数

  session_id | 会话ID。

## ◆ on_login()

virtual void x1::XLTTradeSpi::on_login | ( | uint64_t | session_id,
|  | uint64_t | request_id,
|  | const xlt_error_info_t * | error_info )
| inline virtual

登录通知

参数

  session_id | 本次登录生成的会话ID。如果登录失败则为0。
  request_id | 此消息响应函数对应的请求ID
  error_info | 登录请求发生错误时返回的错误信息，当error_info为空，或者error_info.error_id为0时，表明没有错误。

## ◆ on_order_book_error()

virtual void x1::XLTTradeSpi::on_order_book_error | ( | uint64_t | session_id,
|  | const xlt_msg_desc_t * | msg_desc,
|  | const xlt_order_book_error_t * | order_error )
| inline virtual

订单簿消息：订单错误通知回调

参数

  session_id | 会话ID
  msg_desc | 消息描述信息
  order_error | 订单错误明细

## ◆ on_order_book_insert()

virtual void x1::XLTTradeSpi::on_order_book_insert | ( | uint64_t | session_id,
|  | const xlt_msg_desc_t * | msg_desc,
|  | const xlt_order_book_insert_t * | order_insert )
| inline virtual

订单簿消息：新订单通知回调

参数

  session_id | 会话ID
  msg_desc | 消息描述信息
  order_insert | 订单委托明细

## ◆ on_order_book_update()

virtual void x1::XLTTradeSpi::on_order_book_update | ( | uint64_t | session_id,
|  | const xlt_msg_desc_t * | msg_desc,
|  | const xlt_order_book_update_t * | order_update )
| inline virtual

订单簿消息：订单变动通知回调

参数

  session_id | 会话ID
  msg_desc | 消息描述信息
  order_update | 订单响应明细

## ◆ on_order_end()

virtual void x1::XLTTradeSpi::on_order_end | ( | uint64_t | session_id,
|  | const xlt_msg_desc_t * | msg_desc,
|  | const xlt_order_end_t * | order_end )
| inline virtual

订单结束通知 本函数用于接收订单结束通知；当订单状态变为完全成交、撤单成功、废单等终结状态时，交易系统会发送该通知。 subscribe_trade_message或rebuild_trade_message指定消息类型包含TradeMessageType::REPORT时，交易系统会在订单结束时推送该通知。

参数

  session_id | 会话ID。
  msg_desc | 消息描述信息
  order_end | 包含订单结束信息的数据指针。

## ◆ on_order_error_response()

virtual void x1::XLTTradeSpi::on_order_error_response | ( | uint64_t | session_id,
|  | const xlt_msg_desc_t * | msg_desc,
|  | const xlt_order_error_response_t * | order_error_response )
| inline virtual

委托失败通知 此函数用于处理来自交易系统的委托失败通知。 包括内部拒单、交易所拒单、废单及撤单失败等情况。 subscribe_trade_message或rebuild_trade_message指定消息类型包含TradeMessageType::REPORT时，交易系统会在订单委托失败时推送该通知。

参数

  session_id | 会话ID。
  msg_desc | 消息描述信息
  order_error_response | 委托失败通知数据指针。

## ◆ on_order_response()

virtual void x1::XLTTradeSpi::on_order_response | ( | uint64_t | session_id,
|  | const xlt_msg_desc_t * | msg_desc,
|  | const xlt_order_response_t * | order_response )
| inline virtual

新订单申报成功响应 此函数用于处理来自交易系统的申报成功响应。 subscribe_trade_message或rebuild_trade_message指定消息类型包含TradeMessageType::REPORT时，交易系统会在订单申报成功后推送该响应。

参数

  session_id | 会话ID。
  msg_desc | 消息描述信息
  order_response | 申报成功响应数据指针。

## ◆ on_order_timeout()

virtual void x1::XLTTradeSpi::on_order_timeout | ( | uint64_t | session_id,
|  | uint64_t | xid )
| inline virtual

订单超时通知

参数

  session_id | 会话id，登录时得到
  xid | 超时的订单标识

备注
  订单超时通知是指在指定时间内未收到订单的成交回报或状态更新时触发的通知，不代表委托失败，需要用户自行查询确认订单状态。

## ◆ on_position()

virtual void x1::XLTTradeSpi::on_position | ( | uint64_t | session_id,
|  | const xlt_msg_desc_t * | msg_desc,
|  | const xlt_position_info_t * | position_info )
| inline virtual

订单簿消息：持仓变动通知回调

参数

  session_id | 会话ID
  msg_desc | 消息描述信息
  position_info | 持仓变动明细

## ◆ on_query_assets()

virtual void x1::XLTTradeSpi::on_query_assets | ( | uint64_t | session_id,
|  | uint64_t | request_id,
|  | const XLTAssetList * | assets,
|  | bool | is_last,
|  | const xlt_error_info_t * | error_info )
| inline virtual

资金查询响应

参数

  session_id | 会话id，登录时得到
  request_id | 此消息响应函数对应的请求ID
  assets | 查询到的资金账户列表情况，个数由data_count决定
  is_last | 此消息响应函数是否为request_id这条请求所对应的最后一个响应，当为最后一个的时候为true，如果为false，表示还有其他后续消息响应
  error_info | 查询资金账户发生错误时返回的错误信息，当error_info为空，或者error_info.error_id为0时，表明没有错误

备注
  需要快速返回，否则会堵塞后续消息，当堵塞严重时，会触发断线

## ◆ on_query_init_assets()

virtual void x1::XLTTradeSpi::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 )
| inline virtual

请求查询初始资产响应

参数

  session_id | 会话id，登录时得到
  request_id | 此消息响应函数对应的请求ID
  init_assets | 查询到的初始化资产信息列表
  is_last | 此消息响应函数是否为request_id这条请求所对应的最后一个响应，当为最后一个的时候为true，如果为false，表示还有其他后续消息响应
  error_info | 查询发生错误时，返回的错误信息，当error_info为空，或者error_info.error_id为0时，表明没有错误

## ◆ on_query_init_positions()

virtual void x1::XLTTradeSpi::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 )
| inline virtual

请求查询初始持仓响应

参数

  session_id | 会话id，登录时得到
  request_id | 此消息响应函数对应的请求ID
  init_positions | 查询到的初始化持仓信息列表
  is_last | 此消息响应函数是否为request_id这条请求所对应的最后一个响应，当为最后一个的时候为true，如果为false，表示还有其他后续消息响应
  error_info | 查询发生错误时，返回的错误信息，当error_info为空，或者error_info.error_id为0时，表明没有错误

## ◆ on_query_orders()

virtual void x1::XLTTradeSpi::on_query_orders | ( | uint64_t | session_id,
|  | uint64_t | request_id,
|  | const XLTOrderList * | orders,
|  | bool | is_last,
|  | const xlt_error_info_t * | error_info )
| inline virtual

订单查询响应

参数

  session_id | 会话id，登录时得到
  request_id | 此消息响应函数对应的请求ID
  orders | 本次响应返回的订单信息，个数由data_count决定
  is_last | 此消息响应函数是否为request_id这条请求所对应的最后一个响应，当为最后一个的时候为true，如果为false，表示还有其他后续消息响应
  error_info | 查询订单时发生错误时，返回的错误信息，当error_info为空，或者error_info.error_id为0时，表明没有错误

备注
  需要快速返回，否则会堵塞后续消息，当堵塞严重时，会触发断线

## ◆ on_query_orders_by_page()

virtual void x1::XLTTradeSpi::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 )
| inline virtual

分页请求查询报单响应

参数

  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时，表明没有错误

备注
  当order_sequence为0，表明当次查询没有查到任何记录，当is_last为true时，如果order_sequence等于req_count，那么表示还有报单，可以进行下一次分页查询，如果不等，表示所有报单已经查询完毕。一个查询请求可能对应多个响应，需要快速返回，否则会堵塞后续消息，当堵塞严重时，会触发断线。

## ◆ on_query_positions()

virtual void x1::XLTTradeSpi::on_query_positions | ( | uint64_t | session_id,
|  | uint64_t | request_id,
|  | const XLTPositionList * | positions,
|  | bool | is_last,
|  | const xlt_error_info_t * | error_info )
| inline virtual

持仓查询响应

参数

  session_id | 会话id，登录时得到
  request_id | 此消息响应函数对应的请求ID
  positions | 本次响应返回的持仓列表，个数由data_count决定
  is_last | 此消息响应函数是否为request_id这条请求所对应的最后一个响应，当为最后一个的时候为true，如果为false，表示还有其他后续消息响应
  error_info | 查询账户持仓发生错误时返回的错误信息，当error_info为空，或者error_info.error_id为0时，表明没有错误

备注
  一个查询请求可能对应多个响应，需要快速返回，否则会堵塞后续消息，当堵塞严重时，会触发断线

## ◆ on_query_trade_account_info()

virtual void x1::XLTTradeSpi::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 )
| inline virtual

请求查询交易账号信息响应

参数

  session_id | 会话id，登录时得到
  request_id | 此消息响应函数对应的请求ID
  trade_account_infos | 查询到的信息列表
  is_last | 此消息响应函数是否为request_id这条请求所对应的最后一个响应，当为最后一个的时候为true，如果为false，表示还有其他后续消息响应
  error_info | 查询发生错误时，返回的错误信息，当error_info为空，或者error_info.error_id为0时，表明没有错误

## ◆ on_query_trades()

virtual void x1::XLTTradeSpi::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 )
| inline virtual

成交回报查询响应

参数

  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时，表明没有错误

备注
  需要快速返回，否则会堵塞后续消息，当堵塞严重时，会触发断线

## ◆ on_raw_report()

virtual void x1::XLTTradeSpi::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 )
| inline virtual

交易所原始订单执行报告（需用户自行解码） 此函数用于接收原始的订单执行报告。报告内容包括但不限于订单状态、执行细节等。 由于报告是原始形式，因此需要用户自行解码以获取具体信息。 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 | 报告数据的指针，具体内容依赖于报告类型，需用户自行解码。

## ◆ on_rebuild_trade_message()

virtual void x1::XLTTradeSpi::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 )
| inline virtual

重推通知响应

参数

  session_id | 会话ID。
  request_id | 此消息响应函数对应的请求ID
  start_sequence | 重推请求起始序号，为用户请求的start_sequence
  end_sequence | 重推请求结束序号，为用户请求的end_sequence
  error_info | 发生错误时返回的错误信息，当error_info为空，或者error_info.error_id为0时，表明没有错误。

## ◆ on_subscribe_trade_message()

virtual void x1::XLTTradeSpi::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 )
| inline virtual

订阅通知响应

参数

  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时，表明没有错误。

## ◆ on_trade_report()

virtual void x1::XLTTradeSpi::on_trade_report | ( | uint64_t | session_id,
|  | const xlt_msg_desc_t * | msg_desc,
|  | const xlt_trade_report_t * | trade_report )
| inline virtual

成交回报通知 此函数用于处理来自交易系统的成交回报通知。 subscribe_trade_message或rebuild_trade_message指定消息类型包含TradeMessageType::REPORT时，交易系统会在订单发生成交时推送该通知。

参数

  session_id | 会话ID。
  msg_desc | 消息描述信息
  trade_report | 成交回报通知数据指针。

该类的文档由以下文件生成:

- xlt_trade_api.h