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.

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

defi chains top --limit 10 --results-only --select rank,chain,chain_id,tvl_usd

Asset TVL on a chain

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).

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

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

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

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

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

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

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.