lifi-orchestrator

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

# 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-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

1. Get quote → Returns best route with gas estimates
2. Check approval → For ERC-20 tokens, approve spending if needed
3. Execute transaction → Sign and send the transactionRequest from quote
4. Track status → Poll /status until 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