Skip to main content

Get User Transaction

Info
  • This endpoint requires signature. For specific signature rules, please refer to Authentication
  • This endpoint will trigger rate limit. For specific rules, please refer to Rate Limit.

HTTP request

GET /spot/user-deals

Request parameters

Parameter NameRequiredTypeNotes
markettruestringMarket name
market_typetruestringMarket type.
Note: In spot related functions, only SPOT or MARGIN can be used.
In futures related functions, only FUTURES can be used.
sidefalsestringOrder side, null to return orders of both sides
start_timefalseintQuery start time.
  • Data will not be filtered based on time by default
end_timefalseintQuery end time.
  • Data will not be filtered based on time by default
pagefalseintNumber of pagination. Default is 1.
limitfalseintNumber in each page. Default is 10.

Return parameters

Parameter NameTypeNotes
deal_idintTxid
created_atdoubleTransaction timestamp, millisecond
order_idintOrder id
marketstringMarket name
margin_marketstringMargin market, null for non-margin markets
sidestringBuy or sell
pricestringFilled price
amountstringFilled volume

Request example

GET /spot/user-deals?market=BTCUSDT&market_type=MARGIN&side=buy&page=1&limit=10

Response example

{
"code": 0,
"data": [
{
"deal_id": 3514376759,
"created_at": 1689152421692,
"market": "BTCUSDT",
"side": "buy",
"order_id": 8678890,
"margin_market": "BTCUSDT",
"price": "30718.42",
"amount": "0.00000325"
}
],
"pagination": {
"has_next": false
},
"message": "OK"
}