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

# Beta

> Features in testing. More stable than Alpha, but may still change before general availability.

<Warning>
  Beta endpoints are functional and tested but not yet part of the stable API. Interfaces may change before general availability. Not recommended for production use without monitoring.
</Warning>

Beta features are accessible using your existing API key. The endpoints below cover product areas that are being validated before general availability.

## Solana vaults

Build Solana/SVM vault integrations alongside the EVM vault API surface. These endpoints cover Solana vault discovery, detailed vault data, wallet positions and events, idle assets, and ready-to-sign transaction construction.

| Capability                                                   | How to call                                                        | Required inputs                                                                                                                                                                                                                                                       |
| ------------------------------------------------------------ | ------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| List SVM vault identifiers                                   | `GET /beta/svm/vaults`                                             | None                                                                                                                                                                                                                                                                  |
| List SVM detailed vaults                                     | `GET /beta/svm/detailed-vaults`                                    | None. Optional query filters include `page`, `perPage`, `assetSymbol`, `allowedAssets`, `disallowedAssets`, `allowedProtocols`, `disallowedProtocols`, `allowedAssetMints`, `disallowedAssetMints`, `minTvl`, `maxTvl`, `minApy`, `maxApy`, `sortBy`, and `sortOrder` |
| Fetch one SVM detailed vault                                 | `GET /beta/svm/detailed-vaults/{vaultAddress}`                     | Path: `vaultAddress`                                                                                                                                                                                                                                                  |
| List SVM positions for a wallet                              | `GET /beta/svm/portfolio/positions/{userAddress}`                  | Path: `userAddress`                                                                                                                                                                                                                                                   |
| List SVM portfolio events for a wallet                       | `GET /beta/svm/portfolio/events/{userAddress}`                     | Path: `userAddress`                                                                                                                                                                                                                                                   |
| List SVM portfolio events for one vault                      | `GET /beta/svm/portfolio/events/{userAddress}/{vaultAddress}`      | Path: `userAddress`, `vaultAddress`                                                                                                                                                                                                                                   |
| List idle SVM assets for a wallet                            | `GET /beta/svm/portfolio/idle-assets/{userAddress}`                | Path: `userAddress`                                                                                                                                                                                                                                                   |
| Fetch one idle SVM asset                                     | `GET /beta/svm/portfolio/idle-assets/{userAddress}/{assetAddress}` | Path: `userAddress`, `assetAddress`                                                                                                                                                                                                                                   |
| Check balances and limits before building an SVM transaction | `GET /beta/svm/transactions/context/{userAddress}/{vaultAddress}`  | Path: `userAddress`, `vaultAddress`                                                                                                                                                                                                                                   |
| Build a ready-to-sign SVM transaction                        | `GET /beta/svm/transactions/{action}/{userAddress}/{vaultAddress}` | Path: `action`, `userAddress`, `vaultAddress`. Query: `assetAddress`, plus `amount` when the action requires an amount. Optional query: `simulate`                                                                                                                    |

SVM transaction responses return one or more actions with a Solana transaction object at `actions[].tx.transaction`. The value is a base64-encoded serialized Solana transaction ready for wallet signing. Passing `simulate=true` can add a `simulation` object with status plus token amounts expected to be spent or received.

## Borrow markets

Build borrow dashboards and account-health views against one borrow market model instead of wiring separate protocol-specific routes. Use these endpoints for market discovery, historical rates, user positions, user events, and ready-to-sign borrow transaction payloads.

| Capability                                                     | How to call                                                                                   | Required inputs                                                                                                                                                                                                         |
| -------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| List all borrow markets                                        | `GET /beta/borrow/markets/`                                                                   | None. Optional query filters include `page`, `perPage`, `allowedNetworks`, `disallowedNetworks`, `allowedCollateralAssets`, `disallowedCollateralAssets`, `allowedBorrowAssets`, `disallowedBorrowAssets`, and `minTvl` |
| List borrow markets on one network                             | `GET /beta/borrow/markets/{network}`                                                          | Path: `network`. Optional query filters include `page`, `perPage`, `allowedCollateralAssets`, `disallowedCollateralAssets`, `allowedBorrowAssets`, `disallowedBorrowAssets`, and `minTvl`                               |
| Fetch one borrow market                                        | `GET /beta/borrow/markets/{network}/{marketId}`                                               | Path: `network`, `marketId`                                                                                                                                                                                             |
| Fetch historical borrow market data                            | `GET /beta/borrow/markets/historical/{network}/{marketId}/{assetId}`                          | Path: `network`, `marketId`, `assetId`                                                                                                                                                                                  |
| List borrow positions for a wallet                             | `GET /beta/borrow/portfolio/positions/{userAddress}`                                          | Path: `userAddress`. Optional query: `allowedNetworks`, `disallowedNetworks`, `allowedAssets`, `disallowedAssets`, `minUsdAssetValueThreshold`, `sortBy`, `sortOrder`                                                   |
| Fetch one borrow market position                               | `GET /beta/borrow/portfolio/positions/{userAddress}/{network}/{marketId}`                     | Path: `userAddress`, `network`, `marketId`                                                                                                                                                                              |
| Fetch one asset-level borrow market position                   | `GET /beta/borrow/portfolio/positions/{userAddress}/{network}/{marketId}/{assetId}`           | Path: `userAddress`, `network`, `marketId`, `assetId`                                                                                                                                                                   |
| List borrow market events                                      | `GET /beta/borrow/portfolio/events/{userAddress}/{network}/{marketId}/{assetId}`              | Path: `userAddress`, `network`, `marketId`, `assetId`                                                                                                                                                                   |
| Check balances and limits before building a borrow transaction | `GET /beta/borrow/markets/transactions/context/{userAddress}/{network}/{marketId}/{assetId}`  | Path: `userAddress`, `network`, `marketId`, `assetId`                                                                                                                                                                   |
| Build a ready-to-sign borrow market transaction                | `GET /beta/borrow/markets/transactions/{action}/{userAddress}/{network}/{marketId}/{assetId}` | Path: `action`, `userAddress`, `network`, `marketId`, `assetId`. Query: `amount` or `all=true` when the action requires an amount                                                                                       |

Borrow market responses expose `assetsData[].marketAssetId`. Pass that value as `{assetId}` when chaining from market discovery into historical data, portfolio events, asset-level positions, or transaction endpoints.

## The Deep

Build AMM-style vault integrations for Deep liquidity positions. These endpoints cover vault discovery, wallet positions, and ready-to-sign deposit or withdrawal transactions.

| Capability                          | How to call                                                      | Required inputs                                                                                                          |
| ----------------------------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| List Deep detailed vaults           | `GET /beta/amm/deep/detailed-vaults`                             | None. Optional query: `page`, `perPage`                                                                                  |
| Fetch one Deep position             | `GET /beta/amm/deep/positions/{userAddress}/{network}/{vaultId}` | Path: `userAddress`, `network`, `vaultId`                                                                                |
| Build a Deep deposit transaction    | `GET /beta/amm/deep/deposit/{userAddress}/{network}/{vaultId}`   | Path: `userAddress`, `network`, `vaultId`. Query: `assetAddress0`, `amount0`. Optional query: `assetAddress1`, `amount1` |
| Build a Deep withdrawal transaction | `GET /beta/amm/deep/withdraw/{userAddress}/{network}/{vaultId}`  | Path: `userAddress`, `network`, `vaultId`. Query: `amount` or `all=true`                                                 |

## Fixed Term (Pendle)

Add fixed-term yield market support for Pendle-backed opportunities. Use these endpoints to retrieve detailed market data, preview transaction context, and generate swap-in or swap-out transactions.

| Capability                                                           | How to call                                                                    | Required inputs                                                                                                  |
| -------------------------------------------------------------------- | ------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
| Fetch fixed-term detailed vault data                                 | `GET /beta/fixed-term/detailed/{network}/{vaultId}`                            | Path: `network`, `vaultId`                                                                                       |
| Preview balances and limits before building a fixed-term transaction | `GET /beta/fixed-term/context/{userAddress}/{network}/{vaultId}`               | Path: `userAddress`, `network`, `vaultId`                                                                        |
| Build a fixed-term transaction                                       | `GET /beta/fixed-term/transactions/{action}/{userAddress}/{network}/{vaultId}` | Path: `action`, `userAddress`, `network`, `vaultId`. Query: `assetAddress`, `amount`. Optional query: `simulate` |

## Portfolio

Measure user returns over a selected time window instead of only showing lifetime returns. This supports performance reporting, account history views, and user-specific analytics.

| Capability                                       | How to call                                                             | Required inputs                                                                                  |
| ------------------------------------------------ | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| Measure user returns over a selected time window | `GET /beta/portfolio/partial-returns/{userAddress}/{network}/{vaultId}` | Path: `userAddress`, `network`, `vaultId`. Query: `fromTimestamp`. Optional query: `toTimestamp` |

Beta endpoints require an API key. [Sign up](https://portal.vaults.fyi/signup) to get started, then watch the [changelog](/resources/changelog) for changes before general availability.
