查询合约成交明细 (KEYED) - WOO X Pro

适用于查询某合约订单成交明细

请求URL

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

请求限制

参见速率限制详细

请求参数

请求

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

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

注意

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

响应详情

响应

{
  "code": 1000,
  "message": "Ok",
  "data": [{
    "order_id": "220921197409432",
    "trade_id": "1141853921",
    "symbol": "BTCUSDT",
    "side": 1,
    "price": "19313.3",
    "vol": "108",
    "exec_type": "Maker",
    "profit": false,
    "realised_profit": "-0.00832",
    "paid_fees": "0",
    "account": "futures",
    "create_time": 1663663818589
  }],
  "trace": "638d5048-ad21-4a4b-9365-d0756fbfc7ba"
}

字段	类型	描述
symbol	String	合约交易对（如BTCUSDT）
order_id	String	订单编号
trade_id	String	成交明细编号
side	Int	订单方向
price	String	成交价格
vol	String	成交量
exec_type	String	流动性类型 -`Taker` -`Maker`
profit	Boolean	是否盈利
realised_profit	String	已实现盈亏
paid_fees	String	手续费
account	String	交易用户 -`futures`=合约主账号 -`copy_trading`=跟单子账号
create_time	Long	成交创建时间(ms)