查询合约历史订单 (KEYED) - WOO X Pro

适用于查询某合约订单历史记录

请求URL

GET https://cloud-api.wooxpro.com/contract/private/order-history

请求限制

参见速率限制详细

请求参数

请求

curl -H 'X-API-KEY:{{AccessKey}}'
https://cloud-api.wooxpro.com/contract/private/order-history?symbol=BTCUSDT&start_time=1662368173&end_time=1662368179

参数	类型	是否必填	描述
symbol	String	必填	合约交易对（如BTCUSDT）
order_id	String	选填	订单编号
client_order_id	String	选填	用户自定义订单ID
account	String	选填	交易用户 -`futures`=合约主账号 -`copy_trading`=跟单子账号
start_time	Long	选填	开始时间(时间戳，精确到秒)
end_time	Long	选填	结束时间(时间戳，精确到秒)

注意

没有填写时间范围 start_time和end_time，默认查询最近7天数据
填写时间范围的话，end_time 必须比 start_time 的值大，并且start_time和end_time 最大支持 90 天的查询间隔
每次请求最多返回200条，超过的将不会返回

响应详情

响应

{
  "code": 1000,
  "message": "Ok",
  "data": [
    {
      "order_id": "3000101684062644",
      "client_order_id": "PLAN_3000097492004577",
      "price": "0",
      "trigger_price": "0",
      "execution_price": "0",
      "size": "1",
      "symbol": "BTCUSDT",
      "state": 4,
      "side": 2,
      "type": "market",
      "account": "futures",
      "position_mode": "hedge_mode",
      "leverage": "20",
      "open_type": "cross",
      "deal_avg_price": "84802",
      "deal_size": "1",
      "create_time": 1743160485193,
      "update_time": 1743160485258,
      "activation_price_type": 1,
      "activation_price": "0",
      "callback_rate": "0",
      "preset_take_profit_price_type": 0,
      "preset_stop_loss_price_type": 0,
      "preset_take_profit_price": "",
      "preset_stop_loss_price": ""
    }
  ],
  "trace": "b15f261868b540889e57f826e0420621.80.17434162457898722"
}

字段	类型	描述
symbol	String	合约交易对（如BTCUSDT）
order_id	String	订单编号
client_order_id	String	用户自定义ID（如果该字段未定义，则返回空）
side	Int	订单方向
type	String	订单类型 -`limit`=限价单 -`market`=市价单 -`liquidate`=强平单 -`bankruptcy`=爆仓破产单 -`adl`=adl单 -`trailing`=跟踪委托单 -`planorder`=计划委托单
account	String	交易用户 -`futures`=合约主账号 -`copy_trading`=跟单子账号
position_mode	String	持仓模式 -`hedge_mode`=双向持仓 -`one_way_mode`=单向持仓
leverage	String	杠杆下单倍数
open_type	String	开仓类型 -`cross`=全仓 -`isolated`=逐仓
deal_avg_price	String	成交均价
deal_size	String	成交数量
price	String	委托价格
trigger_price	String	触发价格,计划委托单返回
execution_price	String	执行价格,计划委托单返回 -`Market price`=如果执行价格为市价，返回Market -`Limit price`=如果执行价格为限价，返回设置的限价价格
size	String	委托数量
state	Int	订单状态 -`2`=委托中 -`4`=已结束
activation_price	String	激活价格,跟踪委托单返回
callback_rate	String	回调幅度,跟踪委托单返回
activation_price_type	Int	激活价格类型,跟踪委托单返回 -`1`=最新成交价 -`2`=标记价格
executive_order_id	String	触发执行订单编号
preset_take_profit_price_type	Int	预设止盈委托价格类型 -`0`=未设置 -`1`=最新成交价 -`2`=标记价格
preset_stop_loss_price_type	Int	预设止损委托价格类型 -`0`=未设置 -`1`=最新成交价 -`2`=标记价格
preset_take_profit_price	String	预设止盈价格
preset_stop_loss_price	String	预设止损价格
create_time	Long	订单创建时间(ms)
update_time	Long	订单更新时间(ms)