# Lifi Orchestrator

> LI.FI Orchestrator

- Skill: `demerzels-lab/lifi-orchestrator` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add demerzels-lab/lifi-orchestrator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/demerzels-lab/lifi-orchestrator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Demerzels-lab (https://skillmd.com/u/demerzels-lab)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/demerzels-lab/lifi-orchestrator

---


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

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