Api Endpoint

vaults.fyi

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

Open interactive test console

Offering

Provider
api.vaults.fyi
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Financial Analysis
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://api.vaults.fyi/v2/vaults
MIME type
application/json
First seen
2026-10-16T01:50:03.310Z
Last seen
Tags
DeFi, vaults, yield, analytics, X402, Portfolio, on-chain

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.002 USDC
Atomic price: 2000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
0.002 USDC
Atomic price: 2000 · Network: eip155:8453 · Asset: USDC · Scheme: batch-settlement
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "2000",
    "payTo": "0x108BCd8a07C3fdfca3Aa500784A8573123a1029F"
  },
  {
    "scheme": "batch-settlement",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "2000",
    "payTo": "0x108BCd8a07C3fdfca3Aa500784A8573123a1029F"
  }
]

Observed health

Status
Healthy
Latest latency
113 ms
Average latency
347 ms
HTTP status
402
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "page": {
          "type": "integer",
          "minimum": 0,
          "default": 0,
          "description": "Page number (starting from 0)"
        },
        "perPage": {
          "type": "integer",
          "exclusiveMinimum": true,
          "minimum": 0,
          "maximum": 5000,
          "default": 50,
          "description": "Number of items per page"
        },
        "network": {
          "type": "string",
          "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"
          ],
          "description": "Include only vaults with provided network(name or CAIP)"
        },
        "assetSymbol": {
          "type": "string",
          "minLength": 1,
          "description": "Include only vaults with an asset of provided symbol(ticker)"
        },
        "onlyTransactional": {
          "type": "boolean",
          "description": "Include only vaults that are supported in the transactional interface."
        },
        "onlyAppFeatured": {
          "type": "boolean",
          "description": "Include only vaults that are featured in app.vaults.fyi"
        },
        "allowCorrupted": {
          "type": "boolean",
          "default": false,
          "description": "Allow inclusion of corrupted vaults."
        }
      },
      "additionalProperties": false
    },
    "headers": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      }
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "required": [
    "itemsOnPage",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "vaultId",
          "address",
          "name",
          "network",
          "asset",
          "isTransactional",
          "isAppFeatured"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Name of the vault"
          },
          "asset": {
            "type": "object",
            "required": [
              "address",
              "assetCaip",
              "name",
              "symbol",
              "decimals",
              "assetGroup"
            ],
            "properties": {
              "name": {
                "type": "string",
                "description": "Name of the asset"
              },
              "symbol": {
                "type": "string",
                "description": "Symbol of the asset"
              },
              "address": {
                "type": "string",
                "pattern": "^0x[a-fA-F0-9]{40}$",
                "description": "Address of the asset"
              },
              "decimals": {
                "type": "integer",
                "description": "Number of decimals of the asset"
              },
              "assetCaip": {
                "type": "string",
                "pattern": "^eip155:\\d+\\/(erc20:0x[0-9a-fA-F]{40}|slip44:\\d+)$",
                "description": "CAIP-2 of the asset"
              },
              "assetLogo": {
                "type": "string",
                "format": "uri",
                "description": "URL of the asset logo"
              },
              "assetGroup": {
                "type": "string",
                "description": "Group of the asset, e.g., ETH, USD, EURO, BTC, OTHER"
              },
              "assetPriceInUsd": {
                "type": "string",
                "description": "Price of the asset in USD"
              }
            },
            "description": "Asset details of the vault",
            "additionalProperties": false
          },
          "address": {
            "type": "string",
            "pattern": "^0x[a-fA-F0-9]{40}$",
            "description": "Address of the vault"
          },
          "network": {
            "type": "object",
            "required": [
              "name",
              "chainId",
              "networkCaip"
            ],
            "properties": {
              "name": {
                "enum": [
                  "mainnet",
                  "optimism",
                  "arbitrum",
                  "polygon",
                  "gnosis",
                  "base",
                  "unichain",
                  "swellchain",
                  "celo",
                  "worldchain",
                  "berachain",
                  "ink",
                  "bsc",
                  "hyperliquid",
                  "plasma",
                  "avalanche",
                  "katana",
                  "linea",
                  "mega-eth",
                  "monad",
                  "etherlink",
                  "robinhood"
                ],
                "type": "string",
                "description": "Name of the network"
              },
              "chainId": {
                "type": "integer",
                "description": "Chain ID of the network"
              },
              "networkCaip": {
                "type": "string",
                "pattern": "^eip155:\\d+$",
                "description": "CAIP-2 of the network"
              }
            },
            "description": "Network details of the vault",
            "additionalProperties": false
          },
          "vaultId": {
            "type": "string",
            "description": "Stable vault identity for API lookups and links"
          },
          "isAppFeatured": {
            "type": "boolean",
            "description": "Indicates if the vault is featured in app.vaults.fyi"
          },
          "isTransactional": {
            "type": "boolean",
            "description": "Indicates if the vault supports transactional endpoints"
          }
        },
        "description": "Array of items on the current page",
        "additionalProperties": false
      }
    },
    "nextPage": {
      "type": "integer",
      "description": "Next page number"
    },
    "itemsOnPage": {
      "type": "integer",
      "description": "Number of items on the current page"
    }
  },
  "additionalProperties": false
}