> ## Documentation Index
> Fetch the complete documentation index at: https://docs.li.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# Available Commands

> Complete reference for all commands exposed by the LI.FI CLI

The LI.FI CLI exposes the following commands, organized by category. Each command maps to a corresponding [LI.FI API](/api-reference/introduction) endpoint.

## Token Information

### tokens

Retrieve tokens supported by LI.FI on a specific chain.

```bash theme={"system"}
lifi tokens --chain 1                    # List tokens on Ethereum
lifi tokens --chain 1 --min-price 100    # Filter by min USD price
```

| Flag | Required | Description |
| - | - | - |
| `--chain` | Yes | Chain ID to list tokens for |
| `--min-price` | No | Minimum token price in USD |

### token

Get details about a specific token including price, decimals, and contract address.

```bash theme={"system"}
lifi token 1 USDC                                              # By symbol
lifi token 1 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48        # By address
```

| Argument | Required | Description |
| - | - | - |
| `chain` | Yes | Chain ID (e.g., `1`) |
| `token` | Yes | Token symbol or contract address |

## Chain Information

### chains

List all supported blockchain networks.

```bash theme={"system"}
lifi chains                    # List all supported chains
lifi chains --type EVM         # Filter by chain type
```

| Flag | Required | Description |
| - | - | - |
| `--type` | No | Filter by chain type (e.g., `EVM`, `SVM`) |

### chain

Get details for a specific chain by ID or name.

```bash theme={"system"}
lifi chain 42161               # By chain ID
lifi chain arbitrum            # By name (case-insensitive)
```

| Argument | Required | Description |
| - | - | - |
| `chain` | Yes | Chain ID or name |

## Quote & Swap

### quote

Get the best route for a swap. Returns the optimal route, fees, estimated time, and a `transactionRequest` object ready for signing.

```bash theme={"system"}
lifi quote \
  --from ethereum --to arbitrum \
  --from-token USDC --to-token USDC \
  --amount 1000000000 \
  --from-address 0xd8dA...
```

Run without flags to enter interactive mode:

```bash theme={"system"}
lifi quote
```

| Flag | Required | Description |
| - | - | - |
| `--from` | Yes | Source chain ID or name |
| `--to` | Yes | Destination chain ID or name |
| `--from-token` | Yes | Source token address or symbol |
| `--to-token` | Yes | Destination token address or symbol |
| `--amount` | Yes | Amount in smallest unit (e.g., wei) |
| `--from-address` | Yes | Sender wallet address |
| `--order` | No | Route preference: `RECOMMENDED`, `FASTEST`, `CHEAPEST`, `SAFEST` |

<Tip>
  The response includes a `transactionRequest` object with `to`, `data`, `value`, `gasLimit`, and `chainId` fields, ready to sign and broadcast with any wallet.
</Tip>

### routes

Get multiple route options for comparison.

```bash theme={"system"}
lifi routes \
  --from 1 --to 42161 \
  --from-token USDC --to-token USDC \
  --amount 1000000000 \
  --order CHEAPEST
```

| Flag | Required | Description |
| - | - | - |
| `--from` | Yes | Source chain ID |
| `--to` | Yes | Destination chain ID |
| `--from-token` | Yes | Source token address or symbol |
| `--to-token` | Yes | Destination token address or symbol |
| `--amount` | Yes | Amount in smallest unit |
| `--order` | No | Route preference: `RECOMMENDED`, `FASTEST`, `CHEAPEST`, `SAFEST` |

## Transaction Status

### status

Track the progress of a cross-chain transfer.

```bash theme={"system"}
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
```

| Argument / Flag | Required | Description |
| - | - | - |
| `txHash` | Yes | Transaction hash from the source chain |
| `--watch` | No | Poll until the transfer completes or fails |
| `--bridge` | No | Bridge name from the quote (speeds up lookup) |

## Connections

### connections

Check available swap routes between chains.

```bash theme={"system"}
lifi connections                                       # All connections
lifi connections --from-chain 1 --to-chain 42161       # Specific pair
```

| Flag | Required | Description |
| - | - | - |
| `--from-chain` | No | Source chain ID |
| `--to-chain` | No | Destination chain ID |

## Tools (Bridges & DEXes)

### tools

List available bridges and DEXes.

```bash theme={"system"}
lifi tools                     # List all bridges and DEXes
lifi tools --chain 1           # Filter by chain
```

| Flag | Required | Description |
| - | - | - |
| `--chain` | No | Chain ID to filter results |

## Gas

### gas

Get current gas prices and suggestions.

```bash theme={"system"}
lifi gas                       # Gas prices for all chains
lifi gas 1                     # Detailed gas suggestion for Ethereum
```

| Argument | Required | Description |
| - | - | - |
| `chainId` | No | Chain ID for detailed gas suggestion |

## API Key Management

### auth show

Display the currently configured API key (masked).

```bash theme={"system"}
lifi auth show
```

### auth test

Validate the configured API key against the API.

```bash theme={"system"}
lifi auth test
```

<Note>
  The API key is read from the `LIFI_API_KEY` environment variable. See [Installation](/cli/installation) for setup instructions.
</Note>

## Health Check

### health

Check API connectivity and latency.

```bash theme={"system"}
lifi health
```

*No arguments required.*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.