bridge

Get Route

Retrieves an optimal bridging path between two blockchain networks, detailing the sequence of operations, tokens, intermediary addresses, swap paths, fees, gas estimates, and minimum tokens received. Also includes route duration and express processing options, allowing users to evaluate the feasibility, cost, and speed of cross-chain token transfers.

💡 Compute Unit Value: 65 (Fixed)

get/defi/v1/bridge/getroute

Request

Base URL
https://svc.blockdaemon.com
URL
https://svc.blockdaemon.com/defi/v1/bridge/getroute
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

bridgeId'600'

The unique ID to specify the bridge protocol for routing cross-chain queries or transactions. Find more here.

Example:600

dstChainIdstring required

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

Example:1

srcTokenSymbolstring

Symbol of the source token.

Example:usdt

dstTokenSymbolstring

Symbol of the destination token.

Example:ETH

srcTokenAddressstring

Address of the source token.

Example:0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402

dstTokenAddressstring

Address of the destination token.

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

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

Response

Successful response

statusinteger

msgstring

dataobject

Example response

{
  "status": 200,
  "msg": "success",
  "data": {
    "actions": [
      {
        "type": "swap",
        "chainType": "evm",
        "data": {
          "address": "0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7",
          "chainId": "1",
          "coinAddresses": [
            "0x6b175474e89094c44da98b954eedeac495271d0f",
            "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
            "0xdac17f958d2ee523a2206206994597c13d831ec7"
          ],
          "dex": "Curve V2",
          "enabled": true,
          "path": [
            "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
            "0xdac17f958d2ee523a2206206994597c13d831ec7"
          ],
          "slippage": 0.01,
          "aggregateSlippage": 0.01,
          "target": "0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7"
        },
        "fromChain": "1",
        "toChain": "1",
        "fromToken": {
          "id": "1_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
          "symbol": "USDC",
          "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
          "chainId": "1",
          "name": "USDC",
          "decimals": 6,
          "interchainTokenId": "0xaab70a74fae5d4d70134970cc0a7a03ff70bfffd5891f79d2f4daf1b5fade846",
          "coingeckoId": "usd-coin",
          "type": "evm",
          "logoURI": "https://raw.githubusercontent.com/axelarnetwork/axelar-configs/main/images/tokens/usdc.svg",
          "axelarNetworkSymbol": "USDC",
          "subGraphOnly": false,
          "subGraphIds": [
            "uusdc",
            "cctp-uusdc-ethereum-to-noble",
            "chainflip-bridge",
            "immutable-usdc",
            "immutable-USDC-USDC",
            "0xaab70a74fae5d4d70134970cc0a7a03ff70bfffd5891f79d2f4daf1b5fade846"
          ],
          "enabled": true,
          "active": true,
          "visible": true,
          "usdPrice": 0.99992
        },
        "toToken": {
          "id": "1_0xdac17f958d2ee523a2206206994597c13d831ec7",
          "symbol": "USDT",
          "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
          "chainId": "1",
          "name": "USDT",
          "decimals": 6,
          "interchainTokenId": "0xe492d9a67fbc2152a57ac8c08784f7d45cf13f4415a11cd0d787235c5f9219f7",
          "coingeckoId": "tether",
          "type": "evm",
          "logoURI": "https://raw.githubusercontent.com/axelarnetwork/axelar-configs/main/images/tokens/usdt.svg",
          "axelarNetworkSymbol": "USDT",
          "subGraphOnly": false,
          "subGraphIds": [
            "uusdt",
            "chainflip-bridge",
            "immutable-USDT-USDT",
            "0xe492d9a67fbc2152a57ac8c08784f7d45cf13f4415a11cd0d787235c5f9219f7"
          ],
          "enabled": true,
          "active": true,
          "visible": true,
          "usdPrice": 1.00041907265
        },
        "aggregatedVolatility": 0,
        "fromAmount": "1000",
        "toAmount": "999",
        "toAmountMin": "989",
        "exchangeRate": "0.999",
        "priceImpact": "-0.90909090909090895",
        "stage": 3,
        "provider": "Curve V2",
        "logoURI": "https://raw.githubusercontent.com/0xsquid/assets/main/images/providers/curve.svg",
        "description": "Swap USDC to USDT"
      }
    ],
    "fromAmount": "1000",
    "toAmount": "999",
    "toAmountMin": "989",
    "exchangeRate": "0.999",
    "aggregatePriceImpact": "-0.91",
    "fromAmountUSD": "0.00",
    "toAmountUSD": "0.00",
    "toAmountMinUSD": "0.00",
    "aggregateSlippage": 1,
    "fromToken": {
      "id": "1_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "symbol": "USDC",
      "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "chainId": "1",
      "name": "USDC",
      "decimals": 6,
      "interchainTokenId": "0xaab70a74fae5d4d70134970cc0a7a03ff70bfffd5891f79d2f4daf1b5fade846",
      "coingeckoId": "usd-coin",
      "type": "evm",
      "logoURI": "https://raw.githubusercontent.com/axelarnetwork/axelar-configs/main/images/tokens/usdc.svg",
      "volatility": 0,
      "axelarNetworkSymbol": "USDC",
      "subGraphOnly": false,
      "subGraphIds": [
        "uusdc",
        "cctp-uusdc-ethereum-to-noble",
        "chainflip-bridge",
        "immutable-usdc",
        "immutable-USDC-USDC",
        "0xaab70a74fae5d4d70134970cc0a7a03ff70bfffd5891f79d2f4daf1b5fade846"
      ],
      "enabled": true,
      "active": true,
      "visible": true,
      "usdPrice": 0.99992
    },
    "toToken": {
      "id": "1_0xdac17f958d2ee523a2206206994597c13d831ec7",
      "symbol": "USDT",
      "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "chainId": "1",
      "name": "USDT",
      "decimals": 6,
      "interchainTokenId": "0xe492d9a67fbc2152a57ac8c08784f7d45cf13f4415a11cd0d787235c5f9219f7",
      "coingeckoId": "tether",
      "type": "evm",
      "logoURI": "https://raw.githubusercontent.com/axelarnetwork/axelar-configs/main/images/tokens/usdt.svg",
      "volatility": 0,
      "axelarNetworkSymbol": "USDT",
      "subGraphOnly": false,
      "subGraphIds": [
        "uusdt",
        "chainflip-bridge",
        "immutable-USDT-USDT",
        "0xe492d9a67fbc2152a57ac8c08784f7d45cf13f4415a11cd0d787235c5f9219f7"
      ],
      "enabled": true,
      "active": true,
      "visible": true,
      "usdPrice": 1.00041907265
    },
    "isBoostSupported": false,
    "gasCosts": [
      {
        "type": "executeCall",
        "token": {
          "id": "1_0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
          "symbol": "ETH",
          "address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
          "chainId": "1",
          "name": "ETH",
          "decimals": 18,
          "coingeckoId": "ethereum",
          "type": "evm",
          "logoURI": "https://raw.githubusercontent.com/0xsquid/assets/main/images/tokens/eth.svg",
          "volatility": 2,
          "axelarNetworkSymbol": "ETH",
          "subGraphOnly": false,
          "subGraphIds": [
            "weth-wei",
            "chainflip-bridge",
            "immutable-eth"
          ],
          "enabled": true,
          "active": true,
          "visible": true,
          "usdPrice": 3635.20413155
        },
        "amount": "155407453632200",
        "gasLimit": "416900",
        "amountUsd": "0.56"
      }
    ],
    "feeCosts": [],
    "estimatedRouteDuration": 15
  }
}

Changes

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