> ## Documentation Index
> Fetch the complete documentation index at: https://defi-cli.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Market Commands

> Reference for providers, chains, protocols, dexes, stablecoins, and assets commands.

## `providers list`

List supported providers and capability auth metadata.

```bash theme={null}
defi providers list --results-only
```

## `chains list`

List all supported chains with slugs, CAIP-2 identifiers, namespaces, and accepted aliases. No API keys required; bypasses cache.

```bash theme={null}
defi chains list --results-only
defi chains list --results-only --select slug,caip2,namespace
```

## `chains top`

Top chains by TVL.

```bash theme={null}
defi chains top --limit 20 --results-only
```

Flags:

* `--limit int` (default `20`)

## `chains assets`

Asset-level TVL for a chain.

```bash theme={null}
defi chains assets --chain 1 --asset USDC --limit 20 --results-only
```

Flags:

* `--chain string` (required)
* `--asset string` (optional filter)
* `--limit int` (default `20`)

Auth: requires `DEFI_DEFILLAMA_API_KEY`.

Reason: `chains assets` is backed by a DefiLlama endpoint that is provider-gated.

## `chains gas`

Current EVM gas prices (base fee, priority fee, gas price in gwei) with block number and EIP-1559 detection. EVM-only; bypasses cache.

```bash theme={null}
defi chains gas --chain 1 --results-only
defi chains gas --chain 1,10,137,8453,42161 --results-only
```

Flags:

* `--chain string` (required; comma-separated for multiple chains)
* `--rpc-url string` (optional; single chain only)

No API key required. Multi-chain queries run in parallel and return an array with partial-result support.

## `protocols top`

Top protocols by TVL. When `--chain` is specified, TVL reflects the protocol's value locked on that chain rather than total TVL.

```bash theme={null}
defi protocols top --category lending --limit 20 --results-only
defi protocols top --chain Ethereum --limit 10 --results-only
```

Flags:

* `--category string` (optional)
* `--chain string` (optional, filter by chain presence; uses chain-specific TVL for ranking)
* `--limit int` (default `20`)

## `protocols categories`

List categories with protocol counts and TVL.

```bash theme={null}
defi protocols categories --results-only
```

## `protocols fees`

Top protocols by 24h fee revenue. Includes 7d/30d totals and 1d/7d/1m percentage changes.

```bash theme={null}
defi protocols fees --limit 10 --results-only
defi protocols fees --category Dexs --limit 20 --results-only
defi protocols fees --chain Ethereum --limit 10 --results-only
```

Flags:

* `--limit int` (default `20`)
* `--category string` (optional filter, e.g. `Dexs`, `Lending`)
* `--chain string` (optional filter by chain presence, e.g. `Ethereum`, `Arbitrum`)

No API key required; data sourced from DefiLlama fees API.

## `protocols revenue`

Top protocols by 24h revenue (protocol-retained fees, excluding LP/validator earnings). Includes 7d/30d totals and 1d/7d/1m percentage changes.

```bash theme={null}
defi protocols revenue --limit 10 --results-only
defi protocols revenue --category Dexs --limit 20 --results-only
defi protocols revenue --chain Ethereum --limit 10 --results-only
```

Flags:

* `--limit int` (default `20`)
* `--category string` (optional filter, e.g. `Dexs`, `Lending`)
* `--chain string` (optional filter by chain presence, e.g. `Ethereum`, `Arbitrum`)

No API key required; data sourced from DefiLlama revenue API.

## `dexes volume`

Top DEXes by 24h trading volume. Includes 7d/30d totals and 1d/7d/1m percentage changes.

```bash theme={null}
defi dexes volume --limit 10 --results-only
defi dexes volume --chain Arbitrum --limit 5 --results-only
```

Flags:

* `--limit int` (default `20`)
* `--chain string` (optional filter by chain presence, e.g. `Ethereum`, `Arbitrum`)

No API key required; data sourced from DefiLlama DEX volume API.

## `stablecoins top`

Top stablecoins by circulating market cap. Includes price, chain count, and day/week/month supply change deltas.

```bash theme={null}
defi stablecoins top --limit 10 --results-only
defi stablecoins top --peg-type peggedUSD --limit 20 --results-only
```

Flags:

* `--limit int` (default `20`)
* `--peg-type string` (optional filter, e.g. `peggedUSD`, `peggedEUR`)

No API key required; data sourced from DefiLlama stablecoins API.

## `stablecoins chains`

Chains ranked by total stablecoin market cap with dominant peg type and CAIP-2 chain IDs.

```bash theme={null}
defi stablecoins chains --limit 10 --results-only
defi stablecoins chains --limit 10 --results-only --select rank,chain,circulating_usd
```

Flags:

* `--limit int` (default `20`)

No API key required; data sourced from DefiLlama stablecoin chains API.

## `assets resolve`

Resolve symbol/address/CAIP-19 to canonical asset metadata.

```bash theme={null}
defi assets resolve --chain base --asset USDC --results-only
```

Flags:

* `--chain string` (required)
* `--asset string` or `--symbol string` (at least one required)