get_bridge_quote
Obtain a bridge quote for transferring the same token between chains. Returns transaction data steps for direct signing or a deep link for manual fallback.
Instructions
Get a quote for bridging the SAME token from one chain to another (e.g. ETH on Ethereum → ETH on Base).
Use this for same-token cross-chain transfers. For different tokens (same or cross-chain), use get_swap_quote instead.
Returns execution steps — each step contains ready-to-sign transaction data (to, data, value, chainId, gas). An agent with wallet tooling can sign and submit these directly. Also returns a relay.link deep link as a fallback for manual execution.
Amounts must be in the token's smallest unit (wei, satoshis, lamports). Examples: 1 ETH = "1000000000000000000" (18 decimals), 1 USDC = "1000000" (6 decimals), 1 BTC = "100000000" (8 decimals), 1 SOL = "1000000000" (9 decimals). Use convert_amount or get_supported_tokens to look up decimals. Chain IDs can be numbers (8453) or names ('base', 'ethereum', 'arb', 'bitcoin', 'solana').
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | Yes | Amount to bridge in the token's smallest unit. Examples: "1000000000000000000" for 1 ETH (18 decimals), "100000000" for 1 BTC (8 decimals). | |
| sender | Yes | Sender wallet address. | |
| currency | Yes | Token address or symbol to bridge. Symbols like "ETH", "USDC", "USDT", "WETH" are resolved automatically. For native tokens use: EVM "0x0000000000000000000000000000000000000000", Solana "11111111111111111111111111111111", Bitcoin "bc1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqmql8k8", Hyperliquid "0x00000000000000000000000000000000", Lighter "0". For other tokens, use the contract/mint address or look up via get_supported_tokens. | |
| refundTo | No | Address to send refunds to if the bridge fails. Defaults to sender. Useful when sender is a deposit address or contract. | |
| recipient | No | Recipient wallet address. Defaults to sender if not provided. | |
| tradeType | No | EXACT_INPUT (default): you specify input amount, output varies. EXPECTED_OUTPUT: you specify desired output, input is calculated (allows slippage). EXACT_OUTPUT: you specify exact output required, fails if not deliverable. | EXACT_INPUT |
| includeSteps | No | Include raw transaction steps for signing. Only needed if you have wallet tooling to submit transactions directly. Omit to save tokens. | |
| originChainId | Yes | Source chain ID or name (e.g. 1, 'ethereum', 'eth'). | |
| useDepositAddress | No | Use deposit address flow — returns an address the user can send funds to (e.g. from a CEX or wallet) instead of transaction calldata. No wallet signing needed. The deposit address is reusable for the same origin→destination→currency route. Only supports EXACT_INPUT. Adds ~33k gas for native tokens, ~70k for ERC-20s. | |
| destinationChainId | Yes | Destination chain ID or name (e.g. 8453, 'base'). |