spectra_scan_opportunities
Analyze Spectra chains for the best risk-adjusted yield opportunities, ranking by effective APY after entry costs amortized for your capital size.
Instructions
Scan all Spectra chains for the best risk-adjusted yield opportunities, sized to your capital.
Unlike spectra_get_best_fixed_yields (which ranks by raw APY), this tool computes:
Entry price impact at YOUR capital size (a 50% APY pool with $10K liquidity is useless at $500K)
Effective APY after amortizing entry cost over days to maturity
Morpho looping availability and optimal leveraged net APY
Pool capacity (max capital before price impact exceeds your threshold)
IBT APR composition (organic base yield vs external incentive programs)
Points program multipliers and asset tags per opportunity
External Merkl campaign APR (incentive programs beyond native yield)
Risk warnings (low liquidity, short maturity, high impact)
MetaVault alternatives (curated auto-rolling LP vaults with YT compounding)
Returns opportunities ranked by effective APY (or looping net APY where available). Ranking logic: when a profitable Morpho looping market exists, ranks by looping net APY with cumulative entry cost amortized; otherwise ranks by effective APY (base APY minus annualized entry cost).
MetaVaults are shown in a separate section (not interleaved with PT rankings) because they have different risk profiles: variable APY, curator-managed, auto-rolling positions. Set include_metavaults=false to skip MetaVault scanning.
NOTE: This scans Spectra pools only. For broader coverage including Pendle markets, use mv_scan_curator_opportunities — it includes both protocols and may surface significantly more opportunities, especially at smaller capital sizes.
Effective APY is a conservative lower bound (constant-product impact model). Real Curve StableSwap-NG pools are more capital-efficient. Verify top picks with spectra_quote_trade().
Output includes conditional competing interpretations when rankings are ambiguous — e.g., thin-liquidity pools dominating the ranking, or MetaVaults with high idle ratios.
Use spectra_get_looping_strategy to drill into a specific opportunity's leverage details. Use spectra_get_pool_activity and spectra_get_portfolio to investigate trading patterns and positions. Use spectra_model_metavault to model MetaVault looping economics.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| capital_usd | Yes | How much capital (in USD) to deploy | |
| asset_filter | No | Optional: filter by underlying asset symbol (e.g., 'USDC', 'ETH') | |
| min_tvl_usd | No | Minimum pool TVL in USD (default $10,000) | |
| min_liquidity_usd | No | Minimum pool liquidity in USD (default $5,000) | |
| include_looping | No | Whether to check Morpho looping availability (default true) | |
| max_price_impact_pct | No | Filter out pools where entry impact exceeds this % (default 5) | |
| top_n | No | Number of top results to return (default 10, max 50) | |
| include_metavaults | No | Whether to include MetaVault alternatives in results (default true). MetaVaults are curated auto-rolling LP vaults shown in a separate section. | |
| compact | No | If true, return one-line-per-opportunity output (much shorter). Omit for full details. | |
| envelope | No | If true, return structured two-block response: JSON data + narrative layer. Enables programmatic extraction while preserving interpretive content. Overridden by compact mode. | |
| ve_spectra_balance | No | Your veSPECTRA token balance. Computes the real per-pool boost using B = min(2.5, 1.5*(v/V)*(D/d)+1). Fetches live totalSupply from Base chain. If omitted, shows min/max APY ranges. |