成交与净额

成交数据用于确认订单是否真正执行。交易系统不能只看“订单提交成功”，还要看成交回报、成交数量、成交价格、佣金和结算相关数据。

官方参考：Client Portal API

常用接口

接口	方法	用途
/iserver/account/trades	GET	查询近期成交。
/iserver/account/orders	GET	配合查询订单状态。
/iserver/account/order/status/{orderId}	GET	查询单个订单状态。

成交结构

返回通常是成交数组。下面是字段结构示例，成交编号、时间、价格和数量以实际账户返回为准：

[
  {
    "execution_id": "成交唯一编号",
    "symbol": "AAPL",
    "side": "B",
    "order_description": "BUY 1 AAPL",
    "trade_time": "成交时间",
    "trade_price": "成交价格",
    "trade_qty": "成交数量"
  }
]

字段解释：

字段	中文说明
execution_id	成交编号，用于去重和审计。
symbol	交易代码。
side	买卖方向。
order_description	订单描述。
trade_time	成交时间。
trade_price	成交价格。
trade_qty	成交数量。

净额处理是什么意思

“净额”可以理解为把多笔成交、费用、买卖方向和头寸变化汇总成账户层面的净结果。它常用于盘后核对，而不是下单前判断。

开发时建议分开保存：

数据	用途
原始成交回报	审计、排错、还原交易过程。
本地订单表	记录策略或用户发起的意图。
持仓快照	记录账户状态。
汇总净额	计算盈亏、费用和盘后报表。

去重建议

成交接口可能被轮询多次。程序应使用 execution_id 或等价唯一字段去重，不要每轮查询都重复入库。

如果账户当天没有成交，接口返回空数组是正常情况。