Binance CrossChain Documentation

Learn how to use the Binance CrossChain swap service to seamlessly move assets between blockchains

Overview

Binance CrossChain is a service that enables users to swap tokens between different blockchain networks and the Binance Smart Chain (BSC). This documentation provides a comprehensive guide to understanding and using the CrossChain swap functionality.

Secure Swaps

All cross-chain transactions are secured by a network of validators and smart contracts that ensure assets are correctly transferred between chains.

Fast Processing

Most swaps complete within minutes, with the exact time depending on the source blockchain's confirmation time.

Multiple Chains

Support for Bitcoin, Ethereum, Monero, XRP, and various token standards across multiple networks.

How It Works

The Binance CrossChain service uses a lock-and-mint mechanism to facilitate cross-chain swaps. Here's how the process works:

Initiate Swap

Select the source chain, destination chain, and amount you want to swap. Provide your Binance (BSC) Chain address and rewards address.

Deposit Funds

Send the specified amount to the generated deposit address. Always double-check the address before sending funds.

Validation

The network of validators confirms your deposit on the source chain and initiates the minting process on BSC.

Receive Tokens

The equivalent tokens are sent to your BNB Chain address. You can track the process through the provided transaction hash.

1BTC is sent to a secure deposit address
2Validators confirm the transaction on the Bitcoin network
3Smart contract mints equivalent BTC-pegged tokens on BNB Chain
4Tokens are sent to your BNB Chain wallet address

Supported Networks

Binance CrossChain currently supports the following blockchain networks for swapping to BNB Chain:

Network	Assets	Confirmation Time	Min. Swap Amount
Bitcoin (BTC)	BTC	~5-20 minutes	0.0011 BTC
Solana (SOL)	SOL, TRUMP	~1-5 minutes	1 SOL
Ethereum (ETH)	ETH, ERC-20 tokens	~5-10 minutes	0.1 ETH
USDC	ETH, BASE, ARB	~1-5 minutes	100 USDC
Monero (XMR)	XMR	~15-30 minutes	0.5 XMR
XRP	XRP	~5 minutes	100 XRP

API Reference

Developers can integrate Binance CrossChain functionality into their applications using our API. Here are some example API calls:

Get Supported Chains

// Request
GET /api/v1/supported-chains

// Response
{
  "chains": [
    {
      "symbol": "BTC",
      "name": "Bitcoin",
      "coingeckoId": "bitcoin",
      "minAmount": "0.0005",
      "network": "bitcoin"
    },
    {
      "symbol": "ETH",
      "name": "Ethereum",
      "coingeckoId": "ethereum",
      "minAmount": "0.01",
      "network": "ethereum"
    },
    ...
  ]
}

Create Swap

// Request
POST /api/v1/create-swap
{
  "fromCurrency": "btc",
  "toCurrency": "bnb",
  "amount": "0.01",
  "addressTo": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "refundAddress": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"
}

// Response
{
  "id": "swap_123456789",
  "status": "pending",
  "depositAddress": "bc1q8c6fshw2dlwun94kd24r7c9j5zt6ewnz0aseam",
  "expectedAmount": "0.01",
  "estimatedTimeMinutes": 20
}

Check Swap Status

// Request
GET /api/v1/swap-status?id=swap_123456789

// Response
{
  "id": "swap_123456789",
  "status": "completed",
  "fromTxId": "8f1b54a..."
  "toTxId": "0xf54e...",
  "depositAmount": "0.01",
  "receivedAmount": "0.04328",
  "completedAt": "2025-03-24T14:38:22Z"
}

Frequently Asked Questions

How long does a swap take to complete?

Swap completion time varies depending on the source blockchain's confirmation times. BTC typically takes 15-30 minutes, SOL 1-5 minutes, ETH 5-10 minutes, and XRP about 5 minutes.

What happens if I send less than the minimum amount?

Transactions below the minimum amount may not be processed. In such cases, you should contact support to assist with recovering your funds, which may be subject to a processing fee.

Are there any fees for using Binance CrossChain?

Yes, Binance CrossChain charges a small processing fee for each swap. The fee varies by network and is automatically calculated and included in the final amount you receive.

What if I made a mistake with my destination address?

Unfortunately, blockchain transactions are irreversible. Double-check all addresses before initiating a swap. If you provided an incorrect BNB Chain address, the funds will be sent to that address and cannot be recovered.

Can I swap from BNB Chain to other networks?

Currently, Binance CrossChain only supports swaps from other networks to BNB Chain. Support for outbound swaps from BNB Chain to other networks is planned for future releases.