spectra_list_pools
Retrieve a list of active Spectra pools on a specified chain, including TVL, implied APY, LP APY, and liquidity data. Sort by metrics, set a minimum TVL, or include expired pools.
Instructions
List all active Spectra pools on a given chain. Returns a summary of each pool including: asset name, maturity, TVL, implied APY, LP APY, pool liquidity, pool reserves (IBT/PT amounts with ratio), IBT APR breakdown (organic vs incentive yield), maturity redemption value, points multipliers, and asset tags.
Metric definitions used across all Spectra tools:
PT TVL = value of underlying deposited to mint PTs (pt.tvl in API)
Liquidity = AMM pool depth (IBT + PT both sides of the Curve pool, pool.liquidity in API)
Implied APY = annualized fixed rate from buying PT at discount
IBT APR = variable rate on the underlying vault (labeled APR, not compounded)
Each pool is a Curve StableSwap-NG AMM pair of IBT and PT. LP APY is the yield from providing liquidity to the pool (fees + gauge emissions).
Set include_expired=true to also show recently matured pools (if the API returns them). By default only active (non-expired) pools are shown.
Includes external Merkl campaign APR when available. Output surfaces conditional competing interpretations when data is ambiguous (e.g., high APY with thin liquidity).
For multi-chain discovery, use spectra_get_best_fixed_yields (raw APY ranking) or spectra_scan_opportunities (capital-aware with price impact and looping analysis). Use spectra_get_pool_activity on a specific pool to see recent trading patterns.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | Yes | The blockchain network to query | |
| sort_by | No | Sort results by this metric (descending) | implied_apy |
| min_tvl_usd | No | Minimum TVL in USD to include in results | |
| compact | No | If true, return one-line-per-pool output (much shorter). Use for quick scanning; omit for full details. | |
| include_expired | No | If true, include recently matured/expired pools in results. Default false (active only). |