跳到主要内容

批量查询订单状态

信息
  • 该接口需要签名,具体签名规则请参阅认证
  • 该接口会触发限频,具体规则请参阅限频
危险
  • 没有任何成交的订单撤销后,服务器不会保存该订单,不能通过任何接口再查询到这个订单的数据。

HTTP 请求

GET /futures/batch-order-status

请求参数

参数名是否必须类型说明
markettruestring市场名称
order_idstruestring批量订单 ID,多个订单 ID 之间使用英文","分隔

请求响应

参数名类型说明
order_idint订单 ID
marketstring市场名称
market_typestring市场类型
sidestring订单方向
typestring订单类型
amountstring委托数量
pricestring委托价格
unfilled_amountstring未成交数量
filled_amountstring已成交数量
filled_valuestring已成交价值
client_idstring客户端 ID
feestring收取的交易手续费
fee_ccystring收取的手续费币种
maker_fee_ratestringmaker 手续费费率
taker_fee_ratestringtaker 手续费费率
last_filled_amountstring最后一笔成交的数量
last_filled_pricestring最后一笔成交的价格
realized_pnlstring已实现盈亏
created_atint订单创建时间
updated_atint订单更新时间
statusstring订单状态

请求示例

GET /futures/batch-order-status?market=CETUSDT&order_ids=13400,13401

响应示例

{
"code": 0,
"data": [
{
"code": 0,
"data": {
"order_id": "13400",
"market": " CETUSDT",
"market_type": "FUTURES",
"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",
"fee": "11.6582326221",
"fee_ccy": "USDT",
"maker_fee_rate": "0",
"taker_fee_rate": "0.0003",
"last_filled_amount": "27564.87468358",
"last_filled_price": "1",
"realized_pnl": "-22.142539215",
"created_at": 1691482451000,
"updated_at": 1691482451000,
"status": "part_deal"
},
"message": "OK"
}
],
"message": "OK"
}