v1

latestOpenAPI 3.1.02026-07-24223580832.9 KB

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

Query parameters

srcChainIdstring

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

Example:1

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

dstChainIdstring required

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

Example:1

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

srcChainSymbolstring

Symbol of the source chain.

Example:ETH

Symbol of the source chain.

srcTokenSymbolstring

Symbol of the token to swap.

Example:usdt

Symbol of the token to swap.

dstTokenSymbolstring

Symbol of the token to be received after the swap.

Example:ETH

Symbol of the token to be received after the swap.

srcTokenAddressstring

Address of the source token.

Example:0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402

Address of the source token.

dstTokenAddressstring

Address of the destination token.

Example:0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402

Address of the destination token.

amountInstring required

Amount of the token to be swapped.

Example:10000

Amount of the token to be swapped.

excludedBridgesstring

Comma-separated values of bridges to exclude.

Example:200

Comma-separated values of bridges to exclude.

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

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.

maxPriceImpactstring

The maximum price impact percentage to consider for the quote.

Example:0.01

The maximum price impact percentage to consider for the quote.

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"
      }
    }
  ]
}