agentutility(7)$ man bridge-rates
/bridge-rates
PRICE / CALL
$0.03
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
edgemarketCATEGORY
uncategorized
STATUS
● live
NAME
bridge-rates — compares cross-chain bridge quotes to find the cheapest route between chains, powered by lifi
SYNOPSIS
POST https://x402.agentutility.ai/bridge-rates
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Compares cross-chain bridge quotes to find the cheapest route between chains, powered by LiFi. Aggregates Across, Stargate, Hop, deBridge, Synapse, and Circle CCTP via LiFi's public quote API: pass source chain, dest chain, source token, dest token, and amount, and get ranked routes with bridge tool, est_amount_out, gas + fee in USD, est_duration_seconds, and per-step transaction objects ready to sign. Covers Ethereum to Base, Arbitrum, Optimism, and Polygon with USDC and ETH quotes, plus pre-bridge cost, slippage, and ETA estimates. Commercial-OK with LiFi attribution. Use it as a bridge rate aggregator, bridge quote API, or cheapest L1-to-L2 route finder.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| from_chain | number | Source chain id. EVM chain id (1=Ethereum, 8453=Base, 42161=Arbitrum One, 10=Optimism, 137=Polygon, 56=BNB Chain). | required |
| to_chain | number | Destination chain id (same id space as from_chain). | required |
| from_token | string | Source token contract address. Use '0x0000000000000000000000000000000000000000' for the chain's native gas token (ETH, MATIC, BNB). | required |
| to_token | string | Destination token contract address. Same '0x000...' convention for native. | required |
| amount | string | Source amount in the token's smallest unit (e.g. wei for ETH, '1000000000000000000' = 1 ETH; '1000000' = 1 USDC at 6 decimals). | required |
| from_address | string | Optional EVM address of the sender. Required for slippage-checked + ready-to-sign quotes. | optional |
| to_address | string | Optional EVM destination address. Defaults to from_address. | optional |
| slippage | number | Max slippage as decimal fraction (0.01 = 1%). Default 0.005. | optional |
| limit | number | Max routes to return. 1-10. Default 5. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| route_count | string | Number of bridge routes returned across aggregated providers (Across, Stargate, Hop, deBridge, Synapse, CCTP). |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/bridge-rates \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster npx -y @agentutility/mcp-<cluster> # Required: EVM private key with USDC on Base export X402_PRIVATE_KEY=0x... # Then call the bridge-rates tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- edge-marketbridge-ratescross-chainbridge-aggregatorlifistargatecctpbridge-quote
- methods
- POST
- cluster
- edgemarket
- price
- $0.03 USDC per call
ADJACENT — other endpoints in edgemarket
| endpoint | description | price |
|---|---|---|
| dao-proposal-monitor | Monitors DAO governance proposals on Snapshot.org for any space. | $0.03 |
| ens-resolve | Resolves ENS names in both directions: forward (vitalik.eth to address) and reverse (address to primary ENS). | $0.03 |
| defi-llama | DefiLlama API / DeFi TVL protocol lookup. | $0.02 |
| defi-llama-api | Looks up DeFi protocol fundamentals from DefiLlama, resolving protocol TVL, category, chains, token symbol, and protocol metadata. | $0.02 |
| defi-llama-protocol | Looks up any DeFi protocol's TVL and metadata from DefiLlama. | $0.02 |
| defi-tvl | DeFi TVL API / total value locked by protocol. | $0.02 |
| defillama | DefiLlama protocol TVL lookup / DeFi protocol metadata. | $0.02 |
| gas-api | Estimates blockchain gas fees with EIP-1559 tiers for Base, Ethereum, Optimism, and Arbitrum. | $0.02 |
SEE ALSO