spectra_get_curator_dashboard
Aggregate MetaVault health, position status, depositor flows, fee revenue estimates, and alerts into a single operational dashboard for curators.
Instructions
Operational dashboard for MetaVault curators.
Aggregates vault health, position status, depositor flows, fee revenue estimates, and actionable alerts into a single view. Designed for curators managing live MetaVaults who need a quick operational overview.
Returns:
Vault health: TVL with unallocated ratio (undeployed capital AFTER subtracting external positions — shown when >5%), Status label for non-VISIBLE vaults, live APY with optional 30d avg suffix and APY composition (base vs incentives), share price
APY 4-number breakdown when live-vs-30d delta ≥ 0.5pp: shows base+incentive decomposition for both snapshots WITHOUT asserting causality (agents draw their own conclusions from the numbers)
Position status: each active PT position with maturity countdown, APY, and size. Positions approaching maturity are flagged (!!!=14d, !!=30d)
External Positions: value held OUTSIDE Spectra LP structure (avant avUSDx-burn redemption-in-flight, pendle LP on other protocols). Rendered per-protocol with graceful fallback for unknown protocols
Capital State decomposition line: when ≥1 of {expired-stuck, external} buckets populated, emits a single line showing deployed/expired-stuck/ external/unallocated as % of TVL
Depositor flows: epoch-by-epoch net inflows/outflows with trend analysis
Fee revenue: estimated annual curator fee revenue (snapshot projection)
Action items: auto-generated alerts including [UNALLOC] (softened when external capital coexists), [STATUS] (HIDDEN vaults), [PENDLE-EXT URGENT/UPCOMING/EXPIRED] (external Pendle maturity), [EXPIRED] / [URGENT] / [SOON] / [UPCOMING] (Spectra LP maturity), [OUTFLOWS], [BRIDGE], [INCENTIVE], [PENDLE ROLLOVER]
Pool allocations show each position as a % of total vault TVL (e.g., "37.1% | $236K"), sorted by size, with protocol tags ([Spectra]/[Pendle]/[Unknown]) on each position. Unallocated liquidity is shown separately (and excludes capital deployed in external positions — labeled as "unallocated" to distinguish from "idle"). When the API doesn't provide LP balance data for a position, it shows "?%".
Cross-chain positions: MetaVault positions may live on a different chain than the MetaVault itself (e.g., Base MetaVault → Avalanche pools via CCTP bridge). Pool addresses in positions are on the position's chain, not the MetaVault's home chain.
Epoch flows: Derived from asset snapshots and rate changes. Yield accrual is estimated from share rate deltas — actual yield may differ. Use share price trend to corroborate.
Requires chain + metavault_address. Use spectra_list_metavaults to discover addresses. Use spectra_model_metavault for leverage modeling after reviewing the dashboard. Use spectra_get_pool_activity on specific pool addresses for trading pattern analysis. Use spectra_get_address_activity on the curator's EOA for cross-pool curator activity.
When verify_externals=true (off by default), each avant external position is probed on Avalanche's RequestsManager — confirms state (CREATED/COMPLETED/CANCELLED), provider attribution, on-chain amount (with PPM tolerance for API rounding), global counter, and pause flag. A [chain-truth ✓/⚠/✗] line is appended under each avant position. Per-order failures degrade gracefully and never poison sibling positions or block the dashboard. Pendle externals are NOT yet probed in this slice.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | Yes | The blockchain network where the MetaVault lives. | |
| metavault_address | Yes | The MetaVault contract address. Use spectra_list_metavaults to discover addresses. | |
| curator_fee_pct | No | Curator performance fee as % of vault yield (default 10%). Used for fee revenue estimation. | |
| verify_externals | No | Verify each externalPosition on its target chain (Theme E). Today probes Avant burn orders against Avalanche RequestsManager — confirms state (CREATED/COMPLETED/CANCELLED), provider attribution, on-chain amount, queue counter, and pause flag. Off by default — adds RPC latency and pressure on each external. Use when an avant external is load-bearing for a curator decision (large redemption-in-flight, stuck claim, suspected stale API). Per-position failures degrade to a [chain-truth ✗] line but never poison sibling positions. Pendle external verification is a separate next-session slice. Dissolution: if telemetry shows zero verify_externals=true invocations within 60 days of ship, the flag is fossil — fold the verifier into list-mode default or remove. |