# vaults.fyi Detailed Vaults List

> vaults.fyi Detailed Vaults List is a paid API for AI agents from api.vaults.fyi, paid per call via x402, $0.302/call, status unknown (last checked 2026-10-11).

Retrieves a paginated, filterable list of DeFi vaults with comprehensive performance metrics including APY, TVL, risk scores, rewards, and protocol details.

## Facts

- Endpoint: GET https://api.vaults.fyi/v2/detailed-vaults?utm_source=zero.xyz
- Price: $0.302/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vaults-fyi-detailed-vaults-list-911420f4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gexX1WS8Q3Q-6QvTfAPXH

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability vaults-fyi-detailed-vaults-list-911420f4
```

Example prompt: Show me the top 20 DeFi vaults on mainnet and Arbitrum with at least $500,000 TVL and minimum 4% APY, sorted by 7-day APY descending, only including USDC and ETH assets with a vault score of at least 70.

## When to prefer this

Use this endpoint when you need rich, detailed vault metadata including APY breakdowns, TVL, risk scores, and rewards — not just basic vault identifiers. Prefer this over the basic vaults endpoint when the agent needs to compare, rank, or filter vaults by performance metrics. Ideal for yield optimization, risk assessment, or DeFi portfolio construction workflows.

## Known failure modes

- Invalid network enum value returns 400 with validation error
- minApy greater than maxApy produces empty results or error
- perPage exceeding 5000 is rejected with schema validation error
- Requesting a page beyond available data returns empty results array
- Invalid asset symbol or curator name silently returns no matching vaults

## How this service works

Retrieves a comprehensive list of vaults with detailed performance metrics including APY, TVL, rewards, risk scores, and protocol information based on specified filters.

## Output

Returns a paginated list of vault objects each containing: vault address, network, protocol name, curator, associated assets, APY metrics (1-day, 7-day, 30-day), total value locked (TVL) in USD, risk/vault score, reward programs, and other detailed metadata. Supports up to 5,000 results per page.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "page": {
       "type": "integer",
       "default": 0,
       "minimum": 0,
       "description": "Page number (starting from 0)"
      },
      "tags": {
       "type": "array",
       "items": {
        "type": "string",
        "minLength": 1
       },
       "description": "Tags to be included."
      },
      "maxApy": {
       "type": "number",
       "description": "Maximum APY (in decimal) of the vaults to be included"
      },
      "maxTvl": {
       "type": "integer",
       "description": "Maximum TVL in USD of the vaults to be included"
      },
      "minApy": {
       "type": "number",
       "description": "Minimum APY (in decimal) of the vaults to be included"
      },
      "minTvl": {
       "type": "integer",
       "default": 100000,
       "minimum": 0,
       "description": "Minimum TVL in USD of the vaults to be included"
      },
      "sortBy": {
       "enum": [
        "tvl",
        "apy1day",
        "apy7day",
        "apy30day"
       ],
       "type": "string",
       "description": "Field to sort by"
      },
      "perPage": {
       "type": "integer",
       "default": 50,
       "maximum": 5000,
       "minimum": 0,
       "description": "Number of items per page",
       "exclusiveMinimum": true
      },
      "curators": {
       "type": "array",
       "items": {
        "type": "string",
        "minLength": 1
       },
       "description": "Curators to be included."
      },
      "sortOrder": {
       "enum": [
        "asc",
        "desc"
       ],
       "type": "string",
       "default": "asc",
       "description": "Sort order, either asc or desc. Ascending is default."
      },
      "allowedAssets": {
       "type": "array",
       "items": {
        "type": "string",
        "minLength": 1
       },
       "description": "Assets to be included by symbol(ticker)."
      },
      "minVaultScore": {
       "type": "number",
       "minimum": 0,
       "description
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vaults-fyi-detailed-vaults-list-911420f4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vaults.fyi](https://www.zero.xyz/host/api.vaults.fyi/llms.txt)