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-fapi.binance.com/ws-fapi/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

Id.

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

Recv Window.

Example: 5000

Account Information (USER_DATA) › Responses

Successful Response

Account Information

id

string

Example: 605a6d20-6588-4cb9-afa0-b0ab087507ba

status

integer · int64

Example: 200

object

feeTier

integer · int64

account commission tier

Example: 0

canTrade

boolean

if can trade

Example: true

canDeposit

boolean

if can transfer in asset

Example: true

canWithdraw

boolean

if can transfer out asset

Example: true

updateTime

integer · int64

reserved property, please ignore

Example: 0

multiAssetsMargin

boolean

Example: true

tradeGroupId

integer · int64

Example: -1

totalInitialMargin

string

total initial margin required with current mark price (useless with isolated positions), only for USDT asset

Example: 0.00000000

totalMaintMargin

string

the sum of USD value of all cross positions maintenance margin

Example: 0.00000000

totalWalletBalance

string

total wallet balance, only for USDT asset

Example: 126.72469206

totalUnrealizedProfit

string

total unrealized profit, only for USDT asset

Example: 0.00000000

totalMarginBalance

string

total margin balance, only for USDT asset

Example: 126.72469206

totalPositionInitialMargin

string

initial margin required for positions with current mark price, only for USDT asset

Example: 0.00000000

totalOpenOrderInitialMargin

string

initial margin required for open orders with current mark price, only for USDT asset

Example: 0.00000000

totalCrossWalletBalance

string

crossed wallet balance, only for USDT asset

Example: 126.72469206

totalCrossUnPnl

string

unrealized profit of crossed positions, only for USDT asset

Example: 0.00000000

availableBalance

string

available balance, only for USDT asset

Example: 126.72469206

maxWithdrawAmount

string

maximum amount for transfer out, only for USDT asset

Example: 126.72469206

object[]

asset

string

asset name

Example: USDT

walletBalance

string

wallet balance

Example: 23.72469206

unrealizedProfit

string

unrealized profit

Example: 0.00000000

marginBalance

string

margin balance

Example: 23.72469206

maintMargin

string

maintenance margin required

Example: 0.00000000

initialMargin

string

total initial margin required with current mark price

Example: 0.00000000

positionInitialMargin

string

initial margin required for positions with current mark price

Example: 0.00000000

openOrderInitialMargin

string

initial margin required for open orders with current mark price

Example: 0.00000000

crossWalletBalance

string

crossed wallet balance

Example: 23.72469206

crossUnPnl

string

unrealized profit of crossed positions

Example: 0.00000000

availableBalance

string

available balance, only for USDT asset

Example: 126.72469206

maxWithdrawAmount

string

maximum amount for transfer out, only for USDT asset

Example: 23.72469206

marginAvailable

boolean

whether the asset can be used as margin in Multi-Assets mode

Example: true

updateTime

integer · int64

reserved property, please ignore

Example: 1625474304765

object[]

positions of all symbols in the market are returned

symbol

string

symbol name

Example: BTCUSDT

initialMargin

string

total initial margin required with current mark price

Example: 0

maintMargin

string

maintenance margin required

Example: 0

unrealizedProfit

string

unrealized profit

Example: 0.00000000

positionInitialMargin

string

initial margin required for positions with current mark price

Example: 0

openOrderInitialMargin

string

initial margin required for open orders with current mark price

Example: 0

leverage

string

current initial leverage

Example: 100

isolated

boolean

if the position is isolated

Example: true

entryPrice

string

average entry price

Example: 0.00000

maxNotional

string

maximum available notional with current leverage

Example: 250000

bidNotional

string

bids notional, ignore

Example: 0

askNotional

string

ask notional, ignore

Example: 0

positionSide

string

position side

Example: BOTH

positionAmt

string

position amount

Example: 0

updateTime

integer · int64

reserved property, please ignore

Example: 0

breakEvenPrice

string

average entry price

Example: 0.0

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 2400

count

integer · int64

Example: 20

WSSaccount.status

wscat -c wss://ws-fapi.binance.com/ws-fapi/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": "605a6d20-6588-4cb9-afa0-b0ab087507ba",
  "status": 200,
  "result": {
    "feeTier": 0,
    "canTrade": true,
    "canDeposit": true,
    "canWithdraw": true,
    "updateTime": 0,
    "multiAssetsMargin": true,
    "tradeGroupId": -1,
    "totalInitialMargin": "0.00000000",
    "totalMaintMargin": "0.00000000",
    "totalWalletBalance": "126.72469206",
    "totalUnrealizedProfit": "0.00000000",
    "totalMarginBalance": "126.72469206",
    "totalPositionInitialMargin": "0.00000000",
    "totalOpenOrderInitialMargin": "0.00000000",
    "totalCrossWalletBalance": "126.72469206",
    "totalCrossUnPnl": "0.00000000",
    "availableBalance": "126.72469206",
    "maxWithdrawAmount": "126.72469206",
    "assets": [
      {
        "asset": "USDT",
        "walletBalance": "23.72469206",
        "unrealizedProfit": "0.00000000",
        "marginBalance": "23.72469206",
        "maintMargin": "0.00000000",
        "initialMargin": "0.00000000",
        "positionInitialMargin": "0.00000000",
        "openOrderInitialMargin": "0.00000000",
        "crossWalletBalance": "23.72469206",
        "crossUnPnl": "0.00000000",
        "availableBalance": "126.72469206",
        "maxWithdrawAmount": "23.72469206",
        "marginAvailable": true,
        "updateTime": 1625474304765
      }
    ],
    "positions": [
      {
        "symbol": "BTCUSDT",
        "initialMargin": "0",
        "maintMargin": "0",
        "unrealizedProfit": "0.00000000",
        "positionInitialMargin": "0",
        "openOrderInitialMargin": "0",
        "leverage": "100",
        "isolated": true,
        "entryPrice": "0.00000",
        "maxNotional": "250000",
        "bidNotional": "0",
        "askNotional": "0",
        "positionSide": "BOTH",
        "positionAmt": "0",
        "updateTime": 0,
        "breakEvenPrice": "0.0"
      }
    ]
  },
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 2400,
      "count": 20
    }
  ]
}

json

application/json

Account Information V2 (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

v2/account.status

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

Account Information V2 (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 V2 (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 V2 (USER_DATA) › Request Parameters

id

string · required

Id.

Example: e9d6b4349871b40611412680b3445fac

method

string · enum · required

WebSocket API method name.

Enum values:

v2/account.status

Example: v2/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

Recv Window.

Example: 5000

Account Information V2 (USER_DATA) › Responses

Successful Response

Account Information V2

id

string

Example: 605a6d20-6588-4cb9-afa0-b0ab087507ba

status

integer · int64

Example: 200

object

totalInitialMargin

string

total initial margin required with current mark price (useless with isolated positions), only for USDT asset

Example: 0.00000000

totalMaintMargin

string

the sum of USD value of all cross positions maintenance margin

Example: 0.00000000

totalWalletBalance

string

total wallet balance, only for USDT asset

Example: 126.72469206

totalUnrealizedProfit

string

total unrealized profit, only for USDT asset

Example: 0.00000000

totalMarginBalance

string

total margin balance, only for USDT asset

Example: 126.72469206

totalPositionInitialMargin

string

initial margin required for positions with current mark price, only for USDT asset

Example: 0.00000000

totalOpenOrderInitialMargin

string

initial margin required for open orders with current mark price, only for USDT asset

Example: 0.00000000

totalCrossWalletBalance

string

crossed wallet balance, only for USDT asset

Example: 126.72469206

totalCrossUnPnl

string

unrealized profit of crossed positions, only for USDT asset

Example: 0.00000000

availableBalance

string

available balance, only for USDT asset

Example: 126.72469206

maxWithdrawAmount

string

maximum amount for transfer out, only for USDT asset

Example: 126.72469206

object[]

For assets that are quote assets, USDT/USDC/BTC

asset

string

asset name

Example: USDT

walletBalance

string

wallet balance

Example: 23.72469206

unrealizedProfit

string

unrealized profit

Example: 0.00000000

marginBalance

string

margin balance

Example: 23.72469206

maintMargin

string

maintenance margin required

Example: 0.00000000

initialMargin

string

total initial margin required with current mark price

Example: 0.00000000

positionInitialMargin

string

initial margin required for positions with current mark price

Example: 0.00000000

openOrderInitialMargin

string

initial margin required for open orders with current mark price

Example: 0.00000000

crossWalletBalance

string

crossed wallet balance

Example: 23.72469206

crossUnPnl

string

unrealized profit of crossed positions

Example: 0.00000000

availableBalance

string

available balance, only for USDT asset

Example: 23.72469206

maxWithdrawAmount

string

maximum amount for transfer out, only for USDT asset

Example: 23.72469206

marginAvailable

boolean

whether the asset can be used as margin in Multi-Assets mode

Example: true

updateTime

integer · int64

last update time

Example: 1625474304765

object[]

positions of all symbols user had position/ open orders are returned

symbol

string

Example: BTCUSDT

positionSide

string

position side

Example: BOTH

positionAmt

string

Example: 1.000

unrealizedProfit

string

unrealized profit

Example: 0.00000000

isolatedMargin

string

Example: 0.00000000

notional

string

Example: 0

isolatedWallet

string

Example: 0

initialMargin

string

total initial margin required with current mark price

Example: 0

maintMargin

string

maintenance margin required

Example: 0

updateTime

integer · int64

last update time

Example: 0

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 2400

count

integer · int64

Example: 20

WSSv2/account.status

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

Example Request

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

json

application/json

Example Responses

{
  "id": "605a6d20-6588-4cb9-afa0-b0ab087507ba",
  "status": 200,
  "result": {
    "totalInitialMargin": "0.00000000",
    "totalMaintMargin": "0.00000000",
    "totalWalletBalance": "126.72469206",
    "totalUnrealizedProfit": "0.00000000",
    "totalMarginBalance": "126.72469206",
    "totalPositionInitialMargin": "0.00000000",
    "totalOpenOrderInitialMargin": "0.00000000",
    "totalCrossWalletBalance": "126.72469206",
    "totalCrossUnPnl": "0.00000000",
    "availableBalance": "126.72469206",
    "maxWithdrawAmount": "126.72469206",
    "assets": [
      {
        "asset": "USDT",
        "walletBalance": "23.72469206",
        "unrealizedProfit": "0.00000000",
        "marginBalance": "23.72469206",
        "maintMargin": "0.00000000",
        "initialMargin": "0.00000000",
        "positionInitialMargin": "0.00000000",
        "openOrderInitialMargin": "0.00000000",
        "crossWalletBalance": "23.72469206",
        "crossUnPnl": "0.00000000",
        "availableBalance": "23.72469206",
        "maxWithdrawAmount": "23.72469206",
        "marginAvailable": true,
        "updateTime": 1625474304765
      }
    ],
    "positions": [
      {
        "symbol": "BTCUSDT",
        "positionSide": "BOTH",
        "positionAmt": "1.000",
        "unrealizedProfit": "0.00000000",
        "isolatedMargin": "0.00000000",
        "notional": "0",
        "isolatedWallet": "0",
        "initialMargin": "0",
        "maintMargin": "0",
        "updateTime": 0
      }
    ]
  },
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 2400,
      "count": 20
    }
  ]
}

json

application/json

Futures Account Balance (USER_DATA)

Futures Account Balance

WSS

account.balance

wss://ws-fapi.binance.com/ws-fapi/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

Id.

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

Recv Window.

Example: 5000

Futures Account Balance (USER_DATA) › Responses

Successful Response

Futures Account Balance

id

string

Example: 605a6d20-6588-4cb9-afa0-b0ab087507ba

status

integer · int64

Example: 200

object[]

accountAlias

string

unique account code

Example: SgsR

asset

string

asset name

Example: USDT

balance

string

wallet balance

Example: 122607.35137903

crossWalletBalance

string

crossed wallet balance

Example: 23.72469206

crossUnPnl

string

unrealized profit of crossed positions

Example: 0.00000000

availableBalance

string

available balance

Example: 23.72469206

maxWithdrawAmount

string

maximum amount for transfer out

Example: 23.72469206

marginAvailable

boolean

whether the asset can be used as margin in Multi-Assets mode

Example: true

updateTime

integer · int64

Example: 1617939110373

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 2400

count

integer · int64

Example: 20

WSSaccount.balance

wscat -c wss://ws-fapi.binance.com/ws-fapi/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": "605a6d20-6588-4cb9-afa0-b0ab087507ba",
  "status": 200,
  "result": [
    {
      "accountAlias": "SgsR",
      "asset": "USDT",
      "balance": "122607.35137903",
      "crossWalletBalance": "23.72469206",
      "crossUnPnl": "0.00000000",
      "availableBalance": "23.72469206",
      "maxWithdrawAmount": "23.72469206",
      "marginAvailable": true,
      "updateTime": 1617939110373
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 2400,
      "count": 20
    }
  ]
}

json

application/json

Futures Account Balance V2 (USER_DATA)

Futures Account Balance V2

WSS

v2/account.balance

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

Futures Account Balance V2 (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 V2 (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 V2 (USER_DATA) › Request Parameters

id

string · required

Id.

Example: e9d6b4349871b40611412680b3445fac

method

string · enum · required

WebSocket API method name.

Enum values:

v2/account.balance

Example: v2/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

Recv Window.

Example: 5000

Futures Account Balance V2 (USER_DATA) › Responses

Successful Response

Futures Account Balance V2

id

string

Example: 605a6d20-6588-4cb9-afa0-b0ab087507ba

status

integer · int64

Example: 200

object[]

accountAlias

string

unique account code

Example: SgsR

asset

string

asset name

Example: USDT

balance

string

wallet balance

Example: 122607.35137903

crossWalletBalance

string

crossed wallet balance

Example: 23.72469206

crossUnPnl

string

unrealized profit of crossed positions

Example: 0.00000000

availableBalance

string

available balance

Example: 23.72469206

maxWithdrawAmount

string

maximum amount for transfer out

Example: 23.72469206

marginAvailable

boolean

whether the asset can be used as margin in Multi-Assets mode

Example: true

updateTime

integer · int64

Example: 1617939110373

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 2400

count

integer · int64

Example: 20

WSSv2/account.balance

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

Example Request

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

json

application/json

Example Responses

{
  "id": "605a6d20-6588-4cb9-afa0-b0ab087507ba",
  "status": 200,
  "result": [
    {
      "accountAlias": "SgsR",
      "asset": "USDT",
      "balance": "122607.35137903",
      "crossWalletBalance": "23.72469206",
      "crossUnPnl": "0.00000000",
      "availableBalance": "23.72469206",
      "maxWithdrawAmount": "23.72469206",
      "marginAvailable": true,
      "updateTime": 1617939110373
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 2400,
      "count": 20
    }
  ]
}

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-fapi.binance.com/ws-fapi/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

Id.

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

Recv Window.

Example: 5000

Account Information (USER_DATA) › Responses

Successful Response

Account Information

id

string

Example: 605a6d20-6588-4cb9-afa0-b0ab087507ba

status

integer · int64

Example: 200

object

feeTier

integer · int64

account commission tier

Example: 0

canTrade

boolean

if can trade

Example: true

canDeposit

boolean

if can transfer in asset

Example: true

canWithdraw

boolean

if can transfer out asset

Example: true

updateTime

integer · int64

reserved property, please ignore

Example: 0

multiAssetsMargin

boolean

Example: true

tradeGroupId

integer · int64

Example: -1

totalInitialMargin

string

total initial margin required with current mark price (useless with isolated positions), only for USDT asset

Example: 0.00000000

totalMaintMargin

string

the sum of USD value of all cross positions maintenance margin

Example: 0.00000000

totalWalletBalance

string

total wallet balance, only for USDT asset

Example: 126.72469206

totalUnrealizedProfit

string

total unrealized profit, only for USDT asset

Example: 0.00000000

totalMarginBalance

string

total margin balance, only for USDT asset

Example: 126.72469206

totalPositionInitialMargin

string

initial margin required for positions with current mark price, only for USDT asset

Example: 0.00000000

totalOpenOrderInitialMargin

string

initial margin required for open orders with current mark price, only for USDT asset

Example: 0.00000000

totalCrossWalletBalance

string

crossed wallet balance, only for USDT asset

Example: 126.72469206

totalCrossUnPnl

string

unrealized profit of crossed positions, only for USDT asset

Example: 0.00000000

availableBalance

string

available balance, only for USDT asset

Example: 126.72469206

maxWithdrawAmount

string

maximum amount for transfer out, only for USDT asset

Example: 126.72469206

object[]

asset

string

asset name

Example: USDT

walletBalance

string

wallet balance

Example: 23.72469206

unrealizedProfit

string

unrealized profit

Example: 0.00000000

marginBalance

string

margin balance

Example: 23.72469206

maintMargin

string

maintenance margin required

Example: 0.00000000

initialMargin

string

total initial margin required with current mark price

Example: 0.00000000

positionInitialMargin

string

initial margin required for positions with current mark price

Example: 0.00000000

openOrderInitialMargin

string

initial margin required for open orders with current mark price

Example: 0.00000000

crossWalletBalance

string

crossed wallet balance

Example: 23.72469206

crossUnPnl

string

unrealized profit of crossed positions

Example: 0.00000000

availableBalance

string

available balance, only for USDT asset

Example: 126.72469206

maxWithdrawAmount

string

maximum amount for transfer out, only for USDT asset

Example: 23.72469206

marginAvailable

boolean

whether the asset can be used as margin in Multi-Assets mode

Example: true

updateTime

integer · int64

reserved property, please ignore

Example: 1625474304765

object[]

positions of all symbols in the market are returned

symbol

string

symbol name

Example: BTCUSDT

initialMargin

string

total initial margin required with current mark price

Example: 0

maintMargin

string

maintenance margin required

Example: 0

unrealizedProfit

string

unrealized profit

Example: 0.00000000

positionInitialMargin

string

initial margin required for positions with current mark price

Example: 0

openOrderInitialMargin

string

initial margin required for open orders with current mark price

Example: 0

leverage

string

current initial leverage

Example: 100

isolated

boolean

if the position is isolated

Example: true

entryPrice

string

average entry price

Example: 0.00000

maxNotional

string

maximum available notional with current leverage

Example: 250000

bidNotional

string

bids notional, ignore

Example: 0

askNotional

string

ask notional, ignore

Example: 0

positionSide

string

position side

Example: BOTH

positionAmt

string

position amount

Example: 0

updateTime

integer · int64

reserved property, please ignore

Example: 0

breakEvenPrice

string

average entry price

Example: 0.0

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 2400

count

integer · int64

Example: 20

Account Information V2 (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

v2/account.status

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

Account Information V2 (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 V2 (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 V2 (USER_DATA) › Request Parameters

id

string · required

Id.

Example: e9d6b4349871b40611412680b3445fac

method

string · enum · required

WebSocket API method name.

Enum values:

v2/account.status

Example: v2/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

Recv Window.

Example: 5000

Account Information V2 (USER_DATA) › Responses

Successful Response

Account Information V2

id

string

Example: 605a6d20-6588-4cb9-afa0-b0ab087507ba

status

integer · int64

Example: 200

object

totalInitialMargin

string

total initial margin required with current mark price (useless with isolated positions), only for USDT asset

Example: 0.00000000

totalMaintMargin

string

the sum of USD value of all cross positions maintenance margin

Example: 0.00000000

totalWalletBalance

string

total wallet balance, only for USDT asset

Example: 126.72469206

totalUnrealizedProfit

string

total unrealized profit, only for USDT asset

Example: 0.00000000

totalMarginBalance

string

total margin balance, only for USDT asset

Example: 126.72469206

totalPositionInitialMargin

string

initial margin required for positions with current mark price, only for USDT asset

Example: 0.00000000

totalOpenOrderInitialMargin

string

initial margin required for open orders with current mark price, only for USDT asset

Example: 0.00000000

totalCrossWalletBalance

string

crossed wallet balance, only for USDT asset

Example: 126.72469206

totalCrossUnPnl

string

unrealized profit of crossed positions, only for USDT asset

Example: 0.00000000

availableBalance

string

available balance, only for USDT asset

Example: 126.72469206

maxWithdrawAmount

string

maximum amount for transfer out, only for USDT asset

Example: 126.72469206

object[]

For assets that are quote assets, USDT/USDC/BTC

asset

string

asset name

Example: USDT

walletBalance

string

wallet balance

Example: 23.72469206

unrealizedProfit

string

unrealized profit

Example: 0.00000000

marginBalance

string

margin balance

Example: 23.72469206

maintMargin

string

maintenance margin required

Example: 0.00000000

initialMargin

string

total initial margin required with current mark price

Example: 0.00000000

positionInitialMargin

string

initial margin required for positions with current mark price

Example: 0.00000000

openOrderInitialMargin

string

initial margin required for open orders with current mark price

Example: 0.00000000

crossWalletBalance

string

crossed wallet balance

Example: 23.72469206

crossUnPnl

string

unrealized profit of crossed positions

Example: 0.00000000

availableBalance

string

available balance, only for USDT asset

Example: 23.72469206

maxWithdrawAmount

string

maximum amount for transfer out, only for USDT asset

Example: 23.72469206

marginAvailable

boolean

whether the asset can be used as margin in Multi-Assets mode

Example: true

updateTime

integer · int64

last update time

Example: 1625474304765

object[]

positions of all symbols user had position/ open orders are returned

symbol

string

Example: BTCUSDT

positionSide

string

position side

Example: BOTH

positionAmt

string

Example: 1.000

unrealizedProfit

string

unrealized profit

Example: 0.00000000

isolatedMargin

string

Example: 0.00000000

notional

string

Example: 0

isolatedWallet

string

Example: 0

initialMargin

string

total initial margin required with current mark price

Example: 0

maintMargin

string

maintenance margin required

Example: 0

updateTime

integer · int64

last update time

Example: 0

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 2400

count

integer · int64

Example: 20

Futures Account Balance (USER_DATA)

Futures Account Balance

WSS

account.balance

wss://ws-fapi.binance.com/ws-fapi/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

Id.

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

Recv Window.

Example: 5000

Futures Account Balance (USER_DATA) › Responses

Successful Response

Futures Account Balance

id

string

Example: 605a6d20-6588-4cb9-afa0-b0ab087507ba

status

integer · int64

Example: 200

object[]

accountAlias

string

unique account code

Example: SgsR

asset

string

asset name

Example: USDT

balance

string

wallet balance

Example: 122607.35137903

crossWalletBalance

string

crossed wallet balance

Example: 23.72469206

crossUnPnl

string

unrealized profit of crossed positions

Example: 0.00000000

availableBalance

string

available balance

Example: 23.72469206

maxWithdrawAmount

string

maximum amount for transfer out

Example: 23.72469206

marginAvailable

boolean

whether the asset can be used as margin in Multi-Assets mode

Example: true

updateTime

integer · int64

Example: 1617939110373

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 2400

count

integer · int64

Example: 20

Futures Account Balance V2 (USER_DATA)

Futures Account Balance V2

WSS

v2/account.balance

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

Futures Account Balance V2 (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 V2 (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 V2 (USER_DATA) › Request Parameters

id

string · required

Id.

Example: e9d6b4349871b40611412680b3445fac

method

string · enum · required

WebSocket API method name.

Enum values:

v2/account.balance

Example: v2/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

Recv Window.

Example: 5000

Futures Account Balance V2 (USER_DATA) › Responses

Successful Response

Futures Account Balance V2

id

string

Example: 605a6d20-6588-4cb9-afa0-b0ab087507ba

status

integer · int64

Example: 200

object[]

accountAlias

string

unique account code

Example: SgsR

asset

string

asset name

Example: USDT

balance

string

wallet balance

Example: 122607.35137903

crossWalletBalance

string

crossed wallet balance

Example: 23.72469206

crossUnPnl

string

unrealized profit of crossed positions

Example: 0.00000000

availableBalance

string

available balance

Example: 23.72469206

maxWithdrawAmount

string

maximum amount for transfer out

Example: 23.72469206

marginAvailable

boolean

whether the asset can be used as margin in Multi-Assets mode

Example: true

updateTime

integer · int64

Example: 1617939110373

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 2400

count

integer · int64

Example: 20