--- updatedAt: 2026-08-26T07:17:03.000Z agentTools: projectIndex: https://docs.blockdaemon.com/llms.txt --- # 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) # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "contact": { "name": "Blockdaemon", "email": "info@blockdaemon.com" }, "description": "The Blockdaemon DeFi API provides a single interface to a multitude of DeFi projects and blockchains", "title": "Blockdaemon DeFi API", "version": "1.0.0", "x-logo": { "altText": "Blockdaemon logo", "backgroundColor": "#fafafa", "url": "https://storage.googleapis.com/blockdaemon-app-static-images/marketing/PNG/dark-logo.png" } }, "externalDocs": { "description": "Blockdaemon DeFi documentation", "url": "http://www.blockdaemon.com/api/defi" }, "servers": [ { "url": "https://svc.blockdaemon.com" } ], "components": { "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-API-Key", "description": "`X-API-Key: ` header must be set to authenticate API requests.You can create tokens in the \"Configure\" tab of your API access area at https://app.blockdaemon.com." } } }, "tags": [ { "name": "bridge", "description": "API endpoints for operations related to bridges" } ], "security": [ { "ApiKeyAuth": [] } ], "paths": { "/defi/v1/bridge/getroute": { "get": { "tags": [ "bridge" ], "summary": "Get Route", "description": "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.\n\n> 💡 \n**Compute Unit Value:** `65` (Fixed)", "operationId": "bridgeGetroute", "parameters": [ { "name": "srcChainId", "in": "query", "required": false, "schema": { "type": "string", "description": "The unique chain ID to specify the source chain. Find more [here](https://docs.blockdaemon.com/docs/defi-api-supported-protocols#supported-chains).", "example": "1" }, "description": "The unique chain ID to specify the source chain. Find more [here](https://docs.blockdaemon.com/docs/defi-api-supported-protocols#supported-chains)." }, { "name": "bridgeId", "in": "query", "required": false, "schema": { "type": "string", "description": "The unique ID to specify the bridge protocol for routing cross-chain queries or transactions. Find more [here](https://docs.blockdaemon.com/docs/defi-api-supported-protocols#supported-bridges-protocols).", "enum": [ "600" ], "example": "600" }, "description": "The unique ID to specify the bridge protocol for routing cross-chain queries or transactions. Find more [here](https://docs.blockdaemon.com/docs/defi-api-supported-protocols#supported-bridges-protocols)." }, { "name": "dstChainId", "in": "query", "required": true, "schema": { "type": "string", "description": "The unique chain ID to specify the destination chain. Find more [here](https://docs.blockdaemon.com/docs/defi-api-supported-protocols#supported-chains).", "example": "1" }, "description": "The unique chain ID to specify the destination chain. Find more [here](https://docs.blockdaemon.com/docs/defi-api-supported-protocols#supported-chains)." }, { "name": "srcTokenSymbol", "in": "query", "required": false, "schema": { "type": "string", "description": "Symbol of the source token.", "example": "usdt" }, "description": "Symbol of the source token." }, { "name": "dstTokenSymbol", "in": "query", "required": false, "schema": { "type": "string", "description": "Symbol of the destination token.", "example": "ETH" }, "description": "Symbol of the destination token." }, { "name": "srcTokenAddress", "in": "query", "required": false, "schema": { "type": "string", "description": "Address of the source token.", "example": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402" }, "description": "Address of the source token." }, { "name": "dstTokenAddress", "in": "query", "required": false, "schema": { "type": "string", "description": "Address of the destination token.", "example": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402" }, "description": "Address of the destination token." }, { "name": "amountIn", "in": "query", "required": true, "schema": { "type": "string", "description": "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" }, "description": "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\"." }, { "name": "vsCurrencies", "in": "query", "required": false, "schema": { "type": "string", "description": "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" }, "description": "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." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer" }, "msg": { "type": "string" }, "data": { "type": "object" } }, "example": { "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 } } } } } } }, "x-bd-cu": "65", "x-bd-cu-type": "fixed", "x-internal": false } } }, "x-readme": { "explorer-enabled": true, "proxy-enabled": true } } ```