跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://developer.wooxpro.com/llms.txt

Use this file to discover all available pages before exploring further.

​
查询合约成交明细 (KEYED)

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

​
请求URL

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

​
请求限制

参见 速率限制详细

​
请求参数

请求 
curl -H 'X-BM-KEY:{{AccessKey}}'
https://cloud-api.wooxpro.com/contract/private/trades?symbol=BTCUSDT&start_time=1662368173&end_time=1662368179
参数类型是否必填描述
symbolString选填合约交易对（如BTCUSDT）
accountString选填交易用户
-futures=合约主账号
-copy_trading=跟单子账号
start_timeLong选填开始时间(时间戳，精确到秒)
end_timeLong选填结束时间(时间戳，精确到秒)
order_idLong选填订单ID
client_order_idString选填客户端订单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"
}
字段类型描述
symbolString合约交易对（如BTCUSDT）
order_idString订单编号
trade_idString成交明细编号
sideInt订单方向
双向持仓
-1=开多
-2=平空
-3=平多
-4=开空
单向持仓
-1=买入
-2=买入（只减仓）
-3=卖出（只减仓）
-4=卖出
priceString成交价格
volString成交量
exec_typeString流动性类型
-Taker
-Maker
profitBoolean是否盈利
realised_profitString已实现盈亏
paid_feesString手续费
accountString交易用户
-futures=合约主账号
-copy_trading=跟单子账号
create_timeLong成交创建时间(ms)