Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vaults.fyi/llms.txt

Use this file to discover all available pages before exploring further.

This page tracks all notable updates to the vaults.fyi API and application, organized by week.

​
Week 21, 2026 — May 19–25

API
  • Added partial returns in Beta with GET /beta/portfolio/partial-returns/{userAddress}/{network}/{vaultId}. The endpoint calculates a user’s vault returns for a specific time window using fromTimestamp and optional toTimestamp, returning native-token returns plus asset metadata. This gives integrators a way to measure period-specific performance instead of only lifetime total returns.
  • Added historical user positions with GET /alpha/historical-positions/{userAddress}. The endpoint returns vaults a user held during a selected time window, including positions that existed at the start of the window or were opened during it. This helps apps reconstruct previous user exposure, not just current balances.
  • Added borrow portfolio positions to the Alpha API, including list, market-level, and asset-level views via GET /alpha/borrow/portfolio/positions/{userAddress}, GET /alpha/borrow/portfolio/positions/{userAddress}/{network}/{marketId}, and GET /alpha/borrow/portfolio/positions/{userAddress}/{network}/{marketId}/{assetAddress}. These endpoints expose supplied and borrowed asset positions, LTV, health factor, and optional filters for networks, assets, value thresholds, and sorting.
  • Added daily vault flow history with GET /alpha/historical/{network}/{vaultId}/daily-flows, exposing UTC daily deposit and redemption totals for a vault over a date range.
  • Standardized API error documentation across V2 and Alpha endpoints: validation-style failures are now documented as 422 Unprocessable Entity, and obsolete 502 Bad Gateway response entries were removed from the OpenAPI spec.
  • Improved API metadata quality by ensuring endpoint definitions include operationId and summary, improving SDK generation and API explorer output.
App
  • Improved dashboard portfolio views with tab-linked state, cleaner side-panel layout, hidden empty states, updated copy, and average APY by group.
  • Refined dashboard analytics and benchmark copy, including a clearer benchmark-rate section and reordered breakdown-chart legend items.
  • Improved transaction and swap UX with safer swap route selection, guarded swap execution, better loading states for returns queries, and updated fee/safety messaging.
  • Added agent-readiness improvements, including markdown negotiation, agent skills, and MCP fixes for AI integrations.

​
Week 20, 2026 — May 12–18

API
  • Alpha borrow market transactions now support context and action payloads for supply, withdraw, borrow, and repay flows via GET /alpha/borrow/markets/transactions/context/{userAddress}/{network}/{marketId}/{assetAddress} and GET /alpha/borrow/markets/transactions/{action}/{userAddress}/{network}/{marketId}/{assetAddress}.
  • Added borrow market portfolio events with GET /alpha/borrow/portfolio/events/{userAddress}/{network}/{marketId}/{assetAddress}, giving integrators user-level event history for a specific borrow market and asset.
  • Added protocol-specific borrow transaction payloads for Aave Alpha borrow integrations, including deposit/redeem/borrow/repay actions. Morpho borrow transaction flows are still in progress and are not ready for production use yet.
  • Improved API-key flows: invite codes are no longer required for Portal signup, so users can now sign up and generate API keys directly at portal.vaults.fyi/signup. Credit top-up and exhausted-credit messages now point users back to the Portal.
App
  • Redesigned the Analytics page for a cleaner market overview and comparison experience.
  • Added a score filter to the discovery table, making it easier to screen vaults by vault quality.
  • Updated app signup CTAs to point directly to the self-service Portal signup flow.
  • Improved dashboard position visibility for low-TVL vaults, plus smaller table, filter, side-panel, and mobile transaction-panel UX fixes.

​
Week 19, 2026 — May 5–11

API
  • GET /v2/vaults now includes name, making it easier to build vault selectors and search UIs without fetching full vault details.
  • All new API keys now include access to every endpoint — future keys are no longer split by endpoint access tier. Plans now differ by credits, rate limits, and support rather than which endpoints are available.
  • Added Liquity protocol coverage and 52 new vaults, bringing total tracked coverage to 1,525 vaults across 20 networks.
  • Expanded Alpha borrow markets with historical market data and portfolio event tracking for borrow positions.
App
  • Vault suggestions now filter out lower-quality vaults from personalized and trending surfaces.
  • Added UI support for vault score penalties and resolutions, making risk and warning context clearer in the app.
  • Improved transaction and side-panel UX, including estimated returns, missing actions, mobile transaction panel styling, and CCTP disabled states.
  • Added the pay-as-you-go API pricing tier to the pricing page.

​
Week 18, 2026 — Apr 28–May 4

API
  • Reputation Score now reflects active vault flags — warnings and risk indicators directly apply severity-based penalties to each vault’s Reputation Score: critical flags carry the largest deduction, warning flags moderate, and info-level flags minimal. Vaults with active warnings will show a lower Reputation Score, providing a more accurate signal of current vault health. This change is backwards compatible. Responses now include a penaltyComponents field detailing each active flag and its resolution status.
  • New GET /v2/transactions/suffix/{userAddress}/{vaultId} endpoint — returns a raw hex suffix to append to transaction calldata, enabling onchain attribution of deposits and withdrawals back to your API key.
  • New borrow markets endpoints (Alpha) — four new endpoints for discovering and analyzing borrowing opportunities:
    • GET /alpha/borrow/markets/ — all supported borrow markets across networks
    • GET /alpha/borrow/markets/{network} — filter by network
    • GET /alpha/borrow/markets/{network}/{marketId} — detailed data for a single market, including rates, utilization, and collateral
    • GET /alpha/borrow/markets/historical/{network}/{marketId}/{assetAddress} — historical rates and utilization over time for a specific asset within a market
  • StakeWise V3 transactional support — deposit and withdrawal flows now available for StakeWise V3 vaults. See the transactions reference.
  • Expanded Solana vault coverage — Jupiter and Kamino Vaults are now fully integrated, extending beyond the data aggregates added in Week 16 to include complete vault support.
  • Improved BoringVault support — async deposit and withdrawal queues are now handled correctly throughout the transaction lifecycle.
App
  • Updated landing page at vaults.fyi.
  • Redesigned side panel on vault detail pages.

​
Week 17, 2026 — Apr 21–27

API • IntroducedvaultId — a new stable identifier field on vault responses and a new path parameter across detailed-vaults, historical, NRT, portfolio, and transactions endpoints. vaultId supports both contract addresses and non-address identifiers like Morpho market IDs. Fully backwards compatible: existing vault addresses continue to work. • Faster holder queries — vault holder data now returns significantly faster, especially for high-holder-count vaults. • Near real-time (NRT) endpoints moved out of Alpha API, now exclusively available on the V2 production API. • Rhinestone intent transactions now reject partial solves instead of silently returning incomplete execution paths. App • Continued app redesign rollout: refreshed top navigation bar, updated vault page layout, redesigned table UI, and new input styling. • Updated vault score thresholds in the UI display.

​
Week 16, 2026 — Apr 14–20

API
  • NRT endpoints promoted to production — near-real-time vault data (/v2/nrt/vault/...) is now available on the V2 API, delivering live share price, total supply, total assets, and underlying asset price.
  • All 34 V2 endpoints now include operationId and summary fields in the OpenAPI spec, improving SDK code generation and API explorer usability.
  • New descriptive tags across all endpoint groups (General, Detailed Vaults, Benchmarks, Historical, Portfolio, Transactions, NRT) for better API navigation.
  • apyComposite on detailed-vaults responses now includes assetGroup and assetPriceInUsd for the underlying asset.
  • Removed ERC-4626 restriction for Rhinestone intent quotes, broadening cross-chain deposit support to non-ERC-4626 vaults.
  • Added Kamino and Jupiter Earn vault aggregates for Solana coverage.
App
  • Intrinsic APY now displays on the dashboard for vaults with nested yield sources.

​
Week 15, 2026 — Apr 7–13

API
  • Added transactional support for IPOR and Advanced Strategies BTC, enabling deposit and withdrawal flows for these protocols.
  • Added Convex protocol-specific position data to the positions endpoint.
App
  • Launched the first phase of the app redesign with refreshed navigation, updated icons, and the new Geist typeface.
  • Improved search accuracy across the vault table with tuned fuzzy matching.

​
Week 14, 2026 — Mar 31–Apr 7

API
  • Added APYx, Aave V4 (tokenized spokes), and Ember as new protocol integrations.
  • New GET /v2/protocols endpoint returns the full list of available protocols with name, product, and version. Useful for populating filter dropdowns and validating allowedProtocols params.
  • New apyComposite field on detailed-vaults responses replaces intrinsic, with a richer structure: totalApy (compounded vault + underlying APY) and intrinsicApy (yield intrinsic to the underlying asset, e.g. staking yield), each with 1day / 7day / 30day intervals including base, reward, and total.
  • New minVaultScore filter on detailed-vaults endpoints for filtering by vault quality score.
  • Shipped auto-indexing for new vaults — newly deployed vaults are now surfaced in the API faster.
Migration required: All /experimental/ endpoints have been renamed to /alpha/. Update any integrations using /experimental/ paths. See the Alpha API reference.
App
  • The /analytics page gained split network benchmarks, shared Y-axis scaling for chart comparison, and updated default vault comparison lists.
  • Fee transparency improved with Fluid withdrawal fee notes and generic fee indicators.
  • Added protocol tooltip to the vault table, APY format capping above 1,000% for cleaner display, and updated protocol/curator images.

​
Week 13, 2026 — Mar 24–30

API
  • Vault capacity landed in the detailed-vaults endpoint — integrators can now see deposit caps and utilization.
  • Added vault flags with severity to the API, surfacing warning indicators for vaults.
  • CCTP forwarding fee optimization skips unnecessary fees for same-chain operations.
App
  • Shipped major /analytics page upgrades: TVL sections, shareable benchmark URLs via URL params, improved benchmark dropdown, and repositioned APY range toggle and period selector.
  • Vault flags now display as warning indicators on vault listings.

​
Week 12, 2026 — Mar 17–23

API
  • Added Etherlink as a new network with Morpho vault factories.
  • Launched OpenCover protocol support with solver-based async deposit settlement tracking.
  • Vault capacity data is now aggregated and stored, with the pipeline ready for API exposure.
  • Introduced vault warnings with severity levels.
App
  • Etherlink fully integrated in the app.
  • The asset scoring system was revamped for more accurate reputation calculations, and intrinsic yield indicators now display in the UI.
  • CCTP transfer tracking added to the frontend.

​
Week 11, 2026 — Mar 10–16

API
  • Added Ultrayield as a new protocol.
  • Introduced multi-asset Upshift vaults, a Gauntlet gtBTC vault, and capacity indicators that show when vaults are near their supply cap.
App
  • Shipped the CCTP cross-chain bridging page, enabling users to bridge assets between supported networks directly in the app.
  • The vault opportunity page was redesigned with improved SEO and layout.

​
Week 10, 2026 — Mar 3–9

API
  • Added Concrete V2 protocol with full async request-redeem flows.
  • Shipped NRT endpoints (alpha) and moved deep AMM endpoints to the new beta API section.
  • Reorganized alpha API structure for clearer endpoint grouping.
App
  • Major vault page redesign went live.

​
Week 9, 2026 — Feb 24–Mar 2

API
  • Added near-real-time (“NRT”) endpoints (alpha) for current data on vault share price, total assets, total supply, and underlying asset price.
  • Shipped historical asset prices endpoint (/v2/historical/asset-prices/{network}/{address}) for USD price time series.
  • Introduced APY update timestamps for LLMs to help AI consumers know data freshness.
  • Expanded Upshift support with separate handling for distinct vault types.

​
Week 8, 2026 — Feb 17–23

API
  • Launched vault fees in the API — the detailed-vaults endpoint now returns fee data (performance, management, deposit) read from onchain contracts.

​
Week 7, 2026 — Feb 10–16

API
  • Shipped Aera vaults on additional chains (beyond mainnet).
App
  • Added external links on vault pages and curator name truncation.
  • Improved wallet connectivity with enhanced capabilities detection.

​
Week 6, 2026 — Feb 3–9

API
  • Added Monad chain setup and initial configuration.
  • Improved position tracking accuracy with daily user balance computation.
  • Added the intent status endpoint (alpha) and expanded intent quote responses with asset decimals and expiration timestamps.
  • Added Avon protocol with analytics and transactional support.
App
  • Fixed holders chart rendering for edge cases.

​
Week 5, 2026 — Jan 27–Feb 2

API
  • Added the Pendle transactions endpoint (alpha) for constructing Pendle position entry/exit flows, plus a Pendle transactions context endpoint for pre-flight data.
  • Shipped Veda vault event tracking for improved queue monitoring and position visibility.
  • Introduced isCorrupted flag in vault responses to surface data quality issues transparently.
  • Launched CCTP cross-chain bridge transaction endpoints (alpha) — context, execution, and status tracking for Circle CCTP transfers.
  • Improved holder computation performance and balance calculation accuracy.

​
Week 4, 2026 — Jan 20–26

API
  • Shipped intent-based cross-chain transactions (alpha) with Rhinestone integration, enabling cross-chain deposit flows via EIP-712 signed quotes.
  • APY min/max filters were expanded for more flexible vault queries.
  • Added Kelp restaking analytics support.
App
  • Added multiple rewards claiming UI overhaul for better multi-vault reward management.
  • Refined network filter sorting with proper chain name handling.

​
Week 3, 2026 — Jan 13–19

API
  • Introduced the alpha Pendle market read endpoint, laying groundwork for fixed-term yield products.
  • Added deposit limit visibility — the detailed-vaults endpoint now returns maxDeposit data.
  • Shipped Mellow multi-vault transactional support and split the Mellow protocol into distinct services.
  • Added Euler on Linea and the Katana MetaMorpho integration.
App
  • Deposit limit indicators now display in the app UI.
  • Frontend optimizations reduced memory usage and bundle size for faster page loads.

​
Week 2, 2026 — Jan 6–12

API
  • Launched the curators endpoint (/v2/curators) as a new first-class API resource for vault curator discovery and filtering.
  • Added Katana network support with Yearn and MetaMorpho vaults, including token aliases and image handling.
  • Shipped Mellow Core protocol support, plus Veda vault integration via Lido.
  • Introduced Lagoon vault discovery via API and Morpho V2 factory support.
  • Improved position tracking accuracy with upgraded balance calculations and holder computation.
App
  • Added curator sorting in filters.