$ man bridge-rates
/bridge-rates(1)
PRICE / CALL
$0.03
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
edgemarketCATEGORY
uncategorized
STATUS
● live
NAME
bridge-rates — cross-chain bridge rate aggregator
SYNOPSIS
POST https://x402.org/v1/bridge-rates
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Cross-chain bridge rate aggregator. LiFi public quote API aggregates Across, Stargate, Hop, deBridge, Synapse, CCTP. Free, commercial-OK with attribution.
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.org/v1/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 once claude mcp add x402 --command "npx x402-deployer-mcp" # then ask Claude Code: # "use the bridge-rates tool to ..."
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 | Snapshot.org DAO proposal monitor. | $0.03 |
| ens-resolve | ENS resolver / Ethereum Name Service lookup. | $0.03 |
| defi-llama-protocol | DefiLlama protocol lookup — TVL, chain breakdown, current TVL, 24h/7d/30d changes, audits, parent protocol, categories. | $0.02 |
| gas-now-base | Gas oracle / EIP-1559 fee estimator. | $0.02 |
| gas-price | Gas price API / EIP-1559 fee estimator / Base + Ethereum + Optimism + Arbitrum gas tracker / pre-tx cost estimator. | $0.02 |
| token-price | Crypto token price API / CoinGecko wrapper. | $0.02 |
| tx-receipt-decode | EVM transaction receipt decoder / log decoder / event log reader / Etherscan tx debug / receipt parser / Basescan tx explainer / tenderly… | $0.02 |
| tx-simulate-swap | Tx simulate swap / pre-trade quote / DEX swap simulator / 1inch + LlamaSwap quote / would-it-succeed check. | $0.02 |
SEE ALSO