# vaults.fyi Vault List API

> vaults.fyi Vault List API is a paid API for AI agents from api.vaults.fyi, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Retrieves a filtered, paginated list of DeFi vaults with basic info including address, network, asset details, and transactional support status.

## Facts

- Endpoint: GET https://api.vaults.fyi/v2/vaults
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vaults-fyi-vault-list-api-70276499
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9XkaRNScrtuGBIyz5sAyJ

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-vault-list-api-70276499
```

Example prompt: Can you pull the first 50 USDC vaults available on Base from vaults.fyi, but only show me the ones that are supported in the transactional interface?

## When to prefer this

Use this endpoint when you need to discover, filter, or browse DeFi yield vaults across multiple blockchain networks available on vaults.fyi. Prefer this over alternatives when you need to filter by specific network (e.g. Base, Arbitrum, Optimism) or asset symbol, or when you want only featured or transactional vaults. This is a HEAD method returning metadata/headers rather than a full JSON body — useful for checking vault availability and counts without downloading full payloads.

## Known failure modes

- Invalid network enum value returns 400 error
- perPage exceeding 5000 returns validation error
- Unknown assetSymbol returns empty list rather than error
- Payment required (402) if x402 payment header is missing or insufficient
- Rate limiting if too many requests are made without payment

## How this service works

Retrieves a filtered list of vaults with their basic information including address, network, associated asset details, and transactional support status.

## Output

A paginated list of DeFi vaults matching the filter criteria, each including vault address, associated network, asset symbol and details, and whether the vault supports transactional operations. Response headers indicate pagination and total count.

## 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)"
      },
      "network": {
       "enum": [
        "mainnet",
        "optimism",
        "arbitrum",
        "polygon",
        "gnosis",
        "base",
        "unichain",
        "swellchain",
        "celo",
        "worldchain",
        "berachain",
        "ink",
        "bsc",
        "hyperliquid",
        "plasma",
        "avalanche",
        "katana",
        "linea",
        "mega-eth",
        "monad",
        "etherlink",
        "robinhood",
        "eip155:1",
        "eip155:10",
        "eip155:42161",
        "eip155:137",
        "eip155:100",
        "eip155:8453",
        "eip155:130",
        "eip155:1923",
        "eip155:42220",
        "eip155:480",
        "eip155:80094",
        "eip155:57073",
        "eip155:56",
        "eip155:999",
        "eip155:9745",
        "eip155:43114",
        "eip155:747474",
        "eip155:59144",
        "eip155:4326",
        "eip155:143",
        "eip155:42793",
        "eip155:4663"
       ],
       "type": "string",
       "description": "Include only vaults with provided network(name or CAIP)"
      },
      "perPage": {
       "type": "integer",
       "default": 50,
       "maximum": 5000,
       "minimum": 0,
       "description": "Number of items per page",
       "exclusiveMinimum": true
      },
      "assetSymbol": {
       "type": "string",
       "minLength": 1,
       "description": "Include only vaults with an asset of provided symbol(ticker)"
      },
      "allowCorrupted": {
       "type": "boolean",
       "default": false,
       "description": "Allow inclusion of corrupted vaults."
      },
      "onlyAppFeatured": {
       "type": "boolean",
       "description": "Include only vaults that are featured in app.vaults.fyi"
      },
      "onlyTransactional": {
       "type": "boolean",
       "descrip
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vaults-fyi-vault-list-api-70276499/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)