Skip to main content

Account Trade List (USER_DATA)

API Description

Get trades for a specific account and symbol.

HTTP Request

GET /dapi/v1/userTrades

Request Weight

20 with symbol,40 with pair

Request Parameters

NameTypeMandatoryDescription
symbolSTRINGNO
pairSTRINGNO
orderIdSTRINGNO
startTimeLONGNO
endTimeLONGNO
fromIdLONGNOTrade id to fetch from. Default gets most recent trades.
limitINTNODefault 50; max 1000
recvWindowLONGNO
timestampLONGYES
  • Either symbol or pair must be sent
  • Symbol and pair cannot be sent together
  • Pair and fromId cannot be sent together
  • OrderId can only be sent together with symbol
  • If a pair is sent,tickers for all symbols of the pair will be returned
  • The parameter fromId cannot be sent with startTime or endTime
  • If startTime and endTime are both not sent, then the last 7 days' data will be returned.
  • The time between startTime and endTime cannot be longer than 7 days.

Response Example

[
{
'symbol': 'BTCUSD_200626',
'id': 6,
'orderId': 28,
'pair': 'BTCUSD',
'side': 'SELL',
'price': '8800',
'qty': '1',
'realizedPnl': '0',
'marginAsset': 'BTC',
'baseQty': '0.01136364',
'commission': '0.00000454',
'commissionAsset': 'BTC',
'time': 1590743483586,
'positionSide': 'BOTH',
'buyer': false,
'maker': false
}
]