查询订单
查询指定交易对订单状态,最多查询7天内的订单记录,超过7天的可在web客户端查看和导出。
请求示例
GET /api/v3/order?symbol=BTCUSDT&orderId=129402018493145088×tamp={{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
请求参数
| 参数名 | 数据类型 | 是否必须 | 说明 |
|---|---|---|---|
| symbol | String | 是 | 交易对 |
| origClientOrderId | String | 否 | 原始客户端订单id |
| orderId | String | 否 | 订单id |
| recvWindow | long | 否 | |
| timestamp | long | 是 |
返回参数
| 参数名 | 说明 |
|---|---|
| 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 | 原始的交易金额 |