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

# Alpha

> Early access features. These endpoints may change without notice and are not covered by stability guarantees.

<Warning>
  Alpha endpoints are experimental and subject to breaking changes at any time. They are not included in the standard API changelog. Use them to explore upcoming features, not in production flows that require stability.
</Warning>

Alpha features are accessible using your existing API key. The endpoints below cover upcoming product areas that are still in active development.

## Cross-chain intents

Quote, execute, and track intent-based cross-chain position changes. This is the higher-level cross-chain transaction flow for products that want to move users into vault positions without building every bridge and execution step themselves.

| Capability                        | How to call                                | Required inputs                                                                     |
| --------------------------------- | ------------------------------------------ | ----------------------------------------------------------------------------------- |
| Create a transaction intent quote | `POST /alpha/transactions/intent/getQuote` | JSON body: `userAddress`, `inputPosition`, `outputPosition`, `feeToken`, `provider` |
| Execute a transaction intent      | `POST /alpha/transactions/intent/execute`  | JSON body: `payloadSignature`, `provider`. Optional body: `originalQuote`           |
| Check transaction intent status   | `GET /alpha/transactions/intent/status`    | Query: `crosschainTransactionId`, `provider`                                        |

## CCTP bridge

Build USDC bridge flows with transaction context, calldata generation, in-transit tracking, and bridge status checks.

| Capability                             | How to call                                                                                   | Required inputs                                                                                                                                                                                                             |
| -------------------------------------- | --------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Check CCTP balances and bridge context | `GET /alpha/transactions/cctp/context/{userAddress}/{srcNetwork}/{dstNetwork}/{assetAddress}` | Path: `userAddress`, `srcNetwork`, `dstNetwork`, `assetAddress`                                                                                                                                                             |
| Build a CCTP bridge transaction        | `GET /alpha/transactions/cctp/transactions/{action}/{userAddress}/{srcNetwork}/{dstNetwork}`  | Path: `action`, `userAddress`, `srcNetwork`, `dstNetwork`. Optional query includes `assetAddress`, `amount`, `recipientAddress`, `transferType`, `useForwarding`, `message`, and `attestation` depending on the bridge step |
| List CCTP transfers in transit         | `GET /alpha/transactions/cctp/money-in-transit/{userAddress}`                                 | Path: `userAddress`                                                                                                                                                                                                         |
| Check CCTP transfer status             | `GET /alpha/transactions/cctp/status`                                                         | Query: `burnTxHash`, `srcNetwork`                                                                                                                                                                                           |

## Advanced analytics

Request heavier per-vault analytics only when your product needs them, rather than paying the response-size and compute cost on every detailed-vault query.

| Capability                                                      | How to call                                          | Required inputs                                                                                                                                       |
| --------------------------------------------------------------- | ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| List advanced vault analytics using selected analytics sections | `POST /alpha/advanced-analytics`                     | JSON body: `select`. Optional query filters include `allowedNetworks`, `allowedAssets`, `allowedProtocols`, `minTvl`, `maxApy`, `page`, and `perPage` |
| Fetch advanced analytics for one vault                          | `POST /alpha/advanced-analytics/{network}/{vaultId}` | Path: `network`, `vaultId`. JSON body: `select`                                                                                                       |

## Historical flows

Inspect daily vault inflows and outflows for flow analytics, dashboards, and monitoring.

| Capability                                        | How to call                                             | Required inputs                                                                            |
| ------------------------------------------------- | ------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| Fetch historical daily vault inflows and outflows | `GET /alpha/historical/{network}/{vaultId}/daily-flows` | Path: `network`, `vaultId`. Query: `fromDate`, `toDate`. Optional query: `page`, `perPage` |

## Historical positions

Fetch a wallet's historical vault positions for account history, retention analytics, and portfolio timeline views.

| Capability                             | How to call                                     | Required inputs                                                     |
| -------------------------------------- | ----------------------------------------------- | ------------------------------------------------------------------- |
| List historical positions for a wallet | `GET /alpha/historical-positions/{userAddress}` | Path: `userAddress`. Optional query: `fromTimestamp`, `toTimestamp` |

## Historical balances

Reconstruct a wallet's vault balances at a specific point in time. This is useful for historical account snapshots, period reporting, retention analysis, and backtesting portfolio views against previous user exposure.

| Capability                             | How to call                                                | Required inputs                                                                                                                                                                                                                                                                                                                                                                                                                   |
| -------------------------------------- | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Fetch historical balances for a wallet | `GET /alpha/historical-balances/{userAddress}/{timestamp}` | Path: `userAddress`, `timestamp`. Optional query filters include `allowedNetworks`, `disallowedNetworks`, `allowedAssets`, `disallowedAssets`, `allowedProtocols`, `disallowedProtocols`, `minTvl`, `maxTvl`, `minApy`, `maxApy`, `minVaultScore`, `tags`, `curators`, `onlyTransactional`, `onlyAppFeatured`, `allowCorrupted`, `allowVaultsWithWarnings`, `minUsdAssetValueThreshold`, `apyInterval`, `sortBy`, and `sortOrder` |

## Holders

Analyze vault holders and LP-token balances for concentration, ownership, and distribution views.

| Capability                               | How to call                              | Required inputs                                               |
| ---------------------------------------- | ---------------------------------------- | ------------------------------------------------------------- |
| List vault holders and LP-token balances | `GET /alpha/{network}/{vaultId}/holders` | Path: `network`, `vaultId`. Optional query: `page`, `perPage` |

If you're interested in any of these areas, [sign up](https://portal.vaults.fyi/signup) to get an API key and start using Alpha endpoints. Existing customers can reach the team via [Telegram](https://t.me/vaultsfyisupport) or [email](mailto:support@wallfacer.io) to share feedback.
