获取已完成委托单
危险
- 没有任何成交的订单撤销后,服务器不会保存该订单,不能通过任何接口再查询到这个订单的数据。
HTTP 请求
GET /spot/finished-order
请求参数
参数名 | 是否必须 | 类型 | 说明 |
---|---|---|---|
market | false | string | 市场名称。不传返回全部市场订单 注意:market_type 为 MARGIN 必传 |
market_type | true | string | 市场类型。 注意:在现货相关功能中,只可使用 SPOT 或 MARGIN 在合约相关功能中,只可使用 FUTURES |
side | false | string | 订单方向,不传返回全部方向订单 |
page | false | int | 分页页数。默认页数为 1。 |
limit | false | int | 分页数量。默认数量为 10。 |
请求响应
参数名 | 类型 | 说明 |
---|---|---|
order_id | int | 订单 ID |
market | string | 市场名称 |
market_type | string | 市场类型 |
ccy | string | 币种名称 |
side | string | 订单方向 |
type | string | 订单类型 |
amount | string | 委托数量 |
price | string | 委托价格 |
unfilled_amount | string | 未成交数量 |
filled_amount | string | 已成交数量 |
filled_value | string | 已成交价值 |
client_id | string | 客户端 ID |
base_fee | string | 收取的交易币种手续费 |
quote_fee | string | 收取的报价币种手续费 |
discount_fee | string | 收取的抵扣币种手续费 |
maker_fee_rate | string | maker 手续费费率 |
taker_fee_rate | string | taker 手续费费率 |
created_at | int | 订单创建时间 |
updated_at | int | 订单更新时间 |
请求示例
GET /spot/finished-order?market=CETUSDT&market_type=MARGIN&order_side=buy&page=1&limit=10
响应示例
{
"code": 0,
"data": [
{
"order_id": 13400,
"market": " CETUSDT",
"market_type": "MARGIN",
"ccy": "CET",
"side": "buy",
"type": "limit",
"amount": "10000",
"price": "1",
"unfilled_amount": "50241.7185224371",
"filled_amount": "27564.87468358",
"filled_value": "27564.87468358",
"client_id": "client_id_1",
"base_fee": "11.6582326221",
"quote_fee": "0",
"discount_fee": "0",
"maker_fee_rate": "0",
"taker_fee_rate": "0.0003",
"created_at": "1691482451000",
"updated_at": "1691482451000"
}
],
"pagination": {
"total": 1,
"has_next": false
}
"message": "OK"
}