Get User Trade History

Get user trade history (Authentication type:SIGNED, See Interface Permission)

Request Format

GET https://api-cloud.bitmart.com/spot/v1/trades

Request Limit

See Detailed Rate Limit

Request Parameter

Field Type Required? Description
symbol string Yes Trading pair (e.g. BTC_USDT)

Special Parameters for Querying Trade Record of a Single Order

Field Type Required? Description
order_id long No Order id

Instruction

An empty list is returned if the order is not filled or it has been canceled.


Special Parameters for Querying Trade Record of All Orders

Field Type Required? Description
offset int No Current page, starts from 1
limit int No Records returned per page (value range 1-100)

Instruction

Only the most recent 200 orders can be fetched, and an empty response will be returned if the request exceeds 200. (offset * limit > 200)


Request example

https://api-cloud.bitmart.com/spot/v1/trades?symbol=BTC_USDT&limit=10&offset=1

Response Data

Field Type Description
orders List Order list
detail_id long Trade id
order_id long Order id
symbol string Trading pair symbol
create_time long Trade time (in milliseconds)
side string Side
buy=Buy order
sell=Sell order
price_avg string Average filled price
notional string Notional amount
size string Order size
fees string Fees
fee_coin_name string Coin used for paying fees
exec_type string Whether the trade was created by a maker or a taker. M means Maker, T means Taker

Example of returned data format

{
    "message":"OK",
    "code":1000,
    "trace":"a06a5c53-8e6f-42d6-8082-2ff4718d221c",
    "data":{
        "current_page":1,
        "trades":[
            {
                "detail_id":256348632,
                "order_id":2147484350,
                "symbol":"BTC_USDT",
                "create_time":1590462303000,
                "side":"buy",
                "fees":"0.00001350",
                "fee_coin_name":"BTC",
                "notional":"88.00000000",
                "price_avg":"8800.00",
                "size":"0.01000",
                "exec_type":"M"
            },
            ...
        ]
    }
}

results matching ""

    No results matching ""