Skip to main content

Convert

Binance Connect provides a flexible and powerful Convert capability as part of the On-ramp (Buy) functionality, through which you can quickly convert one cryptocurrency to another with competitive rates!

The Convert capability is a branch of the On-ramp flow that allows users to exchange their existing cryptocurrency holdings directly without going through fiat currency. This is particularly useful for:

  • Converting between different cryptocurrencies
  • Portfolio rebalancing
  • Taking advantage of market opportunities

As a partner (client), the conversion process is seamless and uses the same On-ramp APIs with specific parameters. There are no separate Convert APIs - it utilizes the existing On-ramp infrastructure.

Key Differences for Convert Operations​

When using the On-ramp APIs for Convert operations, there are some key differences:

1. Fiat Fields​

For Convert operations, the following fields will be empty since no fiat currency is involved:

  • fiat - This field will be empty
  • fiatAmount - This field will be 0

2. Additional Response Fields​

The Get order detail API and webhook payload will include an additional object field when processing Convert orders:

For API responses:

{
  "convertInfo": {
    "fromCoin": "BTC",
    "fromCoinAmount": "0.01"
  }
}

For webhook payloads:

{
  "convertInfo": {
    "fromCoin": "BTC",
    "fromCoinAmount": "0.01"
  }
}

ConvertInfo Fields:​

  • fromCoin: The source cryptocurrency being converted from
  • fromCoinAmount: The amount of source cryptocurrency being converted

3. Order Status Flow​

Convert operations will use the following order statuses:

  • CONVERT_PROCESSING (3): In the process of converting crypto
  • CONVERT_COMPLETED (4): Successfully converted crypto. The converted crypto is in the user's Binance wallet, but the withdrawal has not been initiated yet

For detailed order status information, refer to Order Status.