# Vaults.fyi > A single API to access market data, execute transactions, and track portfolios across 1,000+ DeFi yield strategies on 80+ protocols. Covers 20+ networks including Ethereum, Base, Arbitrum, Optimism, and Solana. For complete documentation with full page content, see [llms-full.txt](https://docs.vaults.fyi/llms-full.txt). ## Notes for LLM Agents - Use v2 endpoints for all production integrations. Alpha and beta endpoints may change without notice. - Authentication: include your API key as `x-api-key` header. Get access at https://portal.vaults.fyi. - Primary vault discovery endpoint: `GET /v2/detailed-vaults` — returns APY, TVL, risk scores, fees, and protocol details across all supported vaults. - For a single vault: `GET /v2/detailed-vaults/{network}/{address}`. - For user portfolio: `GET /v2/positions/{address}`, `GET /v2/idle-assets/{address}`, `GET /v2/best-vault/{address}`. - Transaction payloads are ready-to-sign — no intermediary contracts. Use `GET /v2/transactions/context/{network}/{address}/{vaultAddress}` then `GET /v2/transactions/{action}/{network}/{address}/{vaultAddress}`. - APY values are trailing averages computed from on-chain share prices. Always check whether rewards are included (`totalApy` vs `baseApy`). ## Getting Started - [Introduction](https://docs.vaults.fyi/introduction.md): What vaults.fyi is, who it's for, and what the API covers. - [API Overview](https://docs.vaults.fyi/api-reference/overview.md): V2 API structure, authentication, base URLs, rate limits, and versioning. - [Plans & Pricing](https://docs.vaults.fyi/plans/overview.md): Analyst, Growth, Builder, and Enterprise plans — credit allowances and rate limits. - [API Credits & Compute Units](https://docs.vaults.fyi/plans/credits.md): Per-endpoint cost table for all v2 endpoints. - [SDK Quickstart](https://docs.vaults.fyi/sdk/quickstart.md): Install the TypeScript or Python SDK and make your first call in under five minutes. ## Core Concepts - [Everything You Can Know About a Vault](https://docs.vaults.fyi/concepts/vault-data.md): Complete field reference — APY, TVL, fees, reputation scores, holders, historical time-series, near real-time metrics, and user positions. - [Market Data: APY, TVL, and Fees](https://docs.vaults.fyi/concepts/market-data.md): How standardized yield metrics work across 1,000+ vaults via hourly on-chain indexing. - [Portfolio Tracking](https://docs.vaults.fyi/concepts/portfolio.md): Track positions, detect idle assets, surface personalized deposit recommendations, and report PnL. - [Transaction Execution](https://docs.vaults.fyi/concepts/transactions.md): Non-custodial deposit, redeem, and claim payloads — no intermediary contracts. - [Supported Protocols & Networks](https://docs.vaults.fyi/concepts/supported-protocols.md): 80+ protocols on 20+ networks. Covers analytics-only vs. full transactional support tiers. ## Methodology - [How APY is Calculated](https://docs.vaults.fyi/methodology/calculating-apy.md): Trailing windows, TVL-weighted averages, reward token accounting, and edge cases. - [Benchmark Rates](https://docs.vaults.fyi/methodology/benchmark-rates.md): How USD and ETH benchmark rates are constructed from top vaults by TVL. - [Reputation Scores](https://docs.vaults.fyi/methodology/reputation-scores.md): Five-dimension risk scoring and how to use `minVaultScore` to filter programmatically. - [On-Chain Indexing](https://docs.vaults.fyi/methodology/indexing-onchain-data.md): How vaults.fyi reads share prices hourly via static smart contract calls. ## API Reference - [General](https://docs.vaults.fyi/api-reference/general.md): Vault discovery, assets, networks, protocols, curators, and tags. - [Detailed Vaults](https://docs.vaults.fyi/api-reference/detailed-vaults.md): Full vault data — APY breakdown, TVL, risk scores, fees, holder data, protocol details. - [Historical](https://docs.vaults.fyi/api-reference/historical.md): Time-series APY, TVL, share price, and asset price data for any vault. - [Benchmarks](https://docs.vaults.fyi/api-reference/benchmarks.md): USD and ETH benchmark APY rates with historical time-series. - [Portfolio](https://docs.vaults.fyi/api-reference/portfolio.md): User positions, idle assets, deposit recommendations, returns, and transaction history. - [Transactions](https://docs.vaults.fyi/api-reference/transactions.md): Ready-to-sign payloads for deposits, redemptions, reward claims, and context fetching. - [Near Real-Time](https://docs.vaults.fyi/api-reference/nrt.md): Sub-second share price, total assets, total supply, and underlying asset price. ## Use Cases - [Embed Yield in Wallets & Apps](https://docs.vaults.fyi/use-cases/for-wallets-and-apps.md): Add yield discovery, non-custodial deposits, and fee revenue to any wallet or consumer app. - [DeFi Yield Data for Analysts](https://docs.vaults.fyi/use-cases/for-analysts.md): Normalized APY, TVL, risk scores, and benchmark rates across 1,000+ vaults — no blockchain parsing. - [Get Your Vaults Discovered](https://docs.vaults.fyi/use-cases/for-protocols.md): List vaults on vaults.fyi to reach wallets, apps, and analysts. Monitor integration performance. ## SDK & Tutorials - [SDK Method Reference](https://docs.vaults.fyi/sdk/reference.md): Complete TypeScript and Python SDK method reference. - [Wallet Integration Tutorial](https://docs.vaults.fyi/sdk/tutorials/wallet-integration.md): Detect idle assets, surface deposit options, execute vault transactions, and track positions. - [Data Analytics Tutorial](https://docs.vaults.fyi/sdk/tutorials/data-analytics.md): Fetch vault data, retrieve historical APY and TVL, compare against benchmarks, build charts. ## AI Agents - [AI Agents Overview](https://docs.vaults.fyi/ai-agents/overview.md): Build agents that discover, evaluate, execute, and manage DeFi yield strategies via the API. - [MCP for Claude Desktop](https://docs.vaults.fyi/ai-agents/mcp-claude-desktop.md): Connect vaults.fyi to Claude Desktop to query live DeFi data and execute transactions. - [x402 Keyless Access](https://docs.vaults.fyi/ai-agents/x402.md): Pay-per-request access without an API key — pay in USDC on Base from your agent's wallet. ## Resources - [FAQ](https://docs.vaults.fyi/resources/faq.md): Yield calculation questions, data freshness, vault inclusion criteria, requesting new protocols. - [Case Studies](https://docs.vaults.fyi/resources/case-studies.md): How Jumper Earn, Kraken Wallet, Gauntlet, Maple Finance, Nashpoint, and Etherscan use the API. - [Changelog](https://docs.vaults.fyi/resources/changelog.md): Week-by-week log of all API and app updates. ## Optional - [Beta Endpoints](https://docs.vaults.fyi/api-reference/beta.md): Features in testing — Deep AMM (liquidity vaults) and Pendle fixed-term markets. More stable than alpha, may still change. - [Alpha Endpoints](https://docs.vaults.fyi/api-reference/alpha.md): Early access — Borrow (Aave/Morpho positions and transactions), Solana vaults (SVM), cross-chain intents, and vault holders. May change without notice. ## OpenAPI Specs - [v2 — stable](https://api.vaults.fyi/v2/documentation/json) - [beta — in testing](https://api.vaults.fyi/beta/documentation/json) - [alpha — early access](https://api.vaults.fyi/alpha/documentation/json)