Get User Order History
Get a list of user orders (Authentication type:SIGNED, See Interface Permission)
Request Format
GET https://api-cloud.bitmart.com/spot/v1/orders
Request Limit
Request Parameter
| Field | Type | Required? | Description |
|---|---|---|---|
| symbol | string | Yes | Trading pair (e.g. BTC_USDT) |
| offset | int | Yes | Current page, starts from 1 |
| limit | int | Yes | Items returned per page (value range 1-100) |
| status | string | Yes | Status |
1=Order failure |
|||
2=Placing order |
|||
3=Order failure, Freeze failure |
|||
4=Order success, Pending for fulfilment |
|||
5=Partially filled |
|||
6=Fully filled |
|||
7=Canceling |
|||
8=Canceled |
|||
9=Outstanding (4 and 5) |
|||
10= 6 and 8 |
Instruction
However, for high-volume trades, it is strongly recommended that users maintain their own current order list and use websocket to update the order status. You should pull the current order list once before each transaction.
Only the latest 500 orders can be fetched, and an empty response will be returned if the request exceeds 500. (offset * limit > 500)
Request example
curl https://api-cloud.bitmart.com/spot/v1/orders?symbol=BTC_USDT&status=1&offset=1&limit=100
Response Data
| 字段 | 类型 | 描述 |
|---|---|---|
| orders | List | Order list |
| order_id | long | Order id |
| symbol | string | Trading pair (e.g. BTC_USDT) |
| create_time | long | Timestamp, accurate to milliseconds |
| side | string | Side |
buy=Buy order |
||
sell=Sell order |
||
| type | string | Order type |
limit=Limit order |
||
market=Market order |
||
| price | string | Order price |
| price_avg | string | Average filled price |
| size | string | Order size (Base currency) |
| notional | string | Trade amount, unit is quote currency (special case: base currency when selling market orders) |
| filled_notional | string | Filled notional amount |
| filled_size | string | Filled amount |
| status | string | Status |
1=Order failure |
||
2=Placing order |
||
3=Order failure, Freeze failure |
||
4=Order success, Pending for fulfilment |
||
5=Partially filled |
||
6=Fully filled |
||
7=Canceling |
||
8=Canceled |
Example of returned data format
{
"message":"OK",
"code":1000,
"trace":"70e7d427-7436-4fb8-8cdd-97e1f5eadbe9",
"data":{
"current_page":1,
"orders":[
{
"order_id":2147601241,
"symbol":"BTC_USDT",
"create_time":1591099963000,
"side":"sell",
"type":"limit",
"price":"9000.00",
"price_avg":"0.00",
"size":"1.00000",
"notional":"9000.00000000",
"filled_notional":"0.00000000",
"filled_size":"0.00000",
"status":"4"
}
]
}
}