Convert dust coins to BNB

POST

/ver1/accounts/:account_id/convert_dust_to_bnb

Permission: ACCOUNTS_WRITE

Security: SIGNED

Conversion of any other currency into the specific BNB currency.

This endpoint is applicable to the Binance Spot exchange.

---

Path Parameter

account_idintegerrequired

Unique 3Commas ID of this exchange account entity.

Body Parameter

codesarray[string]

Array of currency codes.

Example Request

POST

/ver1/accounts/12345678/convert_dust_to_bnb

{
  "codes": ["USDT"]
}

Response Parameters

totalTransferedstring

The total amount successfully converted to BNB.

totalServiceChargestring

The total service fee deducted during the conversion.

transferResultarray

A list of details for each asset conversion.

Hide child parametersShow child parameters

tranIdinteger

The transaction ID of the dust-to-BNB conversion.

fromAssetstring

The currency code of the converted asset.

amountstring

The initial amount of the asset before conversion.

transferedAmountstring

The amount of the asset successfully converted to BNB.

serviceChargeAmountstring

The service fee deducted for converting the asset to BNB.

operateTimeinteger

The timestamp of the conversion operation in milliseconds since epoch.

Example Responses

201 Created

{
  "totalTransfered": "0.00076178",
  "totalServiceCharge": "0.00001523",
  "transferResult": [
    {
      "tranId": 243385046044,
      "fromAsset": "USDT",
      "amount": "0.51389388",
      "transferedAmount": "0.00076178",
      "serviceChargeAmount": "0.00001523",
      "operateTime": 1739799333228
    }
  ]
}

400 Bad Request

{
  "error": "record_invalid",
  "error_description": "Invalid parameters",
  "error_attributes": {
    "codes": [
      "is invalid"
    ]
  }
}

403 Forbidden

{
  "error": "Forbidden. Unavailable for this account type."
}

422 Unprocessable Entity

{
  "error_description": "Small balances can be converted only once every 6h",
  "error": "bnb_dust_limit_error"
}