Sign in
Quotes

Get best quote across all bridges

Retrieves the best quote (lowest total fee) from all supported bridge protocols

get/quotes/best

Query parameters

tokenInstring required
Example:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Input token address

tokenOutstring required
Example:0x06eFdBFf2a14a7c8E15944D1F4A48F9F95F663A4

Output token address

sourceChain'ARBITRUM_MAINNET' | 'ARBITRUM_TESTNET' | 'AVALANCHE_MAINNET' | 'AVALANCHE_TESTNET' | 'BASE_MAINNET' | 'BASE_TESTNET' | 'STARKNET_MAINNET' | 'STARKNET_TESTNET' | 'BSC_MAINNET' | 'ETHEREUM_MAINNET' | 'ETHEREUM_TESTNET' | 'OPTIMISM_MAINNET' | 'OPTIMISM_TESTNET' | 'MONAD_MAINNET' | 'MONAD_TESTNET' | 'POLYGON_MAINNET' | 'HYPEREVM_MAINNET' | 'LISK_MAINNET' | 'SOLANA_MAINNET' | 'SOLANA_TESTNET' | 'TRON_MAINNET' required

Source blockchain

destinationChain'ARBITRUM_MAINNET' | 'ARBITRUM_TESTNET' | 'AVALANCHE_MAINNET' | 'AVALANCHE_TESTNET' | 'BASE_MAINNET' | 'BASE_TESTNET' | 'STARKNET_MAINNET' | 'STARKNET_TESTNET' | 'BSC_MAINNET' | 'ETHEREUM_MAINNET' | 'ETHEREUM_TESTNET' | 'OPTIMISM_MAINNET' | 'OPTIMISM_TESTNET' | 'MONAD_MAINNET' | 'MONAD_TESTNET' | 'POLYGON_MAINNET' | 'HYPEREVM_MAINNET' | 'LISK_MAINNET' | 'SOLANA_MAINNET' | 'SOLANA_TESTNET' | 'TRON_MAINNET' required

Destination blockchain

amountstring required
Example:10000000

Amount in token units

excludeBridgesstring
Example:GATEWAY,CCTP

Comma-separated bridges to exclude

recipientstring
Example:0x742d35Cc6635C0532925a3b8D62A7fe7B58123D1

Optional recipient address

amountSymbol'USDC' | 'USDT' | 'DAI' | 'BUSD' | 'EURC' | 'ETH' | 'WETH' | 'STRK' | 'BNB' | 'LORDS' | 'USDS' | 'USDG' | 'USDT0' | 'WBTC' | 'LINK' | 'SOL' | 'EKUBO' | 'AAVE' | 'UNI' | 'CURVE' | 'cbBTC' | 'VIRTUAL' | 'stETH' | 'wstETH' | 'SKY' | 'AUSD' | 'WMON' | 'LVMON' | 'OP' | 'WLD' | 'ARB' | 'sAVAX' | 'WAVAX' | 'anyBTC' | 'WBNB' | 'TRON' | 'AVAX' | 'POL' | 'MON'

Token symbol for amount denomination (defaults to USDC). Use this to specify amounts in other tokens like WETH, ETH, etc.

Response

Best quote retrieved successfully

bridgeFeeDetailsobject

Bridge-specific fee details from the cheapest option

totalFeestring

Lowest total fee among all bridges

totalFeeFormattedstring

Human-readable formatted total fee

Example response

{
  "bridgeFeeDetails": {
    "maxFee": "8000"
  },
  "totalFee": "18000",
  "totalFeeFormatted": "0.018",
  "route": {
    "tokenIn": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "tokenOut": "0x06eFdBFf2a14a7c8E15944D1F4A48F9F95F663A4",
    "sourceChain": "BASE_TESTNET",
    "destinationChain": "ARBITRUM_TESTNET",
    "amount": "10000000",
    "bridge": "CCTP"
  }
}

Changes

Changed in 4 of the 9 revisions of this API.56

  • 76a4e00b118d35See the full diff
    • ○

      added the new enum value AAVE to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value ARB to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value AUSD to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value AVAX to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value CURVE to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value EKUBO to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value LINK to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value LVMON to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value MON to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value OP to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value POL to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value SKY to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value SOL to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value SOLANA_MAINNET to the query request parameter destinationChain

      request-parameter-enum-value-added

    • ○

      added the new enum value SOLANA_MAINNET to the query request parameter sourceChain

      request-parameter-enum-value-added

    • ○

      added the new enum value SOLANA_TESTNET to the query request parameter destinationChain

      request-parameter-enum-value-added

    • ○

      added the new enum value SOLANA_TESTNET to the query request parameter sourceChain

      request-parameter-enum-value-added

    • ○

      added the new enum value TRON to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value TRON_MAINNET to the query request parameter destinationChain

      request-parameter-enum-value-added

    • ○

      added the new enum value TRON_MAINNET to the query request parameter sourceChain

      request-parameter-enum-value-added

    • ○

      added the new enum value UNI to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value USDG to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value USDS to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value USDT0 to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value VIRTUAL to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value WAVAX to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value WBNB to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value WBTC to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value WLD to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value WMON to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value anyBTC to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value cbBTC to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value sAVAX to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value stETH to the query request parameter amountSymbol

      request-parameter-enum-value-added

    • ○

      added the new enum value wstETH to the query request parameter amountSymbol

      request-parameter-enum-value-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 2168c5f4fdd515See the full diff
    • ○

      added the new optional query request parameter amountSymbol

      new-optional-request-parameter

    • ○

      added the new enum value HYPEREVM_MAINNET to the query request parameter destinationChain

      request-parameter-enum-value-added

    • ○

      added the new enum value HYPEREVM_MAINNET to the query request parameter sourceChain

      request-parameter-enum-value-added

    • ○

      added the new enum value LISK_MAINNET to the query request parameter destinationChain

      request-parameter-enum-value-added

    • ○

      added the new enum value LISK_MAINNET to the query request parameter sourceChain

      request-parameter-enum-value-added

    • ○

      added the new enum value MONAD_MAINNET to the query request parameter destinationChain

      request-parameter-enum-value-added

    • ○

      added the new enum value MONAD_MAINNET to the query request parameter sourceChain

      request-parameter-enum-value-added

    • ○

      added the new enum value MONAD_TESTNET to the query request parameter destinationChain

      request-parameter-enum-value-added

    • ○

      added the new enum value MONAD_TESTNET to the query request parameter sourceChain

      request-parameter-enum-value-added

    • ○

      added the new enum value OPTIMISM_MAINNET to the query request parameter destinationChain

      request-parameter-enum-value-added

    • ○

      added the new enum value OPTIMISM_MAINNET to the query request parameter sourceChain

      request-parameter-enum-value-added

    • ○

      added the new enum value OPTIMISM_TESTNET to the query request parameter destinationChain

      request-parameter-enum-value-added

    • ○

      added the new enum value OPTIMISM_TESTNET to the query request parameter sourceChain

      request-parameter-enum-value-added

    • ○

      added the new enum value POLYGON_MAINNET to the query request parameter destinationChain

      request-parameter-enum-value-added

    • ○

      added the new enum value POLYGON_MAINNET to the query request parameter sourceChain

      request-parameter-enum-value-added

  • 0172b83f90c75See the full diff
    • ○

      added the media type application/json for the response with the status 200

      response-media-type-added

    • ○

      added the non-success response with the status 400

      response-non-success-status-added

    • ○

      added the non-success response with the status 401

      response-non-success-status-added

    • ○

      added the non-success response with the status 404

      response-non-success-status-added

    • ○

      added the non-success response with the status 500

      response-non-success-status-added

  • fce39ccb3e9d1See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 8 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog