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

See Detailed Rate 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"
            }
        ]
    }
}

results matching ""

    No results matching ""