跳到主要内容
版本:V1

获取历史委托列表

HTTP请求 获取历史委托列表

  • POST /api/spot/v1/trade/history

限速规则:20次/1s

请求参数

参数名参数类型是否必须描述
symbolString币对,具体见:/products
afterString传入 orderId,获取在该 orderId 之前的数据(desc)
beforeString传入 orderId,获取在该 orderId 之后的数据(asc)
limitInteger返回结果的数量,默认100,最大 500

请求示例

curl -X POST "https://contract-openapi.weex.com/api/spot/v1/trade/history" \
-H "ACCESS-KEY:*******" \
-H "ACCESS-SIGN:*" \
-H "ACCESS-PASSPHRASE:*" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:zh-CN" \
-H "Content-Type: application/json" \
-d '{"symbol": "BTCUSDT_SPBL"}'

返回参数

字段名字段说明
accountId账户id
symbol币对名称
orderId订单id
clientOrderId自定义id
price委托价格
quantity委托数量(市价 买,表示金额)
orderType委托类型
side委托方向
status订单状态
fillPrice成交价格
fillQuantity成交数量
fillTotalAmount成交总额
cTime创建时间 (时间戳秒)

返回示例

{
"code": "00000",
"message": "success",
"data": [{
"accountId": "10012",
"symbol": "btcusdt_spbl",
"orderId": "2222222",
"clientOrderId": "xxxxxxx",
"price": "34982.12",
"quantity": "1",
"orderType": "limit",
"side": "buy",
"status": "new",
"fillPrice": "34982.12",
"fillQuantity": "1",
"fillTotalAmount": "34982.12",
"cTime": "1622697148"
}]
}