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