spectra_list_expiring_pools
List pools nearing maturity across Spectra chains, grouped by urgency. Includes successor status, gauge info, and a readiness assessment to plan rollover or migration.
Instructions
Scan all Spectra chains for pools approaching maturity.
Returns pools expiring within the specified threshold (default 21 days / 3 weeks), grouped by urgency level. Designed for operators who need lead time to:
Create follow-up pools with new maturities
Submit gauge proposals for successor pools
Plan LP migration and rollover strategies
Coordinate with IBT protocol teams
Each result includes the PT address, IBT address, chain ID, underlying asset, TVL, and current implied APY — everything needed to plan the successor pool.
Automatically cross-references each expiring pool's IBT against all active pools to flag whether a successor pool (same IBT, later maturity) already exists or needs to be created.
Gauge status is fetched from the governance voting-incentives API. A pool address present in that endpoint has a gauge (even if it currently has 0 votes / 0 emissions). Gauge API failure is best-effort — gauge status shows as unknown, does not block results.
Per-pool readiness assessment combines successor status, gauge status, and timing: OK: Successor deployed with gauge and seeded CAUTION: Successor exists but missing gauge or low TVL; or no successor but >7d runway WARNING: No successor and ≤7d; or successor without gauge and ≤14d
Urgency (time-based) and readiness (action-based) are independent dimensions. A pool can be ALERT urgency (21d runway) but WARNING readiness (no successor at all). The Operator Checklist section groups required actions by type:
Deploy successor pool: IBTs with no active successor
Submit gauge proposal: successors that exist but lack a gauge
Ready for migration: successors with gauge and adequate TVL
Urgency levels: CRITICAL (≤7 days): Immediate action required WARNING (≤14 days): Start preparations now ALERT (≤21+ days): Plan ahead
Set include_expired=true to also show recently matured pools (if the API returns them). By default only active (non-expired) pools are shown.
Use mv_plan_rollover on a specific MetaVault for automated rollover candidate discovery. Use spectra_get_yield_curve to see what maturities already exist for the same underlying. Use spectra_list_pools to check if a successor pool has already been created.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| threshold_days | No | Warning threshold in days before maturity (default 21 = 3 weeks). Pools expiring within this window are returned. | |
| chain | No | Restrict to a single chain. Omit to scan all chains. | |
| min_tvl_usd | No | Minimum TVL in USD to include (default 0 = show all) | |
| compact | No | One-line-per-pool output for quick scanning. Omit for full details. |