--- updatedAt: 2026-05-14T11:27:34.000Z --- Fetch the complete documentation index at: https://docs.blockdaemon.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version. # Aggregate Bridge Swap Aggregates swap quotes from all bridges supporting a specified token pair. It allows users to customize their query to prioritize either the best output or the lowest gas costs. The response provides detailed transaction data including bridge identifiers, output amounts, swap routing parameters (such as call data), gas estimates, and a reference, enabling traders to compare and select the most efficient swap route for their needs. > 💡 **Compute Unit Value:** `95` (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." } }, "schemas": { "_bridge_swapaggregator_Request": { "type": "object", "properties": { "srcChainId": { "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" }, "dstChainId": { "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" }, "srcChainSymbol": { "type": "string", "description": "Symbol of the source chain.", "example": "ETH" }, "srcTokenSymbol": { "type": "string", "description": "Symbol of the token to swap.", "example": "usdt" }, "dstTokenSymbol": { "type": "string", "description": "Symbol of the token to be received after the swap.", "example": "ETH" }, "amountIn": { "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" }, "srcTokenAddress": { "type": "string", "description": "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" }, "dstTokenAddress": { "type": "string", "description": "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" }, "from": { "type": "string", "description": "Blockchain address of the token sender. For EVM chains, use a checksummed hex address (e.g., 0xABCDEF...). This address must hold sufficient balance of the input token and will sign the transaction.", "example": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402" }, "gas": { "type": "string", "description": "Maximum number of gas units to allocate for the transaction, as an integer string (e.g., '200000'). If omitted, gas is estimated automatically. Note: this is gas units, not wei or gwei.", "example": "100000" }, "to": { "type": "string", "description": "Blockchain address of the token recipient. For EVM chains, use a checksummed hex address (e.g., 0xABCDEF...). Output tokens are delivered to this address after the swap.", "example": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402" }, "excludedBridges": { "type": "string", "description": "Comma-separated list of bridge protocol IDs (bridgeId values) to exclude from routing. Find available IDs via the /support endpoint.", "example": "200" }, "bestNetPrice": { "type": "boolean", "description": "If true, sorts prepared transactions by net value (amountsOut minus gas) in descending order. If multiple sort parameters are true, bestNetPrice takes precedence.", "example": false }, "bestQuote": { "type": "boolean", "description": "If true, sorts prepared transactions by amountsOut in descending order. If multiple sort parameters are true, bestNetPrice takes precedence.", "example": false }, "lowestGas": { "type": "boolean", "description": "If true, sorts prepared transactions by gas cost in ascending order. If multiple sort parameters are true, bestNetPrice takes precedence.", "example": false }, "gasPriority": { "type": "string", "description": "Specifies the priority level for gas fees (e.g., 'low', 'medium', or 'high'), which influences the transaction speed and cost.", "example": "low" }, "enableFee": { "type": "boolean", "description": "Flag to include a basis points fee transaction alongside the main transaction when set to true.", "example": false }, "batchOption": { "type": "string", "description": "Transaction batching standard to use. Supported values: 'EIP-5792' (wallet-level batching via wallet_sendCalls) or 'EIP-7702' (EOA code delegation via batcherContract). Requires batcherContract when using EIP-7702.", "enum": [ "EIP-5792", "EIP-7702" ], "example": "EIP-5792" }, "batcherContract": { "type": "string", "description": "The EOA address of the batcher that will be used to execute the transaction when using EIP-7702 batching. If not provided, the default batcher contract for the chain will be used.", "example": "0x9c933f9d2efd76ce25b0d3dde84d3f94e78a50ca" }, "simulate": { "type": "boolean", "description": "When true, dry-runs the transaction batch via eth_simulateV1 and returns a simulate field with status and error on each transaction.", "example": false } }, "required": [ "dstChainId", "amountIn", "from", "to" ], "description": "The request body for a /defi/v1/bridge/swaps", "example": { "srcChainId": "1", "dstChainId": "1", "srcChainSymbol": "ETH", "srcTokenSymbol": "usdt", "dstTokenSymbol": "ETH", "amountIn": "1000000000000000000", "srcTokenAddress": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402", "dstTokenAddress": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402", "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402", "gas": "100000", "to": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402", "excludedBridges": "200", "bestNetPrice": false, "bestQuote": false, "lowestGas": false, "gasPriority": "low", "enableFee": false, "batchOption": "EIP-5792", "batcherContract": "0x9c933f9d2efd76ce25b0d3dde84d3f94e78a50ca", "simulate": false } } } }, "tags": [ { "name": "bridge", "description": "API endpoints for operations related to bridges" } ], "security": [ { "ApiKeyAuth": [] } ], "paths": { "/defi/v1/bridge/swaps": { "post": { "tags": [ "bridge" ], "summary": "Aggregate Bridge Swap", "description": "Aggregates swap quotes from all bridges supporting a specified token pair. It allows users to customize their query to prioritize either the best output or the lowest gas costs. The response provides detailed transaction data including bridge identifiers, output amounts, swap routing parameters (such as call data), gas estimates, and a reference, enabling traders to compare and select the most efficient swap route for their needs.\n\n> 💡 \n**Compute Unit Value:** `95` (Fixed)", "operationId": "bridgeSwaps", "requestBody": { "required": true, "description": "The request body for a /defi/v1/bridge/swaps", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/_bridge_swapaggregator_Request" }, "example": { "srcChainId": "1", "dstChainId": "1", "srcChainSymbol": "ETH", "srcTokenSymbol": "usdt", "dstTokenSymbol": "ETH", "amountIn": "1000000000000000000", "srcTokenAddress": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402", "dstTokenAddress": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402", "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402", "gas": "100000", "to": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402", "excludedBridges": "200", "bestNetPrice": false, "bestQuote": false, "lowestGas": false, "gasPriority": "low", "enableFee": false, "batchOption": "EIP-5792", "batcherContract": "0x9c933f9d2efd76ce25b0d3dde84d3f94e78a50ca", "simulate": false } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "number", "description": "Numeric status code indicating success or failure of the API call", "example": 200 }, "msg": { "type": "string", "description": "Human-readable message describing the API result or error" }, "data": { "anyOf": [ { "type": "array", "items": { "type": "object", "properties": { "bridgeId": { "type": "string", "description": "Unique identifier for a bridge service", "example": "100" }, "bridgeName": { "type": "string", "description": "Human-readable bridge service name" }, "chainId": { "type": "string", "description": "Blockchain network identifier (EVM chain ID, Solana chain name, etc.)", "example": "1" }, "from": { "type": "string", "description": "Sender's wallet address", "example": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402" }, "to": { "type": "string", "description": "Recipient's wallet address", "example": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402" }, "value": { "type": "string", "description": "Amount being transferred or involved in a transaction", "example": "10" }, "gas": { "type": "string", "description": "Gas limit for the transaction", "example": "100000" }, "data": { "type": "string", "description": "Main payload object or array returned by the API", "example": "0x40e53eb7000000000000000000000000000000000000000000000000000000000016e360" }, "gasPrice": { "type": "string", "description": "Price per gas unit for the transaction", "example": "10000" }, "amountsOut": { "type": "string", "description": "Expected output amounts from swaps or conversions" }, "estimationCheck": { "oneOf": [ { "type": "string" }, { "type": "boolean" } ], "description": "Flag or value indicating transaction fee/estimate status" }, "referenceId": { "type": "string", "description": "Unique ID for tracking a specific transaction or operation", "example": "8eec8150896e4fdaa26d4d1a1338d676" }, "simulate": { "type": "object", "description": "Present when the request used `simulate: true`; eth_simulateV1 summary (omitted when simulation was not run).", "properties": { "status": { "type": "string", "enum": [ "success", "failure" ] }, "error": { "type": "string", "nullable": true, "description": "Failure reason when status is failure; null when status is success" } }, "required": [ "status", "error" ] } }, "required": [ "bridgeId", "bridgeName", "chainId", "from", "to", "value", "data", "amountsOut", "estimationCheck", "referenceId" ] } }, { "type": "object", "properties": { "createFeeTxn": { "type": "object", "properties": { "chainId": { "type": "string", "description": "Blockchain network identifier (EVM chain ID, Solana chain name, etc.)", "example": "1" }, "from": { "type": "string", "description": "Sender's wallet address", "example": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402" }, "to": { "type": "string", "description": "Recipient's wallet address", "example": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402" }, "value": { "type": "string", "description": "Amount being transferred or involved in a transaction", "example": "10" }, "gasPrice": { "type": "string", "description": "Price per gas unit for the transaction", "example": "10000" }, "gas": { "type": "string", "description": "Gas limit for the transaction", "example": "100000" }, "simulate": { "type": "object", "description": "Present when the request used `simulate: true` with `enableFee: true`; fee leg eth_simulateV1 summary.", "properties": { "status": { "type": "string", "enum": [ "success", "failure" ] }, "error": { "type": "string", "nullable": true, "description": "Failure reason when status is failure; null when status is success" } }, "required": [ "status", "error" ] } }, "required": [ "chainId", "from", "to", "value" ] }, "swapaggregatorTxn": { "type": "array", "items": { "type": "object", "properties": { "bridgeId": { "type": "string", "description": "Unique identifier for a bridge service", "example": "100" }, "bridgeName": { "type": "string", "description": "Human-readable bridge service name" }, "chainId": { "type": "string", "description": "Blockchain network identifier (EVM chain ID, Solana chain name, etc.)", "example": "1" }, "from": { "type": "string", "description": "Sender's wallet address", "example": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402" }, "to": { "type": "string", "description": "Recipient's wallet address", "example": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402" }, "value": { "type": "string", "description": "Amount being transferred or involved in a transaction", "example": "10" }, "gas": { "type": "string", "description": "Gas limit for the transaction", "example": "100000" }, "data": { "type": "string", "description": "Main payload object or array returned by the API", "example": "0x40e53eb7000000000000000000000000000000000000000000000000000000000016e360" }, "gasPrice": { "type": "string", "description": "Price per gas unit for the transaction", "example": "10000" }, "amountsOut": { "type": "string", "description": "Expected output amounts from swaps or conversions" }, "estimationCheck": { "oneOf": [ { "type": "string" }, { "type": "boolean" } ], "description": "Flag or value indicating transaction fee/estimate status" }, "referenceId": { "type": "string", "description": "Unique ID for tracking a specific transaction or operation", "example": "8eec8150896e4fdaa26d4d1a1338d676" }, "simulate": { "type": "object", "description": "Present when the request used `simulate: true`; eth_simulateV1 summary (omitted when simulation was not run).", "properties": { "status": { "type": "string", "enum": [ "success", "failure" ] }, "error": { "type": "string", "nullable": true, "description": "Failure reason when status is failure; null when status is success" } }, "required": [ "status", "error" ] } }, "required": [ "bridgeId", "bridgeName", "chainId", "from", "to", "value", "gas", "data", "amountsOut", "estimationCheck", "referenceId" ] } } }, "required": [ "createFeeTxn", "swapaggregatorTxn" ] }, { "type": "array", "items": { "type": "object", "properties": { "from": { "type": "string" }, "bridgeName": { "type": "string" }, "chainId": { "type": "string" }, "amountsOut": { "type": "string" }, "referenceId": { "type": "string" }, "methodUsed": { "type": "string", "enum": [ "EIP-5792", "EIP-7702" ] }, "calls": { "type": "array", "items": { "type": "object", "properties": { "to": { "type": "string" }, "value": { "type": "string" }, "data": { "type": "string" } }, "required": [ "to", "value", "data" ] } } }, "required": [ "from", "bridgeName", "chainId", "amountsOut", "referenceId", "methodUsed", "calls" ] } }, { "title": "Generated schema for EIP-7702", "type": "array", "items": { "type": "object", "properties": { "from": { "type": "string" }, "bridgeName": { "type": "string" }, "chainId": { "type": "string" }, "amountsOut": { "type": "string" }, "referenceId": { "type": "string" }, "methodUsed": { "type": "string" }, "to": { "type": "string" }, "data": { "type": "string" }, "value": { "type": "string" }, "batcherContract": { "type": "string" } }, "required": [ "from", "bridgeName", "chainId", "amountsOut", "referenceId", "methodUsed", "to", "data", "value", "batcherContract" ] } } ] } }, "example": { "status": 200, "msg": "success", "data": [ { "bridgeId": "500", "bridgeName": "StargateV2", "chainId": "1", "from": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994", "to": "0xc026395860Db2d07ee33e05fE50ed7bD583189C7", "value": "9696507066771", "gas": "920000", "data": "0xc7c7f5b30000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000008d1a4dbf9930000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a67e9b68c41b0f26184d64c26e0b2b81466e599400000000000000000000000000000000000000000000000000000000000075e8000000000000000000000000a67e9b68c41b0f26184d64c26e0b2b81466e59940000000000000000000000000000000000000000000000000000000000989680000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000e0000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010100000000000000000000000000000000000000000000000000000000000000", "amountsOut": "9999499", "estimationCheck": "Returned error: failed with 35894639 gas: insufficient funds for gas * price + value: address 0xa67E9B68c41b0f26184D64C26e0b2B81466E5994 have 0 want 9696507066771", "referenceId": "8a401db3386b4b389c655d4fe8b4589b" }, { "bridgeId": "600", "bridgeName": "SquidRouterV2", "chainId": "1", "from": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994", "to": "0xdf4ffda22270c12d0b5b3788f1669d709476111e", "value": "0", "gas": "920000", "data": "0x0d77797c000000000000000000000000a67e9b68c41b0f26184d64c26e0b2b81466e5994000000000000000000000000a67e9b68c41b0f26184d64c26e0b2b81466e5994000000000000000000000000ade3867e7e2dace6fa60f21db2cc89f8fb624452000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48000000000000000000000000833589fcd6edb6e08f4c7c32d4f71b54bda0291300000000000000000000000000000000000000000000000000000000681c9c160000000000000000000000000000000000000000000000000000000000989680000000000000000000000000000000000000000000000000000000000098778900000000000000000000000000000000000000000000000000000000000002bd000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000021050000000000000000000000000000000000000000000000000000000000000000", "amountsOut": "9992073", "estimationCheck": "Returned error: execution reverted: ERC20: transfer amount exceeds allowance", "referenceId": "8a401db3386b4b389c655d4fe8b4589b" }, { "bridgeId": "400", "bridgeName": "AllbridgeCore", "chainId": "1", "gas": "920000", "from": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994", "to": "0xC51397b75B783E31469bFaADE79913F3f82210d6", "value": "107462908551964", "data": "0x7dfb08f10000000000000000000000000000000000000000000000000000000000989680000000000000000000000000a67e9b68c41b0f26184d64c26e0b2b81466e599400000000000000000000000000000000000000000000000000000000000000090000000000000000000000000000000000000000000000000000000000000000", "amountsOut": "9990000", "estimationCheck": "Returned error: failed with 35894639 gas: insufficient funds for gas * price + value: address 0xa67E9B68c41b0f26184D64C26e0b2B81466E5994 have 0 want 107462908551964", "referenceId": "8a401db3386b4b389c655d4fe8b4589b" } ] } } } } } }, "x-bd-cu": "95", "x-bd-cu-type": "fixed", "x-internal": false } } }, "x-readme": { "explorer-enabled": true, "proxy-enabled": true } } ```