跳到主要内容

查询订单

查询指定交易对订单状态,最多查询7天内的订单记录,超过7天的可在web客户端查看和导出。

请求示例

GET /api/v3/order?symbol=BTCUSDT&orderId=129402018493145088&timestamp={{timestamp}}&signature={{signature}}

返回示例

{
"symbol": "LTCBTC", // 交易对
"orderId": 1, // 系统的订单ID
"orderListId": -1, // OCO订单的ID,不然就是-1
"clientOrderId": "myOrder1", // 客户自己设置的ID
"price": "0.1", // 订单价格
"Qty": "1.0", // 用户设置的原始订单数量
"executedQty": "0.0", // 交易的订单数量
"cummulativeQuoteQty": "0.0", // 累计交易的金额
"status": "NEW", // 订单状态
"timeInForce": "GTC", // 订单的时效方式
"type": "LIMIT", // 订单类型, 比如市价单,现价单等
"side": "BUY", // 订单方向,买还是卖
"stopPrice": "0.0", // 止损价格
"icebergQty": "0.0", // 冰山数量
"time": 1499827319559, // 订单时间
"updateTime": 1499827319559, // 最后更新时间
"stpMode":"", //stp模式
"cancelReason":"stp_cancel", //取消原因
"isWorking": true, // 订单是否出现在orderbook中
"origQuoteOrderQty": "0.000000" // 原始的交易金额
}

HTTP请求

  • GET /api/v3/order

接口权限要求: 现货交易信息读 / SPOT_DEAL_R

权重(IP): 2

请求参数

参数名数据类型是否必须说明
symbolString交易对
origClientOrderIdString原始客户端订单id
orderIdString订单id
recvWindowlong
timestamplong

返回参数

参数名说明
symbol交易对
origClientOrderId原始客户端订单id
orderId系统订单id
clientOrderId客户自定义id
price价格
Qty原始订单数量
executedQty交易的订单数量
cummulativeQuoteQty累计订单金额
status订单状态
timeInForce订单的时效方式
type订单类型
side订单方向
stopPrice止损价格
icebergQty冰山数量
time订单时间
updateTime最后更新时间
isWorking是否在orderbook中
stpMode""-默认值,不限制自成交。“cancel_maker”-取消maker单。“cancel_taker”-取消taker单。“cancel_both”-双方都取消。
cancelReason取消原因,用户自己取消时该字段为空,stp_cancel:因STP规则取消
origQuoteOrderQty原始的交易金额