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

# Yield & Market Data

> Query standardized APY, TVL, fees, the Reputation Score, and rewards across 1,000+ vaults via hourly onchain indexing — all from a single API.

The Vaults.fyi API gives you standardized market data for over 1,000 DeFi yield vaults across 80+ protocols and 20+ chains. Instead of building and maintaining one-off integrations per protocol, you get a single endpoint that returns consistent, comparable data for every supported vault.

Data is indexed onchain on an hourly basis, so you always have current metrics alongside the full historical record you need for backtesting and trend analysis.

## What data is available

Each vault object includes APY across four time windows, TVL in USD and native units, a fee breakdown, the Reputation Score with component scores, reward token rates, holder counts, capacity limits, and flags for active protocol notices — among other fields.

<Note>
  APY, TVL, fees, and the Reputation Score are computed consistently across all protocols. This means you can safely sort and compare vaults from different protocols side by side.
</Note>

For a complete field-by-field reference covering everything the API can tell you about a vault, see [Vault Discovery](/concepts/vault-discovery).

## Endpoints

<CardGroup cols={2}>
  <Card title="Vault discovery" icon="magnifying-glass" href="/api-reference/detailed-vaults">
    Filter and sort vaults by APY, TVL, protocol, network, asset, reputation score, and more.
  </Card>

  <Card title="Single vault detail" icon="circle-info" href="/api-reference/detailed-vaults">
    Full detail on a specific vault including current and historical APY, TVL, fees, rewards, and the Reputation Score.
  </Card>

  <Card title="Historical data" icon="chart-line" href="/api-reference/historical">
    Time-series APY, TVL, and asset price data over configurable date ranges and granularity.
  </Card>

  <Card title="Benchmarks" icon="gauge" href="/api-reference/benchmarks">
    USD and ETH benchmark rates aggregated across top vaults for performance comparison.
  </Card>
</CardGroup>

You can also query reference data — supported networks, tokens, and protocols — using `GET /v2/networks`, `GET /v2/tokens`, and `GET /v2/protocols`. These are useful for building filter dropdowns and validating user input.

## How data is sourced

Vaults.fyi indexes vault state directly from onchain contract calls, not from third-party price feeds or protocol-reported numbers. This approach means:

* **Hourly updates.** Vault metrics refresh every hour from onchain data.
* **Consistent methodology.** APY is calculated using the same formula across all protocols, so comparisons are meaningful.
* **Historical depth.** Time-series data is available for backtesting, charting, and reporting without you needing to store it yourself.

<Tip>
  Use the `apy7d` or `apy30d` fields rather than `apy` when you want to smooth out short-term volatility and show users a more stable yield estimate.
</Tip>

## Coverage

One integration gives you data across 1,000+ vaults, 80+ protocols, and 20+ chains. For the full list of supported protocols and networks, see [Supported Protocols and Networks](/concepts/supported-protocols).