| name | lifi-orchestrator |
| description | Cross-chain bridging and swapping via LI.FI — the leading bridge aggregator that routes across 30+ bridges and DEXs for optimal rates. Use when you need to: (1) Get quotes for moving tokens between chains, (2) Execute cross-chain swaps with best pricing, (3) Track bridge transaction status, (4) Compare routes across protocols like Stargate, Across, Hop, Celer, etc. Supports Ethereum, Polygon, Arbitrum, Optimism, Base, BSC, Avalanche, Solana, and 15+ other chains. Handles native tokens and ERC-20s with automatic slippage protection. |
LI.FI Orchestrator
Bridge tokens across chains using LI.FI's aggregated bridge/DEX routing.
Quick Start
python3 scripts/quote.py --from-chain 1 --to-chain 137 \
--from-token ETH --to-token MATIC --amount 0.1
python3 scripts/bridge.py --from-chain 1 --to-chain 137 \
--from-token ETH --to-token USDC --amount 0.1
python3 scripts/status.py <txHash>
API Base
- Endpoint:
https://li.quest/v1
- Auth: Optional API key via
x-lifi-api-key header (higher rate limits)
- Rate limit: 10 req/min without key, higher with key
Common Chain IDs
| Chain | ID | Native Token |
|---|
| Ethereum | 1 | ETH |
| Polygon | 137 | MATIC |
| Arbitrum | 42161 | ETH |
| Optimism | 10 | ETH |
| Base | 8453 | ETH |
| BSC | 56 | BNB |
| Avalanche | 43114 | AVAX |
| Solana | 1151111081099710 | SOL |
Key Endpoints
Get Quote
curl "https://li.quest/v1/quote?fromChain=1&toChain=137&fromToken=ETH&toToken=USDC&fromAmount=1000000000000000000&fromAddress=<wallet>"
Get Chains
curl "https://li.quest/v1/chains"
Get Tokens
curl "https://li.quest/v1/tokens?chains=1,137"
Check Status
curl "https://li.quest/v1/status?txHash=<hash>"
Token Addresses
Use 0x0000000000000000000000000000000000000000 for native tokens (ETH, MATIC, etc.) or the actual contract address for ERC-20 tokens.
Common stablecoins:
- USDC (Ethereum):
0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
- USDC (Polygon):
0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359
- USDT (Ethereum):
0xdAC17F958D2ee523a2206206994597C13D831ec7
Workflow
- Get quote → Returns best route with gas estimates
- Check approval → For ERC-20 tokens, approve spending if needed
- Execute transaction → Sign and send the
transactionRequest from quote
- Track status → Poll
/status until complete
Scripts
scripts/quote.py — Get bridge quotes with human-readable outputscripts/bridge.py — Execute bridge transactions (requires wallet)scripts/status.py — Track transaction status
Notes
- LI.FI aggregates 30+ bridges and DEXs for best rates
- Slippage default: 0.5% (configurable)
- Some routes have minimum amounts
- Cross-chain transactions typically take 1-20 minutes
