Account

Endpoint

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.

GET

/fapi/v2/account

https://fapi.binance.com

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) › Headers

X-MBX-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

Account Information V2 (USER_DATA) › Query Parameters

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

recvWindow

integer · int64 · max: 60000

Example: 5000

Account Information V2 (USER_DATA) › Responses

200

Account Information V2

feeTier

integer · int64

Account commission tier.

Example: 0

feeBurn

boolean

Whether fee discount is enabled.

Example: true

canTrade

boolean

Whether trading is enabled.

Example: true

canDeposit

boolean

Whether transfer-in is enabled.

Example: true

canWithdraw

boolean

Whether transfer-out is enabled.

Example: true

updateTime

integer · int64

Reserved field, ignore.

Example: 0

multiAssetsMargin

boolean

Whether multi-assets mode is enabled.

Example: true

tradeGroupId

integer · int64

Trade group identifier.

Example: -1

totalInitialMargin

string

Total initial margin requirement.

Example: 0.00000000

totalMaintMargin

string

Total maintenance margin requirement.

Example: 0.00000000

totalWalletBalance

string

Total wallet balance.

Example: 126.72469206

totalUnrealizedProfit

string

Total unrealized profit.

Example: 0.00000000

totalMarginBalance

string

Total margin balance.

Example: 126.72469206

totalPositionInitialMargin

string

Initial margin required for positions.

Example: 0.00000000

totalOpenOrderInitialMargin

string

Initial margin required for open orders.

Example: 0.00000000

totalCrossWalletBalance

string

Cross wallet balance.

Example: 126.72469206

totalCrossUnPnl

string

Unrealized PnL for cross positions.

Example: 0.00000000

availableBalance

string

Available balance.

Example: 126.72469206

maxWithdrawAmount

string

Maximum transferable/withdrawable amount.

Example: 126.72469206

object[]

Asset-level account details.

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 requirement.

Example: 0.00000000

initialMargin

string

Total initial margin requirement.

Example: 0.00000000

positionInitialMargin

string

Initial margin required for positions.

Example: 0.00000000

openOrderInitialMargin

string

Initial margin required for open orders.

Example: 0.00000000

crossWalletBalance

string

Cross wallet balance.

Example: 23.72469206

crossUnPnl

string

Unrealized PnL for cross positions.

Example: 0.00000000

availableBalance

string

Available balance.

Example: 126.72469206

maxWithdrawAmount

string

Maximum transferable/withdrawable amount.

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 in milliseconds.

Example: 1625474304765

object[]

Position details for symbols. One-way mode returns BOTH; hedge mode returns LONG/SHORT.

positions of all symbols in the market are returned

symbol

string

Symbol.

Example: BTCUSDT

initialMargin

string

Initial margin requirement.

Example: 0

maintMargin

string

Maintenance margin requirement.

Example: 0

unrealizedProfit

string

Unrealized profit.

Example: 0.00000000

positionInitialMargin

string

Initial margin required for positions.

Example: 0

openOrderInitialMargin

string

Initial margin required for open orders.

Example: 0

leverage

string

Current initial leverage.

Example: 100

isolated

boolean

Whether the position uses isolated margin mode.

Example: true

entryPrice

string

Average entry price.

Example: 0.00000

maxNotional

string

Maximum available notional under current leverage.

Example: 250000

bidNotional

string

Bid notional (ignore).

Example: 0

askNotional

string

Ask notional (ignore).

Example: 0

positionSide

string

Position side.

Example: BOTH

positionAmt

string

Position quantity.

Example: 0

updateTime

integer · int64

Last update time in milliseconds.

Example: 0

GET/fapi/v2/account

curl --request GET \
  --url 'https://fapi.binance.com/fapi/v2/account?timestamp=%3Cnumber%3E' \
  --header 'X-MBX-APIKEY: <string>'

Example Responses

{
  "feeTier": 0,
  "feeBurn": true,
  "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
    }
  ]
}

json

application/json

Account Information V3 (USER_DATA)

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

GET

/fapi/v3/account

https://fapi.binance.com

Account Information V3 (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 V3 (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 V3 (USER_DATA) › Headers

X-MBX-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

Account Information V3 (USER_DATA) › Query Parameters

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

recvWindow

integer · int64 · max: 60000

Example: 5000

Account Information V3 (USER_DATA) › Responses

200

Account Information V3

totalInitialMargin

string

Total initial margin requirement.

Example: 0.00000000

totalMaintMargin

string

Total maintenance margin requirement.

Example: 0.00000000

totalWalletBalance

string

Total wallet balance.

Example: 126.72469206

totalUnrealizedProfit

string

Total unrealized profit.

Example: 0.00000000

totalMarginBalance

string

Total margin balance.

Example: 126.72469206

totalPositionInitialMargin

string

Initial margin required for positions.

Example: 0.00000000

totalOpenOrderInitialMargin

string

Initial margin required for open orders.

Example: 0.00000000

totalCrossWalletBalance

string

Cross wallet balance.

Example: 126.72469206

totalCrossUnPnl

string

Unrealized PnL for cross positions.

Example: 0.00000000

availableBalance

string

Available balance.

Example: 126.72469206

maxWithdrawAmount

string

Maximum transferable/withdrawable amount.

Example: 126.72469206

object[]

Asset-level account details.

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 requirement.

Example: 0.00000000

initialMargin

string

Total initial margin requirement.

Example: 0.00000000

positionInitialMargin

string

Initial margin required for positions.

Example: 0.00000000

openOrderInitialMargin

string

Initial margin required for open orders.

Example: 0.00000000

crossWalletBalance

string

Cross wallet balance.

Example: 23.72469206

crossUnPnl

string

Unrealized PnL for cross positions.

Example: 0.00000000

availableBalance

string

Available balance.

Example: 23.72469206

maxWithdrawAmount

string

Maximum transferable/withdrawable amount.

Example: 23.72469206

updateTime

integer · int64

Last update time in milliseconds.

Example: 1625474304765

object[]

Position details for symbols.

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

symbol

string

Symbol.

Example: BTCUSDT

positionSide

string

Position side.

Example: BOTH

positionAmt

string

Position quantity.

Example: 1.000

unrealizedProfit

string

Unrealized profit.

Example: 0.00000000

isolatedMargin

string

Isolated margin.

Example: 0.00000000

notional

string

Position notional value.

Example: 0

isolatedWallet

string

Isolated wallet balance.

Example: 0

initialMargin

string

Initial margin requirement.

Example: 0

maintMargin

string

Maintenance margin requirement.

Example: 0

updateTime

integer · int64

Last update time in milliseconds.

Example: 0

GET/fapi/v3/account

curl --request GET \
  --url 'https://fapi.binance.com/fapi/v3/account?timestamp=%3Cnumber%3E' \
  --header 'X-MBX-APIKEY: <string>'

Example Responses

{
  "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",
      "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
    }
  ]
}

json

application/json

Futures Account Balance V2 (USER_DATA)

Query account balance information.

GET

/fapi/v2/balance

https://fapi.binance.com

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) › Headers

X-MBX-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

Futures Account Balance V2 (USER_DATA) › Query Parameters

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

recvWindow

integer · int64 · max: 60000

Example: 5000

Futures Account Balance V2 (USER_DATA) › Responses

200

Futures Account Balance V2

object

accountAlias

string

Unique account alias.

Example: SgsR

asset

string

Asset name.

Example: USDT

balance

string

Wallet balance.

Example: 122607.35137903

crossWalletBalance

string

Cross wallet balance.

Example: 23.72469206

crossUnPnl

string

Unrealized PnL of cross positions.

Example: 0.00000000

availableBalance

string

Available balance.

Example: 23.72469206

maxWithdrawAmount

string

Maximum transferable/withdrawable amount.

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 in milliseconds.

Example: 1617939110373

Futures Account Balance V3 (USER_DATA)

Query account balance information.

GET

/fapi/v3/balance

https://fapi.binance.com

Futures Account Balance V3 (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 V3 (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 V3 (USER_DATA) › Headers

X-MBX-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

Futures Account Balance V3 (USER_DATA) › Query Parameters

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

recvWindow

integer · int64 · max: 60000

Example: 5000

Futures Account Balance V3 (USER_DATA) › Responses

200

Futures Account Balance V3

object

accountAlias

string

Unique account alias.

Example: SgsR

asset

string

Asset name.

Example: USDT

balance

string

Wallet balance.

Example: 122607.35137903

crossWalletBalance

string

Cross wallet balance.

Example: 23.72469206

crossUnPnl

string

Unrealized PnL of cross positions.

Example: 0.00000000

availableBalance

string

Available balance.

Example: 23.72469206

maxWithdrawAmount

string

Maximum transferable/withdrawable amount.

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 in milliseconds.

Example: 1617939110373

Futures Account Configuration (USER_DATA)

Query account configuration

GET

/fapi/v1/accountConfig

https://fapi.binance.com

Futures Account Configuration (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 Configuration (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 Configuration (USER_DATA) › Headers

X-MBX-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

Futures Account Configuration (USER_DATA) › Query Parameters

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

recvWindow

integer · int64 · max: 60000

Example: 5000

Futures Account Configuration (USER_DATA) › Responses

200

Futures Account Configuration

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

dualSidePosition

boolean

Example: true

updateTime

integer · int64

reserved property, please ignore

Example: 0

multiAssetsMargin

boolean

Example: false

tradeGroupId

integer · int64

Example: -1

Futures Trading Quantitative Rules Indicators (USER_DATA)

Futures trading quantitative rules indicators, for more information on this, please refer to the Futures Trading Quantitative Rules

GET

/fapi/v1/apiTradingStatus

https://fapi.binance.com

Futures Trading Quantitative Rules Indicators (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 Trading Quantitative Rules Indicators (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 Weight

1 for a single symbol
10 when the symbol parameter is omitted

Futures Trading Quantitative Rules Indicators (USER_DATA) › Headers

X-MBX-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

Futures Trading Quantitative Rules Indicators (USER_DATA) › Query Parameters

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

symbol

string

Example: BTCUSDT

recvWindow

integer · int64 · max: 60000

Example: 5000

Futures Trading Quantitative Rules Indicators (USER_DATA) › Responses

200

Futures Trading Quantitative Rules Indicators

object

indicator: quantitative rules indicators, value: user's indicators value, triggerValue: trigger indicator value threshold of quantitative rules.

object[]

isLocked

boolean

Is Locked.

Example: true

plannedRecoverTime

integer · int64

Planned Recover Time.

Example: 1545741270000

indicator

string

Too many violations under multiple symbols trigger account violation

Example: UFR

value

number · float

Current value

Example: 0.05

triggerValue

number · float

Trigger value

Example: 0.995

object[]

isLocked

boolean

Is Locked.

Example: true

plannedRecoverTime

integer · int64

Planned Recover Time.

Example: 1545741270000

indicator

string

Too many violations under multiple symbols trigger account violation

Example: UFR

value

number · float

Current value

Example: 0.05

triggerValue

number · float

Trigger value

Example: 0.995

object[]

indicator

string

Too many violations under multiple symbols trigger account violation

Example: TMV

value

integer · int64

Current value

Example: 10

triggerValue

integer · int64

Trigger value

Example: 1

plannedRecoverTime

integer · int64

Planned Recover Time.

Example: 1644919865000

isLocked

boolean

Is Locked.

Example: true

updateTime

integer · int64

Update Time.

Example: 1644913304748

GET/fapi/v1/apiTradingStatus

curl --request GET \
  --url 'https://fapi.binance.com/fapi/v1/apiTradingStatus?timestamp=%3Cnumber%3E' \
  --header 'X-MBX-APIKEY: <string>'

Example Responses

{
  "indicators": {
    "BTCUSDT": [
      {
        "isLocked": true,
        "plannedRecoverTime": 1545741270000,
        "indicator": "UFR",
        "value": 0.05,
        "triggerValue": 0.995
      }
    ],
    "ETHUSDT": [
      {
        "isLocked": true,
        "plannedRecoverTime": 1545741270000,
        "indicator": "UFR",
        "value": 0.05,
        "triggerValue": 0.995
      }
    ],
    "ACCOUNT": [
      {
        "indicator": "TMV",
        "value": 10,
        "triggerValue": 1,
        "plannedRecoverTime": 1644919865000,
        "isLocked": true
      }
    ]
  },
  "updateTime": 1644913304748
}

json

application/json

Get BNB Burn Status (USER_DATA)

Get user's BNB Fee Discount (Fee Discount On or Fee Discount Off )

GET

/fapi/v1/feeBurn

https://fapi.binance.com

Get BNB Burn Status (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

Get BNB Burn Status (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 Weight30

Get BNB Burn Status (USER_DATA) › Headers

X-MBX-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

Get BNB Burn Status (USER_DATA) › Query Parameters

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

recvWindow

integer · int64 · max: 60000

Example: 5000

Get BNB Burn Status (USER_DATA) › Responses

200

Get BNB Burn Status

feeBurn

boolean

"true": Fee Discount On; "false": Fee Discount Off

Example: true

Toggle BNB Burn On Futures Trade (TRADE)

Change user's BNB Fee Discount (Fee Discount On or Fee Discount Off ) on EVERY symbol

POST

/fapi/v1/feeBurn

https://fapi.binance.com

Toggle BNB Burn On Futures Trade (TRADE) › 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

Toggle BNB Burn On Futures Trade (TRADE) › 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 Weight1

Toggle BNB Burn On Futures Trade (TRADE) › Headers

X-MBX-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

Toggle BNB Burn On Futures Trade (TRADE) › Request Body

feeBurn

string · required

"true": Fee Discount On; "false": Fee Discount Off

Example: true

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

recvWindow

integer · int64 · max: 60000

Example: 5000

Toggle BNB Burn On Futures Trade (TRADE) › Responses

200

Toggle BNB Burn On Futures Trade

code

integer · int64

Example: 200

msg

string

Example: success

Get Current Multi-Assets Mode (USER_DATA)

Get user's Multi-Assets mode (Multi-Assets Mode or Single-Asset Mode) on Every symbol

GET

/fapi/v1/multiAssetsMargin

https://fapi.binance.com

Get Current Multi-Assets Mode (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

Get Current Multi-Assets Mode (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 Weight30

Get Current Multi-Assets Mode (USER_DATA) › Headers

X-MBX-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

Get Current Multi-Assets Mode (USER_DATA) › Query Parameters

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

recvWindow

integer · int64 · max: 60000

Example: 5000

Get Current Multi-Assets Mode (USER_DATA) › Responses

200

Get Current Multi-Assets Mode

multiAssetsMargin

boolean

"true": Multi-Assets Mode; "false": Single-Asset Mode

Example: true

Get Current Position Mode (USER_DATA)

Get user's position mode (Hedge Mode or One-way Mode ) on EVERY symbol

GET

/fapi/v1/positionSide/dual

https://fapi.binance.com

Get Current Position Mode (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

Get Current Position Mode (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 Weight30

Get Current Position Mode (USER_DATA) › Headers

X-MBX-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

Get Current Position Mode (USER_DATA) › Query Parameters

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

recvWindow

integer · int64 · max: 60000

Example: 5000

Get Current Position Mode (USER_DATA) › Responses

200

Get Current Position Mode

dualSidePosition

boolean

"true": Hedge Mode; "false": One-way Mode

Example: true

Get Download Id For Futures Order History (USER_DATA)

Get Download Id For Futures Order History

GET

/fapi/v1/order/asyn

https://fapi.binance.com

Get Download Id For Futures Order History (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

Get Download Id For Futures Order History (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 Weight1000

Get Download Id For Futures Order History (USER_DATA) › Headers

X-MBX-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

Get Download Id For Futures Order History (USER_DATA) › Query Parameters

startTime

integer · int64 · required

Timestamp in ms

Example: 1623319461670

endTime

integer · int64 · required

Timestamp in ms

Example: 1641782889000

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

recvWindow

integer · int64 · max: 60000

Example: 5000

Get Download Id For Futures Order History (USER_DATA) › Responses

200

Get Download Id For Futures Order History

avgCostTimestampOfLast30d

integer · int64

Average time taken for data download in the past 30 days

Example: 7241837

downloadId

string

Download Id.

Example: 546975389218332672

Get Download Id For Futures Trade History (USER_DATA)

Get download id for futures trade history

GET

/fapi/v1/trade/asyn

https://fapi.binance.com

Get Download Id For Futures Trade History (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

Get Download Id For Futures Trade History (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 Weight1000

Get Download Id For Futures Trade History (USER_DATA) › Headers

X-MBX-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

Get Download Id For Futures Trade History (USER_DATA) › Query Parameters

startTime

integer · int64 · required

Timestamp in ms

Example: 1623319461670

endTime

integer · int64 · required

Timestamp in ms

Example: 1641782889000

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

recvWindow

integer · int64 · max: 60000

Example: 5000

Get Download Id For Futures Trade History (USER_DATA) › Responses

200

Get Download Id For Futures Trade History

avgCostTimestampOfLast30d

integer · int64

Average time taken for data download in the past 30 days

Example: 7241837

downloadId

string

Download Id.

Example: 546975389218332672

Get Download Id For Futures Transaction History (USER_DATA)

Get download id for futures transaction history

GET

/fapi/v1/income/asyn

https://fapi.binance.com

Get Download Id For Futures Transaction History (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

Get Download Id For Futures Transaction History (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 Weight1000

Get Download Id For Futures Transaction History (USER_DATA) › Headers

X-MBX-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

Get Download Id For Futures Transaction History (USER_DATA) › Query Parameters

startTime

integer · int64 · required

Timestamp in ms

Example: 1623319461670

endTime

integer · int64 · required

Timestamp in ms

Example: 1641782889000

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

recvWindow

integer · int64 · max: 60000

Example: 5000

Get Download Id For Futures Transaction History (USER_DATA) › Responses

200

Get Download Id For Futures Transaction History

avgCostTimestampOfLast30d

integer · int64

Average time taken for data download in the past 30 days

Example: 7241837

downloadId

string

Download Id.

Example: 546975389218332672

Get Futures Order History Download Link by Id (USER_DATA)

Get futures order history download link by Id

GET

/fapi/v1/order/asyn/id

https://fapi.binance.com

Get Futures Order History Download Link by Id (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

Get Futures Order History Download Link by Id (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 Weight10

Get Futures Order History Download Link by Id (USER_DATA) › Headers

X-MBX-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

Get Futures Order History Download Link by Id (USER_DATA) › Query Parameters

downloadId

string · required

get by download id api

Example: 545923594199212032

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

recvWindow

integer · int64 · max: 60000

Example: 5000

Get Futures Order History Download Link by Id (USER_DATA) › Responses

200

Get Futures Order History Download Link by Id

downloadId

string

Download Id.

Example: 545923594199212032

status

string

Enum：completed，processing

Example: processing

url

string

The link is mapped to download id

Example:

notified

boolean

ignore

Example: false

expirationTimestamp

integer · int64

The link would expire after this timestamp

Example: -1

isExpired

string

Example: null

Get Futures Trade Download Link by Id (USER_DATA)

Get futures trade download link by Id

GET

/fapi/v1/trade/asyn/id

https://fapi.binance.com

Get Futures Trade Download Link by Id (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

Get Futures Trade Download Link by Id (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 Weight10

Get Futures Trade Download Link by Id (USER_DATA) › Headers

X-MBX-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

Get Futures Trade Download Link by Id (USER_DATA) › Query Parameters

downloadId

string · required

get by download id api

Example: 545923594199212032

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

recvWindow

integer · int64 · max: 60000

Example: 5000

Get Futures Trade Download Link by Id (USER_DATA) › Responses

200

Get Futures Trade Download Link by Id

downloadId

string

Download Id.

Example: 545923594199212032

status

string

Enum：completed，processing

Example: processing

url

string

The link is mapped to download id

Example: www.binance.com

notified

boolean

ignore

Example: false

expirationTimestamp

integer · int64

The link would expire after this timestamp

Example: 1645009771000

isExpired

string

Example: null

Get Futures Transaction History Download Link by Id (USER_DATA)

Get futures transaction history download link by Id

GET

/fapi/v1/income/asyn/id

https://fapi.binance.com

Get Futures Transaction History Download Link by Id (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

Get Futures Transaction History Download Link by Id (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 Weight10

Get Futures Transaction History Download Link by Id (USER_DATA) › Headers

X-MBX-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

Get Futures Transaction History Download Link by Id (USER_DATA) › Query Parameters

downloadId

string · required

get by download id api

Example: 545923594199212032

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

recvWindow

integer · int64 · max: 60000

Example: 5000

Get Futures Transaction History Download Link by Id (USER_DATA) › Responses

200

Get Futures Transaction History Download Link by Id

downloadId

string

Download Id.

Example: 545923594199212032

status

string

Enum：completed，processing

Example: processing

url

string

The link is mapped to download id

Example: www.binance.com

notified

boolean

ignore

Example: false

expirationTimestamp

integer · int64

The link would expire after this timestamp

Example: 1645009771000

isExpired

string

Example: null

Get Income History (USER_DATA)

Query income history

GET

/fapi/v1/income

https://fapi.binance.com

Get Income History (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

Get Income History (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 Weight30

Get Income History (USER_DATA) › Headers

X-MBX-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

Get Income History (USER_DATA) › Query Parameters

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

symbol

string

Trading symbol.

Example: BTCUSDT

incomeType

string · enum

Income type.

Enum values:

TRANSFER

WELCOME_BONUS

REALIZED_PNL

FUNDING_FEE

COMMISSION

INSURANCE_CLEAR

REFERRAL_KICKBACK

COMMISSION_REBATE

Example: TRANSFER

startTime

integer · int64

Timestamp in milliseconds (inclusive start).

Example: 1623319461670

endTime

integer · int64

Timestamp in milliseconds (inclusive end).

Example: 1641782889000

page

integer · int64

Pagination page number.

Example: 1

limit

integer · int64 · max: 1000

Maximum number of records to return.

Example: 30

Default: 100

recvWindow

integer · int64 · max: 60000

Example: 5000

Get Income History (USER_DATA) › Responses

200

Get Income History

object

symbol

string

trade symbol, if existing

Example:

incomeType

string

income type

Example: TRANSFER

income

string

income amount

Example: -0.37500000

asset

string

income asset

Example: USDT

info

string

extra information

Example: TRANSFER

time

integer · int64

Time.

Example: 1570608000000

tranId

integer · int64

transaction id

Example: 9689322392

tradeId

string

trade id, if existing

Example:

Notional and Leverage Brackets (USER_DATA)

Query user notional and leverage bracket on speicfic symbol

GET

/fapi/v1/leverageBracket

https://fapi.binance.com

Notional and Leverage Brackets (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

Notional and Leverage Brackets (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 Weight1

Notional and Leverage Brackets (USER_DATA) › Headers

X-MBX-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

Notional and Leverage Brackets (USER_DATA) › Query Parameters

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

symbol

string

Example: ETHUSDT

recvWindow

integer · int64 · max: 60000

Example: 5000

Notional and Leverage Brackets (USER_DATA) › Responses

200

Notional and Leverage Brackets

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = array
	type = object

Properties for Variant 1:

object

symbol

string

Example: ETHUSDT

notionalCoef

number · float

user symbol bracket multiplier, only appears when user's symbol bracket is adjusted

Example: 1.5

object[]

Example: []

bracket

integer · int64

Notional bracket

Example: 1

initialLeverage

integer · int64

Max initial leverage for this bracket

Example: 75

notionalCap

integer · int64

Cap notional of this bracket

Example: 10000

notionalFloor

integer · int64

Notional threshold of this bracket

Example: 0

maintMarginRatio

number · float

Maintenance ratio for this bracket

Example: 0.0065

cum

number · float

Auxiliary number for quick calculation

Example: 0

Query User Rate Limit (USER_DATA)

Query User Rate Limit

GET

/fapi/v1/rateLimit/order

https://fapi.binance.com

Query User Rate Limit (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

Query User Rate Limit (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 Weight1

Query User Rate Limit (USER_DATA) › Headers

X-MBX-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

Query User Rate Limit (USER_DATA) › Query Parameters

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

recvWindow

integer · int64 · max: 60000

Example: 5000

Query User Rate Limit (USER_DATA) › Responses

200

User Rate Limit

object

rateLimitType

string

Example: ORDERS

interval

string

Example: SECOND

intervalNum

integer · int64

Example: 10

limit

integer · int64

Example: 10000

Symbol Configuration (USER_DATA)

Get current account symbol configuration.

GET

/fapi/v1/symbolConfig

https://fapi.binance.com

Symbol Configuration (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

Symbol Configuration (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

Symbol Configuration (USER_DATA) › Headers

X-MBX-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

Symbol Configuration (USER_DATA) › Query Parameters

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

symbol

string

Symbol

Example: BTCUSDT

recvWindow

integer · int64 · max: 60000

Example: 5000

Symbol Configuration (USER_DATA) › Responses

200

Symbol Configuration

object

symbol

string

Example: BTCUSDT

marginType

string

Example: CROSSED

isAutoAddMargin

boolean

Example: false

leverage

integer · int64

Example: 21

maxNotionalValue

string

Example: 1000000

User Commission Rate (USER_DATA)

Get User Commission Rate

GET

/fapi/v1/commissionRate

https://fapi.binance.com

User Commission Rate (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

User Commission Rate (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 Weight20

User Commission Rate (USER_DATA) › Headers

X-MBX-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

User Commission Rate (USER_DATA) › Query Parameters

symbol

string · required

Symbol

Example: BTCUSDT

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

recvWindow

integer · int64 · max: 60000

Example: 5000

User Commission Rate (USER_DATA) › Responses

200

User Commission Rate

symbol

string

Example: BTCUSDT

makerCommissionRate

string

0.02%

Example: 0.0002

takerCommissionRate

string

0.04%

Example: 0.0004

rpiCommissionRate

string

0.005%

Example: 0.00005