Skip to main content

Get User Order 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/order-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.
order_idtrueintOrder ID
pagefalseintNumber of pagination. Default is 1.
limitfalseintNumber in each page. Default is 10.

Return parameters

Parameter NameTypeNotes
deal_idintTxid
created_atintTransaction timestamp, millisecond
order_idintOrder id
marketstringMarket name
margin_marketstringMargin market, null for non-margin markets
sidestringBuy or sell
pricestringFilled price
amountstringFilled volume
rolestringTaker or maker
feestringTrading fee charged
fee_ccystringTrading fee currency

Request example

GET /spot/order-deals?market=BTCUSDT&market_type=MARGIN&order_id=8678890&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",
"role": "taker",
"fee": "0.0299",
"fee_ccy": "USDT"
}
],
"pagination": {
"has_next": false
},
"message": "OK"
}