Skip to main content

Cross-Chain Bridging

The CoW Protocol SDK provides seamless cross-chain token transfers through integration with multiple bridge providers. This enables you to swap tokens across different blockchain networks in a single transaction.

Installation

Basic Usage

Initialize the BridgingSdk

Get a Cross-Chain Quote

Cross-chain orders are always SELL orders. BUY orders are not yet supported for cross-chain swaps.

Multi-Provider Quotes

Get Quotes from All Providers

The getMultiQuotes() method allows you to get quotes from multiple bridge providers simultaneously:

Progressive Quote Results

Receive quotes progressively as each provider responds:

Best Quote Selection

Use getBestQuote() to get only the best quote from all available providers:

Progressive Best Quote Updates

Use getBestQuote() when you only need the single best quote. Use getMultiQuotes() when you need to display all available options to users.

Provider Management

Get Available Providers

Filter Active Providers

Timeout Configuration

The multi-quote methods support two types of timeouts:
How timeouts work:
  • providerTimeout: Each provider has this amount of time to complete their quote request. If exceeded, that provider returns a timeout error.
  • totalTimeout: The total time to wait for all providers. After this time, any remaining providers are marked as timed out.
  • Providers that complete within their individual timeout but after the global timeout will still be included in the final results.

Comparison Table

Error Handling

Next Steps

Programmatic Orders

Learn about conditional and composable orders

Hooks

Execute custom logic before and after orders
Last modified on March 11, 2026