Skip to main content
The LI.FI CLI wraps the LI.FI REST API to give developers, integrators, and internal teams a scriptable, human-readable interface to cross-chain swap infrastructure.
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.

ā€‹
Quickstart

Install globally via npm:
Or run without installing:
No API key required ā€” works immediately with public rate limits. Add a key for higher throughput.

ā€‹
How It Works

The CLI wraps the LI.FI REST API into structured commands that output human-readable tables (TTY) or machine-readable JSON (pipes / --json flag).

ā€‹
Example Workflow

A typical cross-chain swap via the CLI follows this flow:

ā€‹
API Key Configuration

Without an API key, the CLI uses the public rate limit (200 requests / 2 hours). With an API key, you get higher rate limits (200 requests / minute). Set your API key via environment variable:
Use the auth commands to verify your key:

Get an API Key

Sign up at li.fi to get your API key

ā€‹
Common Chain IDs

Use lifi chains to dynamically look up chain IDs instead of hardcoding them.

ā€‹
Next Steps

Installation

npm install, npx, and configuration options

Available Commands

Complete reference for all CLI commands

Examples

Output modes, exit codes, and end-to-end workflows

GitHub Repository

Source code and development instructions