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

> Discover chains, protocols, and assets before running strategy-specific commands.

Use market-discovery commands to scope chains/protocols and normalize assets first.

## Supported chains

Enumerate all chains the CLI recognizes, including slugs and CAIP-2 identifiers. No API keys required.

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

Use this to discover valid `--chain` values before running other commands.

## Top chains by TVL

```bash theme={null}
defi chains top --limit 10 --results-only --select rank,chain,chain_id,tvl_usd
```

## Asset TVL on a chain

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

Notes:

* `chains assets` requires `DEFI_DEFILLAMA_API_KEY`.
* If filtering by token address/CAIP-19, the token must have a known symbol on that chain.

## Gas prices

Query live EVM gas prices (no API key, bypasses cache).

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

Multi-chain queries run in parallel and return partial results if some chains fail. Use `--rpc-url` to override the default RPC (single chain only).

## Top protocols and categories

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

Category ranking is deterministic: `tvl_usd`, then protocol count, then name. When `--chain` is specified, TVL reflects the protocol's value locked on that chain.

## Protocol fees and revenue

```bash theme={null}
defi protocols fees --limit 10 --results-only --select rank,protocol,fees_24h_usd,change_1d_pct
defi protocols fees --category Dexs --chain Ethereum --limit 10 --results-only
defi protocols revenue --limit 10 --results-only --select rank,protocol,revenue_24h_usd,change_1d_pct
```

Rankings sorted by 24h value descending. Revenue represents protocol-retained fees (not LP/validator). Both support `--category` and `--chain` filters. No API key required.

## DEX volume rankings

```bash theme={null}
defi dexes volume --limit 10 --results-only --select rank,protocol,volume_24h_usd,change_1d_pct
defi dexes volume --chain Arbitrum --limit 5 --results-only
```

Rankings are sorted by 24h volume descending. Use `--chain` to filter DEXes active on a specific chain. No API key required.

## Stablecoin market data

```bash theme={null}
defi stablecoins top --limit 10 --results-only --select rank,symbol,circulating_usd,price
defi stablecoins top --peg-type peggedUSD --limit 20 --results-only
```

Returns circulating market cap, current price, chain count, and day/week/month supply change deltas. Useful for stablecoin selection and depeg monitoring.

## Stablecoin chains

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

Ranks chains by total stablecoin market cap with dominant peg type and CAIP-2 chain IDs. No API key required.

## Resolve assets to canonical IDs

```bash theme={null}
defi assets resolve --chain base --asset USDC --results-only
defi assets resolve --chain eip155:1 --asset eip155:1/erc20:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 --results-only
```

Use this as a normalization step before storing request plans for agents.