Trade

Account Information (USER_DATA)

Get current account information.

Weight(IP): 20

get/api/v3/account

Query parameters

recvWindowinteger

Example:5000

The value cannot be greater than 60000

timestampinteger required

UTC timestamp in ms

signaturestring required

Signature

Response

Account details

makerCommissioninteger required

takerCommissioninteger required

buyerCommissioninteger required

sellerCommissioninteger required

canTradeboolean required

canWithdrawboolean required

canDepositboolean required

brokeredboolean required

requireSelfTradePreventionboolean required

preventSorboolean required

updateTimeinteger required

accountTypestring required

permissionsstring[] required

uidinteger required

Example response

{
  "makerCommission": 15,
  "takerCommission": 15,
  "commissionRates": {
    "maker": "0.00150000",
    "taker": "0.00150000",
    "buyer": "0.00000000",
    "seller": "0.00000000"
  },
  "updateTime": 123456789,
  "accountType": "SPOT",
  "balances": [
    {
      "asset": "BTC",
      "free": "4723846.89208129",
      "locked": "0.00000000"
    }
  ],
  "permissions": [
    "SPOT"
  ],
  "uid": 354937868
}

Changes

Changed in 4 of the 26 revisions of this API.223

Sep 2, 20236622e0c151003See the full diff
- ○
  added the required property permissions to the response with the 200 status
  response-required-property-added
- ○
  added the required property preventSor to the response with the 200 status
  response-required-property-added
- ○
  added the required property uid to the response with the 200 status
  response-required-property-added
Apr 26, 2023042dad2ebffe2See the full diff
- ○
  added the required property commissionRates to the response with the 200 status
  response-required-property-added
- ○
  added the required property requireSelfTradePrevention to the response with the 200 status
  response-required-property-added
Aug 29, 20225b6a6f4707951See the full diff
- ○
  added the required property brokered to the response with the 200 status
  response-required-property-added
Oct 25, 2021a484ce871a72217See the full diff
- ▲
  for the query request parameter recvWindow, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ▲
  for the query request parameter timestamp, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ○
  the response property accountType became required for the status 200
  response-property-became-required
- ○
  the response property balances became required for the status 200
  response-property-became-required
- ○
  the response property balances/items/asset became required for the status 200
  response-property-became-required
- ○
  the response property balances/items/free became required for the status 200
  response-property-became-required
- ○
  the response property balances/items/locked became required for the status 200
  response-property-became-required
- ○
  the response property buyerCommission became required for the status 200
  response-property-became-required
- ○
  the response property canDeposit became required for the status 200
  response-property-became-required
- ○
  the response property canTrade became required for the status 200
  response-property-became-required
- ○
  the response property canWithdraw became required for the status 200
  response-property-became-required
- ○
  the response property code became required for the status 400
  response-property-became-required
- ○
  the response property code became required for the status 401
  response-property-became-required
- ○
  the response property makerCommission became required for the status 200
  response-property-became-required
- ○
  the response property msg became required for the status 400
  response-property-became-required
- ○
  the response property msg became required for the status 401
  response-property-became-required
- ○
  the response property sellerCommission became required for the status 200
  response-property-became-required
- ○
  the response property takerCommission became required for the status 200
  response-property-became-required
- ○
  the response property updateTime became required for the status 200
  response-property-became-required

Full history