Integrate Cross-chain Swap

Cross-chain swap exchanges tokens on one chain for tokens on another, or transfers assets across chains. When fromChain != toChain, you are in a cross-chain scenario. The process is split into steps; Bitget Wallet handles the full order lifecycle, and integrators submit signed transactions via API without maintaining order state.

Set {API_HOST} to the production base URL in Authentication. Prepend it to the paths below when sending requests.

Integration Flow

1. Get Quote — Call /bgw-pro/swapx/order/getSwapPrice for estimated output and fees
2. Create Order — Call /bgw-pro/swapx/order/makeSwapOrder to create an order and receive transaction data
3. Sign Transaction — Completed on the integrator side (e.g., self-hosted wallet / custodial signing)
4. Submit Order — Call /bgw-pro/swapx/order/submitSwapOrder with the signed transaction
5. Monitor Status — Poll /bgw-pro/swapx/order/getSwapOrder to track completion
6. Check reconciled fees (optional) — Call /bgw-pro/swapx/order/checkOrdersFee to batch-query reconciled fees

Characteristics

• Bitget Wallet handles the complete order lifecycle
• Integrators do not need to maintain order state
• Supported capabilities: Cross-chain swap, NoGas

API Reference

• Order Mode

Related Docs

• Order Mode API
• Integrate Same-chain Swap