> ## 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.

# Vaults.fyi API & App Changelog

> A week-by-week log of all API and app updates shipped by vaults.fyi, including new protocols, endpoints, and product improvements.

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

***

## Week 26, 2026 — Jun 23–29

**API**

* Expanded Beta borrow market coverage with **Compound V3** and **Spark** market support, and improved borrow position handling so live oracle issues on a market do not hide otherwise available user position data.

* Moved **SVM / Solana vault endpoints into Beta**. Solana vault discovery, detailed vaults, portfolio positions, portfolio events, idle assets, transaction context, and transaction payloads now live under `/beta/svm/...`, matching their current stability level in the API Reference.

* Added **SVM idle asset tracking** for Solana portfolios. `GET /beta/svm/portfolio/idle-assets/{userAddress}` returns idle token balances for a user, while `GET /beta/svm/portfolio/idle-assets/{userAddress}/{assetAddress}` scopes the result to a single asset.

* Added optional **SVM transaction simulation** with `simulate=true` on `GET /beta/svm/transactions/{action}/{userAddress}/{vaultAddress}`. Responses can now include simulation status plus token amounts expected to be spent or received, helping integrators preview Solana vault actions before signing.

* Expanded SVM detailed-vault filtering. `GET /beta/svm/detailed-vaults` now supports filters such as `allowedAssets`, `allowedProtocols`, and `minTvl`, making Solana vault discovery easier to narrow down programmatically.

* Expanded V2 vault and portfolio filters. `GET /v2/detailed-vaults`, `GET /v2/portfolio/best-vault/{userAddress}`, and `GET /v2/portfolio/best-deposit-options/{userAddress}` now expose additional filtering options including `maxApy`, `maxTvl`, `tags`, and `curators`. The portfolio endpoints now default toward app-featured vaults and exclude warning-flagged vaults unless requested.

* Added vault **composition** to Alpha advanced analytics. `POST /alpha/advanced-analytics` can now request `select.composition`, returning the vault's underlying investments and allocation percentages where available.

* Improved x402 payment infrastructure with batch settlement support and Bazaar-compatible bigint handling for payment validation flows.

***

## Week 25, 2026 — Jun 16–22

**API**

* Moved borrow endpoints into **Beta**. Borrow market discovery, historical market data, portfolio positions, portfolio events, and transaction/context routes now live under `/beta/borrow/...`, matching the current stability level of the borrowing API.

* Added pagination to borrow market discovery and borrow event history. `GET /beta/borrow/markets` and `GET /beta/borrow/markets/{network}` now return paginated responses with `itemsOnPage`, `nextPage`, and `data`, making large borrow-market lists easier to consume reliably.

* Added **historical balances** in Alpha with `GET /alpha/historical-balances/{userAddress}/{timestamp}`. Integrators can now reconstruct a user's vault positions and balances at a specific historical timestamp, with the same filtering model used across portfolio-style endpoints.

* Added **SVM portfolio events** in Alpha. `GET /alpha/svm/portfolio/events/{userAddress}` returns Solana/SVM vault activity across supported vaults, while `GET /alpha/svm/portfolio/events/{userAddress}/{vaultAddress}` scopes the result to a single vault.

* Improved transaction support for **Veda / BoringVault** redeem flows by enabling instant redeems where the vault configuration supports them.

* Improved x402 payment handling, including CDP facilitator authentication, `upto` settlement support, and Bazaar-compatible x402 validation.

* Added automatic redirects for older API version paths during version moves, reducing breakage for clients still calling recently moved Alpha/Beta routes.

**App**

* Added a public widget showcase for embedded vault experiences, with follow-up UI refinements shipped during the week.

* Added chart brushing / zoom controls across analytics and vault performance charts, making dense historical data easier to inspect.

* Added vaults.fyi watermarks to app charts and refined their placement so exported/shared charts carry clearer product attribution without covering the data.

***

## Week 24, 2026 — Jun 9–15

**API**

* Made `sharePrice` values more consistent across V2 historical, near-real-time, and portfolio event responses, especially for protocols with custom price-per-share units.

* Increased API path-parameter support for longer vault identifiers and descriptors. Integrators using stable `vaultId` values, non-address market identifiers, or descriptor-style IDs can now send longer path params without hitting the previous request parser limit.

* Improved **Accountable** vault aggregation so TVL and share-price calculations use the protocol-specific `convertToAssets(totalSupply)` path instead of relying on the generic ERC-4626 `totalAssets()` value. This reduces incorrect historical rows for Accountable vaults whose `totalAssets()` value does not reflect the vault's redeemable assets.

* Added a one-command MCP setup path for agent integrations with `npx @vaultsfyi/scripts init-mcp --api-key YOUR_VAULTS_API_KEY`, covering Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, Zed, Amazon Q, and GitHub Copilot CLI.

**App**

* Shipped the first version of the vaults.fyi widget for embedded earn experiences. More public integration materials will follow.

* Young vaults now display as **Not Rated** instead of showing a numeric Reputation Score too early. This avoids presenting immature vault history as a mature risk signal.

***

## Week 23, 2026 — Jun 2–8

**API**

* Added **vault deployment timestamps** to V2 detailed vault responses. Integrators can now sort, filter, or label vaults by launch age without doing a separate chain lookup. The new `creationData.deploymentTimestamp` field is available on `GET /v2/detailed-vaults` and `GET /v2/detailed-vaults/{network}/{vaultId}`.

* Improved **partial returns** in Beta so time-window return calculations use stored historical vault data points more reliably. This makes period-specific user return views more dependable, especially when the requested start or end timestamp does not line up exactly with an indexed event.

* Expanded **borrow transaction support** for Morpho markets through the shared Beta borrow transaction surface. Integrators can build borrow-market transaction flows against the same model used for generalized borrow integrations, instead of wiring protocol-specific transaction logic. Use `GET /beta/borrow/markets/transactions/context/{userAddress}/{network}/{marketId}/{assetAddress}` and `GET /beta/borrow/markets/transactions/{action}/{userAddress}/{network}/{marketId}/{assetAddress}` for transaction context and action payloads.

* Updated x402 handling for historical endpoints to support `upto` payment requirements. Payment-aware clients can now handle variable-sized historical queries more cleanly across historical vault data, APY, TVL, share price, asset prices, and benchmarks.

* Added **Savings GHO** support to Aave protocol coverage.

* Clarified max drawdown documentation in Alpha advanced analytics. MDD is now described as the largest observed peak-to-trough drop in vault price per share over the selected window, rather than a generic drawdown metric.

**App**

* Improved Discover filters so active user input is no longer overwritten while debounced filters sync.

* Improved analytics and best-performing vault views by using raw vault-history cache data for cleaner historical performance calculations.

* Renamed APY language to **Yield** on Discover, matching how users evaluate vault returns across base yield, rewards, and composite vault behavior.

***

## Week 22, 2026 — May 26–Jun 1

**API**

* Added **advanced vault analytics** in Alpha with `POST /alpha/advanced-analytics`. The endpoint mirrors detailed-vault filtering and pagination, while letting integrators opt into heavier per-vault analytics sections such as max drawdown, withdrawal pause ratio, and the full detailed-vault payload.

* Added **max drawdown (MDD)** as an advanced analytics selector. This helps integrators compare vaults by their largest observed peak-to-trough decline over the tracked period.

* Added **withdrawal pause ratio** as an advanced analytics selector. This gives integrators a structured way to screen how often vault withdrawals have been paused over the tracked window, returning `null` when the protocol or event source does not support the metric yet.

* Cleaned up the Beta borrow API by removing older protocol-specific Aave and Morpho borrow routes from the OpenAPI surface. Integrators should use the generalized borrow market and borrow portfolio endpoints under `/beta/borrow/markets/...` and `/beta/borrow/portfolio/...` instead.

* Updated x402 payment response schemas across V2 and Alpha documentation to use structured payment-resource metadata and amount fields, improving compatibility with payment-aware clients and generated SDKs.

**App**

* Redesigned the vault performance section for a clearer view of vault-level performance data.

* Improved mobile discovery and dashboard UX, including redesigned filters on the Discover page and a redesigned dashboard vault card on mobile.

* Updated chart colors and vault reward display conditions so app visuals and reward visibility are cleaner across vault pages.

***

## 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 Beta API, including list, market-level, and asset-level views via `GET /beta/borrow/portfolio/positions/{userAddress}`, `GET /beta/borrow/portfolio/positions/{userAddress}/{network}/{marketId}`, and `GET /beta/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**

* **Beta borrow market transactions** now support context and action payloads for supply, withdraw, borrow, and repay flows via `GET /beta/borrow/markets/transactions/context/{userAddress}/{network}/{marketId}/{assetAddress}` and `GET /beta/borrow/markets/transactions/{action}/{userAddress}/{network}/{marketId}/{assetAddress}`.

* Added **borrow market portfolio events** with `GET /beta/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** Beta 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](https://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 **Beta 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](/methodology/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](/api-reference/transactions)** — 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 ([Beta](/api-reference/beta#borrow-markets))** — four endpoints for discovering and analyzing borrowing opportunities:
  * `GET /beta/borrow/markets/` — all supported borrow markets across networks
  * `GET /beta/borrow/markets/{network}` — filter by network
  * `GET /beta/borrow/markets/{network}/{marketId}` — detailed data for a single market, including rates, utilization, and collateral
  * `GET /beta/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](/api-reference/transactions).

* **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](https://www.vaults.fyi/).
* Redesigned side panel on vault detail pages.

***

## Week 17, 2026 — Apr 21–27

**API**

• Introduced`vaultId` — 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](/api-reference/nrt) (`/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](/api-reference/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`](/api-reference/general) 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](/api-reference/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](/api-reference/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.

<Note>
  **Migration required:** All `/experimental/` endpoints have been renamed to `/alpha/`. Update any integrations using `/experimental/` paths. See the [Alpha API reference](https://api.vaults.fyi/experimental/documentation/static/index.html).
</Note>

**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**](https://api.vaults.fyi/alpha/documentation/static/index.html#/NRT) (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**](https://api.vaults.fyi/experimental/documentation/static/index.html#/Cross%20Chain/get_alpha_transactions_intent_status) (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**](https://api.vaults.fyi/alpha/documentation/static/index.html#/Cross%20Chain) (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](https://api.vaults.fyi/experimental/documentation/static/index.html)**, 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.