LI.FI Orchestrator
Bridge tokens across chains using LI.FI's aggregated bridge/DEX routing.
Quick Start
bash
# Get a quote (ETH on Ethereum → MATIC on Polygon) python3 scripts/quote.py --from-chain 1 --to-chain 137 \ --from-token ETH --to-token MATIC --amount 0.1 # Execute a bridge (requires private key) python3 scripts/bridge.py --from-chain 1 --to-chain 137 \ --from-token ETH --to-token USDC --amount 0.1 # Check transaction status python3 scripts/status.py <txHash>
API Base
- •Endpoint:
https://li.quest/v1 - •Auth: Optional API key via
x-lifi-api-keyheader (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
bash
curl "https://li.quest/v1/quote?fromChain=1&toChain=137&fromToken=ETH&toToken=USDC&fromAmount=1000000000000000000&fromAddress=<wallet>"
Get Chains
bash
curl "https://li.quest/v1/chains"
Get Tokens
bash
curl "https://li.quest/v1/tokens?chains=1,137"
Check Status
bash
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
transactionRequestfrom quote - •Track status → Poll
/statusuntil complete
Scripts
- •
scripts/quote.py— Get bridge quotes with human-readable output - •
scripts/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