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

# Why use Vaults.fyi?

> Use one API for DeFi earn and borrow data, risk context, transaction preparation, portfolio tracking, TVL attribution, fees, and agent workflows.

Vaults.fyi is the API layer for onchain earn and borrow features. Use one integration to discover vaults, compare risk/return, prepare non-custodial transactions, track portfolios, measure attributed TVL, and support borrow workflows across 1,000+ strategies, 80+ protocols, and 20+ chains.

Use Vaults.fyi when your product needs to do more than show APYs: decide which vaults and markets are eligible, explain why they matter, route users into deposits, withdrawals, borrows, or repayments, and report what happened after capital moved.

## What Vaults.fyi replaces

<CardGroup cols={2}>
  <Card title="Custom protocol integrations" icon="code">
    Query one schema instead of maintaining custom adapters, transaction builders, and data pipelines for every protocol.
  </Card>

  <Card title="Inconsistent yield data" icon="chart-line">
    Compare APY, TVL, fees, rewards, capacity, and vault metadata using a normalized methodology across protocols and chains.
  </Card>

  <Card title="Manual risk screening" icon="shield-check">
    Use reputation scores, warnings, flags, holder data, curator metadata, and benchmark context before surfacing a vault.
  </Card>

  <Card title="Post-deposit blind spots" icon="wallet">
    Track positions, returns, reward balances, borrow activity, history, idle assets, and attributed TVL after users take action.
  </Card>
</CardGroup>

## Who it's for

<Tabs>
  <Tab title="Consumer platforms">
    Add earn and borrow features to wallets, exchanges, neobanks, fintech apps, portfolio tools, and aggregators that already hold user balances or wallet context.

    * Turn idle balances and wallet context into relevant earn and borrow options.
    * Generate revenue through configurable fees on earn and borrow flows when they fit your product and partner model.
    * Curate the right options with current and historical APY, TVL, protocol details, rewards, fees, capacity, and risk/return context.
    * Let users deposit, withdraw, claim rewards, borrow, and repay from your app without taking custody.
    * Keep users informed after deposit or borrow actions by showing positions, returns, rewards, borrow activity, and history.
    * Understand which products, partners, and integrations drive retained TVL and repeat activity.

    [See the wallets and apps guide](/use-cases/for-wallets-and-apps).
  </Tab>

  <Tab title="Analysts and data teams">
    Use clean DeFi yield data without building an indexing stack.

    * Query standardized APY, TVL, fees, rewards, and vault metadata across the market.
    * Separate base yield from reward APY across 1-hour, 1-day, 7-day, and 30-day windows.
    * Pull historical APY, TVL, and share-price data for analysis, dashboards, and reporting.
    * Compare vaults against USD and ETH benchmark rates.
    * Filter by reputation score, warnings, asset, network, protocol, curator, TVL, or capacity.

    [See the analysts guide](/use-cases/for-analysts).
  </Tab>

  <Tab title="Protocols and curators">
    Help wallets, apps, analysts, and agents understand your vaults without every partner rebuilding your metadata, yield, risk, and attribution stack.

    * Surface vaults through API integrations used by wallets, apps, and dashboards.
    * Provide standardized vault metadata, APY, TVL, fees, rewards, and risk context to integrators.
    * Track attributed deposits, withdrawals, and retained TVL from partner surfaces.
    * Show performance against market benchmarks.
    * Give partners the data they need to explain the vault before a user deposits.

    [See the protocols guide](/use-cases/for-protocols).
  </Tab>

  <Tab title="AI agents">
    Give agents a structured yield toolset instead of fragmented protocol-specific integrations.

    * Discover vaults and compare risk/return with structured filters.
    * Fetch vault detail, history, benchmarks, portfolio state, and transaction context.
    * Prepare transaction payloads for user approval.
    * Use the hosted MCP server for tool-based workflows.
    * Use x402 for keyless, pay-per-request access.

    [See the AI and agents guide](/ai-agents/overview).
  </Tab>
</Tabs>

## Core capabilities

| Capability           | What you get                                                                                                                                                                                                                                         |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Market data          | APY, TVL, fees, rewards, capacity, assets, protocols, curators, networks, and vault metadata.                                                                                                                                                        |
| Risk/return context  | Reputation scores, component scores, warnings, flags, holder data, benchmarks, and historical context.                                                                                                                                               |
| Borrowing            | Borrow markets, supplied and borrowed positions, risk metrics, and supported supply, withdraw, borrow, and repay actions.                                                                                                                            |
| Transactions         | Ready-to-sign payloads for deposits, redemptions, withdrawals, reward claims, and supported borrow actions with no Vaults.fyi wrapper contract.                                                                                                      |
| Portfolio            | Wallet-level positions, returns, history, idle assets, deposit options, and borrow activity.                                                                                                                                                         |
| Attribution and fees | Partner-level tracking and configurable fees for earn and borrow flows, including deposits, withdrawals, retained TVL, vaults, protocols, curators, networks, and assets. Use them for reporting, rebates, fee programs, and commercial discussions. |
| Agent access         | Hosted MCP server and x402 access for autonomous workflows.                                                                                                                                                                                          |

## Start small, then scale

Start with API key access and the SDKs for a single workflow, or use x402 pay-per-request access for keyless agent workflows. Teams can move from a small data integration to transactions, portfolio tracking, borrowing, fees, and attribution without changing providers.

For products that route deposits or borrow actions, attribution provides a shared record of retained TVL and user flows by vault, protocol, curator, network, and asset. Use it for partner reporting, rebate programs, fee programs, and commercial discussions without adding custody or wrapper contracts.

## Trusted integrations

Teams including [Arbitrum Earn](/resources/case-studies/arbitrum), [Jumper Earn](/resources/case-studies/jumper-earn), [Kraken Wallet](/resources/case-studies/kraken-wallet), [Gauntlet](/resources/case-studies/gauntlet), [Maple Finance](/resources/case-studies/maple-finance), and [KPK](/resources/case-studies/kpk) use Vaults.fyi for yield analytics, dashboards, transaction flows, and portfolio infrastructure.

<CardGroup cols={2}>
  <Card title="Start with the API" icon="code" href="/api-reference/overview">
    Review the endpoint groups for vault data, transactions, portfolios, benchmarks, and near real-time state.
  </Card>

  <Card title="Use the SDK" icon="rocket" href="/sdk/quickstart">
    Install the TypeScript or Python SDK and make your first request in minutes.
  </Card>
</CardGroup>
