LI.FI CLI

Note: This CLI provides read-only tools — it does not sign or broadcast transactions. Quote responses include unsigned transactionRequest objects that must be signed and submitted externally using your own wallet.

A TypeScript CLI that wraps the LI.FI REST API to give developers, integrators, and internal teams a scriptable, human-readable interface to cross-chain swap infrastructure.

Quickstart

git clone https://github.com/lifinance/lifi-cli.git
cd lifi-cli
npm install && npm run build
node dist/lifi.cjs chains

Once published to npm:

npm install -g @lifi/cli
lifi chains

No API key required — works immediately with public rate limits. Add a key for higher throughput.

Commands

Token Information

lifi tokens --chain 1                    # List tokens on Ethereum
lifi tokens --chain 1 --min-price 100    # Filter by min USD price
lifi token 1 USDC                        # Get specific token detail
lifi token 1 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48   # By address

Chain Information

lifi chains                    # List all supported chains
lifi chains --type EVM         # Filter by chain type
lifi chain 42161               # Get chain detail by ID
lifi chain arbitrum            # Get chain detail by name (case-insensitive)

Quote & Swap

# With flags
lifi quote \
  --from ethereum --to arbitrum \
  --from-token USDC --to-token USDC \
  --amount 1000000000 \
  --from-address 0xd8dA...

# Interactive mode (prompts for missing flags)
lifi quote

Routes

lifi routes \
  --from 1 --to 42161 \
  --from-token USDC --to-token USDC \
  --amount 1000000000 \
  --order CHEAPEST

Transaction Status

lifi status 0xabc123...                  # One-shot status check
lifi status 0xabc123... --watch          # Poll until complete/failed
lifi status 0xabc123... --bridge hop     # Speed up lookup with bridge hint

Connections

lifi connections                               # All connections
lifi connections --from-chain 1 --to-chain 42161  # Specific pair

Tools (Bridges & DEXes)

lifi tools                     # List all bridges and DEXes
lifi tools --chain 1           # Filter by chain

Gas

lifi gas                       # Gas prices for all chains
lifi gas 1                     # Detailed gas suggestion for Ethereum

API Key Management

lifi auth show                 # Display masked key
lifi auth test                 # Validate key against the API

Health Check

lifi health                    # Check API connectivity and latency

Output Modes

Mode	Trigger	Behaviour
Human	Default (TTY detected)	Coloured tables, formatted amounts
Machine	--json flag or non-TTY pipe	Raw JSON, stable schema, no colour

# Pipe-friendly — auto-detects non-TTY
lifi chains | jq '.chains[].name'

# Force JSON in terminal
lifi chains --json

# Disable colour
lifi chains --no-color

# Verbose errors with stack traces
lifi quote --from 1 --to 42161 --verbose

Configuration

All configuration is via environment variables. No config files needed.

# LI.FI API key (higher rate limits)
export LIFI_API_KEY=your_key_here

Without LIFI_API_KEY, the CLI uses public rate limits (200 req/2hr). With a key, you get 200 req/min.

Exit Codes

Code	Meaning
0	Success
1	General error
2	Invalid arguments / usage
3	Authentication error
4	API error (rate limit, server error)
5	Network error (unreachable)

Common Chain IDs

Chain	ID	Native Token
Ethereum	1	ETH
Polygon	137	MATIC
Arbitrum	42161	ETH
Optimism	10	ETH
BSC	56	BNB
Avalanche	43114	AVAX
Base	8453	ETH

Example Workflow: Cross-Chain Swap

# 1. Find chain IDs
lifi chains --type EVM

# 2. Look up token addresses
lifi token 1 USDC

# 3. Get best quote
lifi quote --from 1 --to 8453 --from-token USDC --to-token USDC --amount 1000000000 --from-address 0xYOUR_ADDRESS

# 4. (External) Approve tokens and sign transactionRequest with your wallet

# 5. Track progress
lifi status 0xTX_HASH --watch

Installation

npm (primary)

npm install -g @lifi/cli

npx (no install)

npx @lifi/cli chains

Development

git clone https://github.com/lifinance/lifi-cli.git
cd lifi-cli
npm install
npm run build
node dist/lifi.cjs --help

Scripts

Script	Description
npm run build	Build with tsup
npm run dev	Watch mode
npm test	Run tests (vitest)
npm run typecheck	Type check (tsc --noEmit)

License

MIT