Asset

Endpoint

Asset Detail

Fetch details of assets supported on Binance.

GET

/sapi/v1/asset/assetDetail

https://api.binance.com

Asset Detail › 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

Asset Detail › 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

Asset Detail › 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

Asset Detail › 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

asset

string

Example: BTC

recvWindow

integer · int64 · max: 60000

Example: 5000

Asset Detail › Responses

200

Asset Detail

object

Asset Dividend Record

Query asset dividend record.

GET

/sapi/v1/asset/assetDividend

https://api.binance.com

Asset Dividend Record › 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

Asset Dividend Record › 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

Asset Dividend Record › 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

Asset Dividend Record › 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

asset

string

Example: BTC

startTime

integer · int64

Example: 1623319461670

endTime

integer · int64

Example: 1641782889000

limit

integer · int64 · max: 500

Example: 20

Default: 20

recvWindow

integer · int64 · max: 60000

Example: 5000

Asset Dividend Record › Responses

200

Asset Dividend Record

object[]

total

integer · int64

Example: 2

Dust Convert

Convert dust assets

POST

/sapi/v1/asset/dust-convert/convert

https://api.binance.com

Dust Convert › 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

Dust Convert › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight10

Dust Convert › 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

Dust Convert › Request Body

asset

string · required

Example: USDT

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

accountType

string

SPOT or MARGIN, default SPOT

Example: SPOT

clientId

string

A unique id for the request

Example: 1

targetAsset

string

Example: BTC

thirdPartyClientId

string

Example: 1

dustQuotaAssetToTargetAssetPrice

number · float

Example: 1.0

Dust Convert › Responses

200

Dust Convert

totalTransfered

string

Example: 3.5971223

totalServiceCharge

string

Example: 0.0794964

object[]

Dust Convertible Assets

Query dust convertible assets

POST

/sapi/v1/asset/dust-convert/query-convertible-assets

https://api.binance.com

Dust Convertible Assets › 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

Dust Convertible Assets › 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

Dust Convertible Assets › 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

Dust Convertible Assets › Request Body

targetAsset

string · required

Example: BTC

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

accountType

string

SPOT or MARGIN, default SPOT

Example: SPOT

dustQuotaAssetToTargetAssetPrice

number · float

Example: 1.0

Dust Convertible Assets › Responses

200

Dust Convertible Assets

dribbletPercentage

string

Example: 0.02

totalTransferQuotaAssetAmount

string

Example: 0.7899968

totalTransferTargetAssetAmount

string

Example: 0.7899968

dribbletBase

string

Example: 10

object[]

POST/sapi/v1/asset/dust-convert/query-convertible-assets

curl --request POST \
  --url https://api.binance.com/sapi/v1/asset/dust-convert/query-convertible-assets \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'X-MBX-APIKEY: <string>' \
  --data targetAsset=BTC \
  --data timestamp=1770736694138

Example Request Body

{
  "targetAsset": "BTC",
  "timestamp": 1770736694138
}

json

Example Responses

{
  "dribbletPercentage": "0.02",
  "totalTransferQuotaAssetAmount": "0.7899968",
  "totalTransferTargetAssetAmount": "0.7899968",
  "dribbletBase": "10",
  "details": [
    {
      "asset": "AR",
      "assetFullName": "AR",
      "amountFree": "0.00856",
      "exchange": "0.00073616",
      "toQuotaAssetAmount": "0.036808",
      "toTargetAssetAmount": "0.036808",
      "toTargetAssetOffExchange": "0.03607184"
    }
  ]
}

json

application/json

DustLog

Dustlog

GET

/sapi/v1/asset/dribblet

https://api.binance.com

DustLog › 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

DustLog › 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

DustLog › 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

DustLog › 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

accountType

string · enum

Enum values:

SPOT

MARGIN

Example: SPOT

startTime

integer · int64

Example: 1623319461670

endTime

integer · int64

Example: 1641782889000

recvWindow

integer · int64 · max: 60000

Example: 5000

DustLog › Responses

200

DustLog

total

integer · int64

Example: 8

object[]

Dust Transfer

Convert dust assets to BNB.

POST

/sapi/v1/asset/dust

https://api.binance.com

Dust Transfer › 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

Dust Transfer › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight10

Dust Transfer › 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

Dust Transfer › Request Body

asset

string · required

The asset being converted. For example: asset=BTC,USDT

Example: BTC

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

accountType

string · enum

Enum values:

SPOT

MARGIN

Example: SPOT

Default: SPOT

recvWindow

integer · int64 · max: 60000

Example: 5000

Dust Transfer › Responses

200

Dust Transfer

totalServiceCharge

string

Example: 0.02102542

totalTransfered

string

Example: 1.05127099

object[]

Funding Wallet

Query Funding Wallet

POST

/sapi/v1/asset/get-funding-asset

https://api.binance.com

Funding Wallet › 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

Funding Wallet › 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

Funding Wallet › 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

Funding Wallet › Request Body

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

asset

string

Example: BTC

needBtcValuation

boolean

Example: true

recvWindow

integer · int64 · max: 60000

Example: 5000

Funding Wallet › Responses

200

Funding Wallet

object

asset

string

Example: USDT

free

string

Example: 1

locked

string

Example: 0

freeze

string

Example: 0

withdrawing

string

Example: 0

btcValuation

string

Example: 0.00000091

Get Assets That Can Be Converted Into BNB

POST

/sapi/v1/asset/dust-btc

https://api.binance.com

Get Assets That Can Be Converted Into BNB › 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 Assets That Can Be Converted Into BNB › 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

Get Assets That Can Be Converted Into BNB › 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 Assets That Can Be Converted Into BNB › Request Body

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

accountType

string · enum

Enum values:

SPOT

MARGIN

Example: SPOT

Default: SPOT

recvWindow

integer · int64 · max: 60000

Example: 5000

Get Assets That Can Be Converted Into BNB › Responses

200

Get Assets That Can Be Converted Into BNB

object[]

totalTransferBtc

string

Example: 0.00016848

totalTransferBNB

string

Example: 0.01777302

dribbletPercentage

string

Example: 0.02

Get Cloud-Mining payment and refund history

The query of Cloud-Mining payment and refund history

GET

/sapi/v1/asset/ledger-transfer/cloud-mining/queryByPage

https://api.binance.com

Get Cloud-Mining payment and refund history › 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 Cloud-Mining payment and refund history › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight600

Get Cloud-Mining payment and refund history › 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 Cloud-Mining payment and refund history › Query Parameters

startTime

integer · int64 · required

inclusive, unit: ms

Example: 1623319461670

endTime

integer · int64 · required

exclusive, unit: 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

tranId

integer · int64

The transaction id

Example: 1

clientTranId

string

The unique flag

Example: 1

asset

string

If it is blank, we will query all assets

Example: BTC

current

integer · int64 · min: 1

Example: 1

Default: 1

size

integer · int64 · max: 100

Example: 10

Default: 10

Get Cloud-Mining payment and refund history › Responses

200

Get Cloud-Mining payment and refund history

total

integer · int64

Example: 5

object[]

Get Open Symbol List

Get the list of symbols that are scheduled to be opened for trading in the market.

GET

/sapi/v1/spot/open-symbol-list

https://api.binance.com

Get Open Symbol List › 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 Weight100

Get Open Symbol List › 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 Open Symbol List › Responses

200

Get Open Symbol List

object

openTime

integer · int64

Example: 1686161202000

symbols

string[]

Query User Delegation History(For Master Account)

Query User Delegation History

GET

/sapi/v1/asset/custody/transfer-history

https://api.binance.com

Query User Delegation History(For Master Account) › 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 Delegation History(For Master Account) › 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 Weight60

Query User Delegation History(For Master Account) › 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 Delegation History(For Master Account) › Query Parameters

email

string · required

Example: abc@test.com

startTime

integer · int64 · required

Example: 1623319461670

endTime

integer · int64 · required

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

type

string · enum

Enum values:

DELEGATE

UNDELEGATE

Example: Delegate

asset

string

Example: BTC

current

integer · int64 · min: 1

Example: 1

Default: 1

size

integer · int64 · max: 100

Example: 10

Default: 10

recvWindow

integer · int64 · max: 60000

Example: 5000

Query User Delegation History(For Master Account) › Responses

200

User Delegation History

total

integer · int64

Example: 3316

object[]

Query User Universal Transfer History

GET

/sapi/v1/asset/transfer

https://api.binance.com

Query User Universal Transfer History › 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 Universal Transfer History › 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 Universal Transfer History › 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 Universal Transfer History › Query Parameters

type

string · required

Example: null

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

startTime

integer · int64

Example: 1623319461670

endTime

integer · int64

Example: 1641782889000

current

integer · int64 · min: 1

Example: 1

Default: 1

size

integer · int64 · max: 100

Example: 10

Default: 10

fromSymbol

string · enum

Enum values:

ISOLATEDMARGIN_MARGIN

ISOLATEDMARGIN_ISOLATEDMARGIN

Example: ISOLATEDMARGIN_MARGIN

toSymbol

string · enum

Enum values:

MARGIN_ISOLATEDMARGIN

ISOLATEDMARGIN_ISOLATEDMARGIN

Example: MARGIN_ISOLATEDMARGIN

recvWindow

integer · int64 · max: 60000

Example: 5000

Query User Universal Transfer History › Responses

200

User Universal Transfer History

total

integer · int64

Example: 2

object[]

User Universal Transfer

User universal transfer

POST

/sapi/v1/asset/transfer

https://api.binance.com

User Universal Transfer › 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 Universal Transfer › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight900

User Universal Transfer › 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 Universal Transfer › Request Body

type

string · enum · required

Enum values:

MAIN_UMFUTURE

MAIN_CMFUTURE

MAIN_MARGIN

UMFUTURE_MAIN

UMFUTURE_MARGIN

CMFUTURE_MAIN

CMFUTURE_MARGIN

MARGIN_MAIN

Example: MAIN_UMFUTURE

asset

string · required

Example: BTC

amount

number · float · required

Example: 1.0

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

fromSymbol

string · enum

Enum values:

ISOLATEDMARGIN_MARGIN

ISOLATEDMARGIN_ISOLATEDMARGIN

Example: ISOLATEDMARGIN_MARGIN

toSymbol

string · enum

Enum values:

MARGIN_ISOLATEDMARGIN

ISOLATEDMARGIN_ISOLATEDMARGIN

Example: MARGIN_ISOLATEDMARGIN

recvWindow

integer · int64 · max: 60000

Example: 5000

User Universal Transfer › Responses

200

User Universal Transfer

tranId

integer · int64

Example: 13526853623

Query User Wallet Balance

GET

/sapi/v1/asset/wallet/balance

https://api.binance.com

Query User Wallet Balance › 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 Wallet Balance › 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 Weight60

Query User Wallet Balance › 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 Wallet Balance › 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

quoteAsset

string

Example: BTC

Default: BTC

recvWindow

integer · int64 · max: 60000

Example: 5000

Query User Wallet Balance › Responses

200

User Wallet Balance

object

activate

boolean

Example: true

balance

string

Example: 0

walletName

string

Example: Spot

Toggle BNB Burn On Spot Trade And Margin Interest

POST

/sapi/v1/bnbBurn

https://api.binance.com

Toggle BNB Burn On Spot Trade And Margin Interest › 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 Spot Trade And Margin Interest › 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 Spot Trade And Margin Interest › 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 Spot Trade And Margin Interest › Request Body

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

spotBNBBurn

string

Determines whether to use BNB to pay for trading fees on SPOT

Example: true

interestBNBBurn

string

Determines whether to use BNB to pay for margin loan's interest

Example: true

recvWindow

integer · int64 · max: 60000

Example: 5000

Toggle BNB Burn On Spot Trade And Margin Interest › Responses

200

Toggle BNB Burn On Spot Trade And Margin Interest

spotBNBBurn

boolean

Example: true

interestBNBBurn

boolean

Example: false

Trade Fee

Fetch trade fee

GET

/sapi/v1/asset/tradeFee

https://api.binance.com

Trade Fee › 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

Trade Fee › 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

Trade Fee › 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

Trade Fee › 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: ADABNB

recvWindow

integer · int64 · max: 60000

Example: 5000

Trade Fee › Responses

200

Trade Fee

object

symbol

string

Example: ADABNB

makerCommission

string

Example: 0.001

takerCommission

string

Example: 0.001

User Asset

Get user assets, just for positive data.

POST

/sapi/v3/asset/getUserAsset

https://api.binance.com

User Asset › 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 Asset › 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

User Asset › 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 Asset › Request Body

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

asset

string

If asset is blank, then query all positive assets user have.

Example: BTC

needBtcValuation

boolean

Whether need btc valuation or not.

Example: true

recvWindow

integer · int64 · max: 60000

Example: 5000

User Asset › Responses

200

User Asset

object

asset

string

Example: AVAX

free

string

Example: 1

locked

string

Example: 0

freeze

string

Example: 0

withdrawing

string

Example: 0

ipoable

string

Example: 0

btcValuation

string

Example: 0