bridge

Get Bridge Swap Quotes

Retrieves a comprehensive list of swap quotations from multiple bridges for a specified token pair pool. By aggregating swap quotes across various bridges, it enables users to compare rates and identify the most favorable trading option. The response includes detailed information such as the Bridge name and identifier, the input amount, the swap path, and the resulting output amounts from each bridge, making it a valuable tool for pricing data and swap execution decisions.

💡 Compute Unit Value: 85 (Fixed)

get/defi/v1/bridge/quotes

Request

Base URL
https://svc.blockdaemon.com
URL
https://svc.blockdaemon.com/defi/v1/bridge/quotes
Auth
API key in header X-API-Key

Query parameters

srcChainIdstring

The unique chain ID to specify the source chain. Find more here.

Example:1

dstChainIdstring required

The unique chain ID to specify the destination chain. Find more here.

Example:1

srcChainSymbolstring

Symbol of the source chain.

Example:ETH

srcTokenSymbolstring

Symbol of the token to swap.

Example:usdt

dstTokenSymbolstring

Symbol of the token to be received after the swap.

Example:ETH

srcTokenAddressstring

Contract address of the source (input) token on the source chain. For EVM chains, use a checksummed hex address (e.g., 0x...). Either srcTokenAddress or srcTokenSymbol must be provided.

Example:0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402

dstTokenAddressstring

Contract address of the destination (output) token on the destination chain. For EVM chains, use a checksummed hex address (e.g., 0x...). Either dstTokenAddress or dstTokenSymbol must be provided.

Example:0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402

amountInstring required

Amount of the input token to provide, specified in the token's smallest denomination (base units). Do not send human-readable decimal values. Examples: to swap 1 WETH (18 decimals), use "1000000000000000000"; to swap 1 USDC (6 decimals), use "1000000".

Example:1000000000000000000

excludedBridgesstring

Comma-separated list of bridge protocol IDs (bridgeId values) to exclude from routing. Find available IDs via the /support endpoint.

Example:200

vsCurrenciesstring

A comma-separated list of currency symbols to convert the amount into, such as 'USD,EUR'. This parameter is optional and allows retrieving values in multiple fiat currencies.

Example:usd,eur,gbp

maxPriceImpactstring

Maximum acceptable price impact as a percentage (e.g., '0.01' means 0.01% price impact). Quotes that would cause a price impact exceeding this value are excluded from results.

Example:0.01

Response

Successful response

statusnumber

Numeric status code indicating success or failure of the API call

msgstring

Human-readable message describing the API result or error

Example response

{
  "status": 200,
  "msg": "success",
  "data": [
    {
      "bridgeId": "600",
      "bridgeName": "SquidRouterV2",
      "srcChainId": "1",
      "dstChainId": "42161",
      "srcTokenSymbol": "USDT",
      "dstTokenSymbol": "USDT",
      "srcTokenAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "dstTokenAddress": "0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9",
      "amountIn": "100000000",
      "amountsOut": [
        "100000000",
        "99972981"
      ],
      "prices": {
        "usd": [
          {
            "chainId": "1",
            "0xdAC17F958D2ee523a2206206994597C13D831ec7": "0.9995147323301254"
          },
          {
            "chainId": "42161",
            "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9": "0.9995147323301254"
          }
        ]
      },
      "priceImpact": {
        "percentage": "0.0270",
        "value": "0.027019"
      }
    },
    {
      "bridgeId": "500",
      "bridgeName": "StargateV2",
      "srcChainId": "1",
      "dstChainId": "42161",
      "srcTokenSymbol": "USDT",
      "dstTokenSymbol": "USDT",
      "srcTokenAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "dstTokenAddress": "0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9",
      "amountIn": "100000000",
      "amountsOut": [
        "100000000",
        "99963199"
      ],
      "prices": {
        "usd": [
          {
            "chainId": "1",
            "0xdAC17F958D2ee523a2206206994597C13D831ec7": "0.9995147323301254"
          },
          {
            "chainId": "42161",
            "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9": "0.9995147323301254"
          }
        ]
      },
      "priceImpact": {
        "percentage": "0.0368",
        "value": "0.036801"
      }
    },
    {
      "bridgeId": "100",
      "bridgeName": "Stargate",
      "srcChainId": "1",
      "dstChainId": "42161",
      "srcTokenSymbol": "USDT",
      "dstTokenSymbol": "USDT",
      "srcTokenAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "dstTokenAddress": "0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9",
      "amountIn": "100000000",
      "amountsOut": [
        "100000000",
        "99950000"
      ],
      "prices": {
        "usd": [
          {
            "chainId": "1",
            "0xdAC17F958D2ee523a2206206994597C13D831ec7": "0.9995147323301254"
          },
          {
            "chainId": "42161",
            "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9": "0.9995147323301254"
          }
        ]
      },
      "priceImpact": {
        "percentage": "0.0500",
        "value": "0.050000"
      }
    },
    {
      "bridgeId": "400",
      "bridgeName": "AllbridgeCore",
      "srcChainId": "1",
      "dstChainId": "42161",
      "srcTokenSymbol": "USDT",
      "dstTokenSymbol": "USDT",
      "srcTokenAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "dstTokenAddress": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
      "amountIn": "100000000",
      "amountsOut": [
        "100000000",
        "99505517"
      ],
      "prices": {
        "usd": [
          {
            "chainId": "1",
            "0xdAC17F958D2ee523a2206206994597C13D831ec7": "0.9995147323301254"
          },
          {
            "chainId": "42161",
            "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9": "0.9995147323301254"
          }
        ]
      },
      "priceImpact": {
        "percentage": "0.4945",
        "value": "0.494483"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.