{"uid":"cap_9XkaRNScrtuGBIyz5sAyJ","slug":"vaults-fyi-vault-list-api-70276499","name":"vaults.fyi Vault List API","description":"Retrieves a filtered list of vaults with their basic information including address, network, associated asset details, and transactional support status.","url":"https://api.vaults.fyi/v2/vaults","method":"GET","headers":{},"bodySchema":{"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","description":"Include only vaults that are supported in the transactional interface."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_g8d4K6Tp5xeQz1EuS3JUW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a filtered, paginated list of DeFi vaults with basic info including address, network, asset details, and transactional support status.","exampleAgentPrompt":"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?","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:41:25.220Z","isFirstParty":false}