Skip to main content

Account Information (USER_DATA)

API Description#

Get current account information.

HTTP Request#

GET /dapi/v1/account

Request Weight#

5

Request Parameters#

NameTypeMandatoryDescription
recvWindowLONGNO
timestampLONGYES
  • for One-way Mode user, the "positions" will only show the "BOTH" positions
  • for Hedge Mode user, the "positions" will show "BOTH", "LONG", and "SHORT" positions.

Response Example#

{    "assets": [        {            "asset": "BTC",  // asset name             "walletBalance": "0.00241969",  // total wallet balance            "unrealizedProfit": "0.00000000",  // unrealized profit or loss            "marginBalance": "0.00241969",  // margin balance            "maintMargin": "0.00000000",    // maintenance margin            "initialMargin": "0.00000000",  // total intial margin required with the latest mark price            "positionInitialMargin": "0.00000000",  // positions" margin required with the latest mark price            "openOrderInitialMargin": "0.00000000",  // open orders" intial margin required with the latest mark price            "maxWithdrawAmount": "0.00241969",  // available amount for transfer out            "crossWalletBalance": "0.00241969",  // wallet balance for crossed margin            "crossUnPnl": "0.00000000",  // total unrealized profit or loss of crossed positions            "availableBalance": "0.00241969", // available margin balance            "updateTime": 1625474304765 //update time        }     ],     "positions": [         {            "symbol": "BTCUSD_201225",            "positionAmt":"0",  // position amount            "initialMargin": "0",            "maintMargin": "0",            "unrealizedProfit": "0.00000000",            "positionInitialMargin": "0",            "openOrderInitialMargin": "0",            "leverage": "125",            "isolated": false,            "positionSide": "BOTH", // BOTH means that it is the position of One-way Mode              "entryPrice": "0.0",            "breakEvenPrice": "0.0",  // break-even price            "maxQty": "50",  // maximum quantity of base asset            "updateTime": 0        },        {            "symbol": "BTCUSD_201225",            "positionAmt":"0",            "initialMargin": "0",            "maintMargin": "0",            "unrealizedProfit": "0.00000000",            "positionInitialMargin": "0",            "openOrderInitialMargin": "0",            "leverage": "125",            "isolated": false,            "positionSide": "LONG",  // LONG or SHORT means that it is the position of Hedge Mode             "entryPrice": "0.0",            "breakEvenPrice": "0.0",  // break-even price            "maxQty": "50",            "updateTime": 0        },        {            "symbol": "BTCUSD_201225",            "positionAmt":"0",            "initialMargin": "0",            "maintMargin": "0",            "unrealizedProfit": "0.00000000",            "positionInitialMargin": "0",            "openOrderInitialMargin": "0",            "leverage": "125",            "isolated": false,            "positionSide": "SHORT",  // LONG or SHORT means that it is the position of Hedge Mode             "entryPrice": "0.0",            "breakEvenPrice": "0.0",  // break-even price            "maxQty": "50"            "updateTime":1627026881327        }     ],     "canDeposit": true,     "canTrade": true,     "canWithdraw": true,     "feeTier": 2,     "updateTime": 0}