order_id。按资产查询时,使用交易前选定的 asset_id。
1. 查询或找回订单
已知order_id 时,调用 Retrieve order(GET /order/{order_id})。如果未收到创建订单的响应,使用当时提交的 client_reference 调用 List orders(GET /order)查找。
查询历史订单时,可按 asset_id、symbol、order_status 或 from / to 筛选。这里的时间范围针对订单创建时间,包含 from,不包含 to。先找回原订单结果,再决定是否再次下单。
2. 查询当前持仓
交易成功后,将asset_id 传给 List positions(GET /position)。
3. 关联持仓变动
将order_id 传给 List position events(GET /position/event),查找该笔交易的持仓变动。结合订单的 executed_quantity,读取 quantity_delta、quantity_after 和 created_at。
查询某个资产的变动历史时,可按 asset_id 或 symbol 筛选,并按需传入 from / to。这里的时间范围针对事件发生时间,包含 from,不包含 to。
变动类型为 ADJUSTMENT 时,使用该资产的 asset_id 调用 List corporate actions(GET /asset/{asset_id}/corporate-action)。读取 old_multiplier、new_multiplier、effective_at 和 applied_at 了解已应用的调整;持仓变动不一定关联订单。
订单列表也可能包含 DEPOSIT 和 WITHDRAWAL 记录,这类记录通过 transfer_quantity 表示数量;前述报价与下单流程创建的是 BUY 或 SELL 交易。
读取全部分页
列表查询传入page_number 和 page_size,读取 data 后逐页增加 page_number,直到读完 total_pages。默认每页 10 条,最多 100 条。
