Bridge tokens cross-chain via the CIP API. Get supported chains and tokens, request bridge quotes with fees and estimated time, and track bridge transaction status. Use when the user asks to bridge, transfer tokens between chains, or check cross-chain transfer status.
Bridge tokens between chains via the CIP API. Powered by LI.FI and other bridge aggregators.
Base URL: https://api.modular.name/partners
Auth: Include x-api-key: <CIP_API_KEY> header on every request.
curl -s "https://api.modular.name/partners/bridge/chains" \
-H "x-api-key: $CIP_API_KEY"
Returns all chains supported for bridging with their chain IDs and CAIP-2 identifiers.
curl -s "https://api.modular.name/partners/bridge/tokens?caip2Id=eip155:8453" \
-H "x-api-key: $CIP_API_KEY"
| Param | Type | Required | Description |
|---|---|---|---|
caip2Id | string | Yes | CAIP-2 chain identifier (e.g., eip155:1 for Ethereum, eip155:8453 for Base) |
Always get a quote before executing a bridge. Shows fees, estimated time, and output amount.
curl -s "https://api.modular.name/partners/bridge/quote?\
fromChain=eip155:8453&\
toChain=eip155:1&\
fromToken=ETH&\
toToken=ETH&\
fromAmount=0.1&\
fromAddress=0x742d35Cc6634C0532925a3b844Bc454e4438f44e" \
-H "x-api-key: $CIP_API_KEY"
| Param | Type | Required | Description |
|---|---|---|---|
fromChain | string | Yes | Source chain CAIP-2 ID |
toChain | string | Yes | Destination chain CAIP-2 ID |
fromToken | string | Yes | Token symbol on source chain |
toToken | string | Yes | Token symbol on destination chain |
fromAmount | string | Yes | Amount to bridge |
fromAddress | string | Yes | Sender wallet address |
toAddress | string | No | Recipient address (defaults to fromAddress) |
slippage | string | No | Slippage tolerance (default: provider default) |
The response includes:
curl -s "https://api.modular.name/partners/bridge/status?txHash=0xabc123" \
-H "x-api-key: $CIP_API_KEY"
| Param | Type | Required | Description |
|---|---|---|---|
txHash | string | Yes | Transaction hash from the bridge execution |
bridge | string | No | Bridge provider name (e.g., lifi) |
| Chain | CAIP-2 ID |
|---|---|
| Ethereum | eip155:1 |
| Base | eip155:8453 |
| Polygon | eip155:137 |
| Arbitrum | eip155:42161 |
| Optimism | eip155:10 |
| BSC | eip155:56 |
| Avalanche | eip155:43114 |
| Solana | solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp |
| Operation | Credits |
|---|---|
| List chains | 1 |
| List tokens | 1 |
| Get quote | 2 |
| Check status | 1 |
bridge/chains first if unsure)