{"uid":"cap_gexX1WS8Q3Q-6QvTfAPXH","slug":"vaults-fyi-detailed-vaults-list-911420f4","name":"vaults.fyi Detailed Vaults List","description":"Retrieves a comprehensive list of vaults with detailed performance metrics including APY, TVL, rewards, risk scores, and protocol information based on specified filters.","url":"https://api.vaults.fyi/v2/detailed-vaults?utm_source=zero.xyz","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)"},"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":"Minimum vault score required for a vault to be included"},"allowCorrupted":{"type":"boolean","default":false,"description":"Allow inclusion of corrupted vaults."},"allowedNetworks":{"type":"array","items":{"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)"},"default":["base","mainnet","arbitrum","optimism"],"description":"Networks to be included (name or CAIP)."},"onlyAppFeatured":{"type":"boolean","description":"Include only vaults that are featured in app.vaults.fyi"},"allowedProtocols":{"type":"array","items":{"type":"string","minLength":1},"description":"Protocols to be included by protocol ID or name."},"disallowedAssets":{"type":"array","items":{"type":"string","minLength":1},"description":"Assets to be excluded by symbol(ticker). The parameter is ignored if \"allowedAssets\" is specified."},"onlyTransactional":{"type":"boolean","description":"Include only vaults that are supported in the transactional interface."},"disallowedNetworks":{"type":"array","items":{"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)"},"description":"Networks to be excluded (name or CAIP). The parameter is ignored if \"allowedNetworks\" is specified."},"disallowedProtocols":{"type":"array","items":{"type":"string","minLength":1},"description":"Protocols to be excluded by protocol ID or name. The parameter is ignored if \"allowedProtocols\" is specified."},"allowVaultsWithWarnings":{"type":"boolean","description":"Whether to include vaults with warnings. Defaults to true."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.302","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":{"p10Cents":"12.2000","medianCents":"12.2000","p90Cents":"12.2000","minCents":"12.2000","maxCents":"12.2000","p95Cents":"12.2000","sampleCount":1,"varies":false,"failureChargeRate":1},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.302/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.302","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.302","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UpfW23VDXJNnP-mLmrtEV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.302","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a paginated, filterable list of DeFi vaults with comprehensive performance metrics including APY, TVL, risk scores, rewards, and protocol details.","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:42:16.166Z","isFirstParty":false,"canonicalSlug":"vaults-fyi-detailed-vaults-list-911420f4"}