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
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"
},
...
]
}
}