Account

Endpoint

Account Information (USER_DATA)

Get current account information. User in single-asset/ multi-assets mode will see different value, see comments in response section for detail.

WSS

account.status

wss://ws-dapi.binance.com/ws-dapi/v1

Account Information (USER_DATA) › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Account Information (USER_DATA) › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight5

Account Information (USER_DATA) › Request Parameters

id

string · required

Example: e9d6b4349871b40611412680b3445fac

method

string · enum · required

WebSocket API method name.

Enum values:

account.status

Example: account.status

object · required

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

apiKey

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

recvWindow

integer · int64 · max: 60000

Example: 5000

Account Information (USER_DATA) › Responses

Successful Response

Account Information

id

string

positionId

Example: baaec739-c5cf-4920-b448-c0b9c5431410

status

integer · int64

Example: 200

object

Indicates that combined is set to true.

feeTier

integer · int64

Fee tier level.

Example: 0

canTrade

boolean

Whether trading is enabled.

Example: true

canDeposit

boolean

Whether deposits are enabled.

Example: true

canWithdraw

boolean

Whether withdrawals are enabled.

Example: true

updateTime

integer · int64

update time

Example: 0

object[]

Supported assets.

asset

string

asset name

Example: WLD

walletBalance

string

total wallet balance

Example: 0.00000000

unrealizedProfit

string

unrealized profit or loss

Example: 0.00000000

marginBalance

string

margin balance

Example: 0.00000000

maintMargin

string

maintenance margin

Example: 0.00000000

initialMargin

string

total intial margin required with the latest mark price

Example: 0.00000000

positionInitialMargin

string

positions" margin required with the latest mark price

Example: 0.00000000

openOrderInitialMargin

string

open orders" intial margin required with the latest mark price

Example: 0.00000000

maxWithdrawAmount

string

maximum amount for transfer out

Example: 0.00000000

crossWalletBalance

string

wallet balance for crossed margin

Example: 0.00000000

crossUnPnl

string

total unrealized profit or loss of crossed positions

Example: 0.00000000

availableBalance

string

available margin balance

Example: 0.00000000

updateTime

integer · int64

update time

Example: 0

object[]

Position list.

symbol

string

Trading symbol

Example: ETHUSD_220930

initialMargin

string

total intial margin required with the latest mark price

Example: 0

maintMargin

string

maintenance margin

Example: 0

unrealizedProfit

string

unrealized profit or loss

Example: 0.00000000

positionInitialMargin

string

positions" margin required with the latest mark price

Example: 0

openOrderInitialMargin

string

open orders" intial margin required with the latest mark price

Example: 0

leverage

string

Leverage value.

Example: 7

isolated

boolean

Whether isolated margin mode is enabled.

Example: false

positionSide

string

Position side

Example: BOTH

entryPrice

string

Position entry price.

Example: 0.00000000

maxQty

string

maximum quantity of base asset

Example: 1000

notionalValue

string

Notional value.

Example: 0

isolatedWallet

string

Isolated wallet balance.

Example: 0

updateTime

integer · int64

update time

Example: 0

positionAmt

string

position amount

Example: 0

breakEvenPrice

string

break-even price

Example: 0.00000000

object[]

Rate limit definitions.

rateLimitType

string

Rate limit type.

Example: REQUEST_WEIGHT

interval

string

Rate limit interval.

Example: MINUTE

intervalNum

integer · int64

Rate limit interval multiplier.

Example: 1

limit

integer · int64

Maximum allowed orders for this rule.

Example: 2400

count

integer · int64

Total number of trades in the 24h window.

Example: 10

WSSaccount.status

wscat -c wss://ws-dapi.binance.com/ws-dapi/v1 -x '{
  "id": "e9d6b4349871b40611412680b3445fac",
  "method": "account.status",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "e9d6b4349871b40611412680b3445fac",
  "method": "account.status",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "baaec739-c5cf-4920-b448-c0b9c5431410",
  "status": 200,
  "result": {
    "feeTier": 0,
    "canTrade": true,
    "canDeposit": true,
    "canWithdraw": true,
    "updateTime": 0,
    "assets": [
      {
        "asset": "WLD",
        "walletBalance": "0.00000000",
        "unrealizedProfit": "0.00000000",
        "marginBalance": "0.00000000",
        "maintMargin": "0.00000000",
        "initialMargin": "0.00000000",
        "positionInitialMargin": "0.00000000",
        "openOrderInitialMargin": "0.00000000",
        "maxWithdrawAmount": "0.00000000",
        "crossWalletBalance": "0.00000000",
        "crossUnPnl": "0.00000000",
        "availableBalance": "0.00000000",
        "updateTime": 0
      }
    ],
    "positions": [
      {
        "symbol": "ETHUSD_220930",
        "initialMargin": "0",
        "maintMargin": "0",
        "unrealizedProfit": "0.00000000",
        "positionInitialMargin": "0",
        "openOrderInitialMargin": "0",
        "leverage": "7",
        "isolated": false,
        "positionSide": "BOTH",
        "entryPrice": "0.00000000",
        "maxQty": "1000",
        "notionalValue": "0",
        "isolatedWallet": "0",
        "updateTime": 0,
        "positionAmt": "0",
        "breakEvenPrice": "0.00000000"
      }
    ]
  },
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 2400,
      "count": 10
    }
  ]
}

json

application/json

Futures Account Balance (USER_DATA)

Futures Account Balance

WSS

account.balance

wss://ws-dapi.binance.com/ws-dapi/v1

Futures Account Balance (USER_DATA) › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Futures Account Balance (USER_DATA) › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight5

Futures Account Balance (USER_DATA) › Request Parameters

id

string · required

Example: e9d6b4349871b40611412680b3445fac

method

string · enum · required

WebSocket API method name.

Enum values:

account.balance

Example: account.balance

object · required

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

apiKey

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

recvWindow

integer · int64 · max: 60000

Example: 5000

Futures Account Balance (USER_DATA) › Responses

Successful Response

Futures Account Balance

id

string

positionId

Example: 9328e612-1560-4108-979e-283bf85b5acb

status

integer · int64

Example: 200

object[]

Indicates that combined is set to true.

accountAlias

string

unique account code

Example: fWAuTiuXoCuXmY

asset

string

asset name

Example: WLD

balance

string

Account balance.

Example: 0.00000000

withdrawAvailable

string

Available amount for withdrawal.

Example: 0.00000000

crossWalletBalance

string

wallet balance for crossed margin

Example: 0.00000000

crossUnPnl

string

total unrealized profit or loss of crossed positions

Example: 0.00000000

availableBalance

string

available margin balance

Example: 0.00000000

updateTime

integer · int64

update time

Example: 0

object[]

Rate limit definitions.

rateLimitType

string

Rate limit type.

Example: REQUEST_WEIGHT

interval

string

Rate limit interval.

Example: MINUTE

intervalNum

integer · int64

Rate limit interval multiplier.

Example: 1

limit

integer · int64

Maximum allowed orders for this rule.

Example: 2400

count

integer · int64

Total number of trades in the 24h window.

Example: 10

WSSaccount.balance

wscat -c wss://ws-dapi.binance.com/ws-dapi/v1 -x '{
  "id": "e9d6b4349871b40611412680b3445fac",
  "method": "account.balance",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "e9d6b4349871b40611412680b3445fac",
  "method": "account.balance",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "9328e612-1560-4108-979e-283bf85b5acb",
  "status": 200,
  "result": [
    {
      "accountAlias": "fWAuTiuXoCuXmY",
      "asset": "WLD",
      "balance": "0.00000000",
      "withdrawAvailable": "0.00000000",
      "crossWalletBalance": "0.00000000",
      "crossUnPnl": "0.00000000",
      "availableBalance": "0.00000000",
      "updateTime": 0
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 2400,
      "count": 10
    }
  ]
}

json

application/json

Account Information (USER_DATA)

Get current account information. User in single-asset/ multi-assets mode will see different value, see comments in response section for detail.

WSS

account.status

wss://ws-dapi.binance.com/ws-dapi/v1

Account Information (USER_DATA) › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Account Information (USER_DATA) › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight5

Account Information (USER_DATA) › Request Parameters

id

string · required

Example: e9d6b4349871b40611412680b3445fac

method

string · enum · required

WebSocket API method name.

Enum values:

account.status

Example: account.status

object · required

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

apiKey

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

recvWindow

integer · int64 · max: 60000

Example: 5000

Account Information (USER_DATA) › Responses

Successful Response

Account Information

id

string

positionId

Example: baaec739-c5cf-4920-b448-c0b9c5431410

status

integer · int64

Example: 200

object

Indicates that combined is set to true.

feeTier

integer · int64

Fee tier level.

Example: 0

canTrade

boolean

Whether trading is enabled.

Example: true

canDeposit

boolean

Whether deposits are enabled.

Example: true

canWithdraw

boolean

Whether withdrawals are enabled.

Example: true

updateTime

integer · int64

update time

Example: 0

object[]

Supported assets.

asset

string

asset name

Example: WLD

walletBalance

string

total wallet balance

Example: 0.00000000

unrealizedProfit

string

unrealized profit or loss

Example: 0.00000000

marginBalance

string

margin balance

Example: 0.00000000

maintMargin

string

maintenance margin

Example: 0.00000000

initialMargin

string

total intial margin required with the latest mark price

Example: 0.00000000

positionInitialMargin

string

positions" margin required with the latest mark price

Example: 0.00000000

openOrderInitialMargin

string

open orders" intial margin required with the latest mark price

Example: 0.00000000

maxWithdrawAmount

string

maximum amount for transfer out

Example: 0.00000000

crossWalletBalance

string

wallet balance for crossed margin

Example: 0.00000000

crossUnPnl

string

total unrealized profit or loss of crossed positions

Example: 0.00000000

availableBalance

string

available margin balance

Example: 0.00000000

updateTime

integer · int64

update time

Example: 0

object[]

Position list.

symbol

string

Trading symbol

Example: ETHUSD_220930

initialMargin

string

total intial margin required with the latest mark price

Example: 0

maintMargin

string

maintenance margin

Example: 0

unrealizedProfit

string

unrealized profit or loss

Example: 0.00000000

positionInitialMargin

string

positions" margin required with the latest mark price

Example: 0

openOrderInitialMargin

string

open orders" intial margin required with the latest mark price

Example: 0

leverage

string

Leverage value.

Example: 7

isolated

boolean

Whether isolated margin mode is enabled.

Example: false

positionSide

string

Position side

Example: BOTH

entryPrice

string

Position entry price.

Example: 0.00000000

maxQty

string

maximum quantity of base asset

Example: 1000

notionalValue

string

Notional value.

Example: 0

isolatedWallet

string

Isolated wallet balance.

Example: 0

updateTime

integer · int64

update time

Example: 0

positionAmt

string

position amount

Example: 0

breakEvenPrice

string

break-even price

Example: 0.00000000

object[]

Rate limit definitions.

rateLimitType

string

Rate limit type.

Example: REQUEST_WEIGHT

interval

string

Rate limit interval.

Example: MINUTE

intervalNum

integer · int64

Rate limit interval multiplier.

Example: 1

limit

integer · int64

Maximum allowed orders for this rule.

Example: 2400

count

integer · int64

Total number of trades in the 24h window.

Example: 10

Futures Account Balance (USER_DATA)

Futures Account Balance

WSS

account.balance

wss://ws-dapi.binance.com/ws-dapi/v1

Futures Account Balance (USER_DATA) › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Futures Account Balance (USER_DATA) › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight5

Futures Account Balance (USER_DATA) › Request Parameters

id

string · required

Example: e9d6b4349871b40611412680b3445fac

method

string · enum · required

WebSocket API method name.

Enum values:

account.balance

Example: account.balance

object · required

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

apiKey

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

recvWindow

integer · int64 · max: 60000

Example: 5000

Futures Account Balance (USER_DATA) › Responses

Successful Response

Futures Account Balance

id

string

positionId

Example: 9328e612-1560-4108-979e-283bf85b5acb

status

integer · int64

Example: 200

object[]

Indicates that combined is set to true.

accountAlias

string

unique account code

Example: fWAuTiuXoCuXmY

asset

string

asset name

Example: WLD

balance

string

Account balance.

Example: 0.00000000

withdrawAvailable

string

Available amount for withdrawal.

Example: 0.00000000

crossWalletBalance

string

wallet balance for crossed margin

Example: 0.00000000

crossUnPnl

string

total unrealized profit or loss of crossed positions

Example: 0.00000000

availableBalance

string

available margin balance

Example: 0.00000000

updateTime

integer · int64

update time

Example: 0

object[]

Rate limit definitions.

rateLimitType

string

Rate limit type.

Example: REQUEST_WEIGHT

interval

string

Rate limit interval.

Example: MINUTE

intervalNum

integer · int64

Rate limit interval multiplier.

Example: 1

limit

integer · int64

Maximum allowed orders for this rule.

Example: 2400

count

integer · int64

Total number of trades in the 24h window.

Example: 10