Cursor to pass as the cursor parameter to fetch the next page. Absent when there are no more results.
Example:
"eyJpZCI6MTAwfQ"
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"LI.FI","description":"Get the best price execution for any swaps and bridging across EVM chains, Solana, Bitcoin and alt-VMs. Enable trading across all DEX aggregators, bridges, and intent-systems and save hundreds of developer hours.","colors":{"primary":"#5C67FF","light":"#fab6f4","dark":"#5C67FF"},"logo":{"light":"https://mintcdn.com/lifi/EmProAEgMrruLUbI/logo/light.png?fit=max\u0026auto=format\u0026n=EmProAEgMrruLUbI\u0026q=85\u0026s=f435348680e682acea6e3b9af339ed7a","dark":"https://mintcdn.com/lifi/EmProAEgMrruLUbI/logo/dark.png?fit=max\u0026auto=format\u0026n=EmProAEgMrruLUbI\u0026q=85\u0026s=d02539147db168291d7c711beb45d10b"},"favicon":"https://mintcdn.com/lifi/jEGN0oG6bNsdv0a3/logo/favicon.svg?fit=max\u0026auto=format\u0026n=jEGN0oG6bNsdv0a3\u0026q=85\u0026s=35fb6353ca8815e24daf1025135fef38","api":{"openapi":"openapi.yaml"},"appearance":{"default":"dark"},"background":{"color":{"light":"#FAFAFF","dark":"#000B29"}},"navbar":{"links":[{"href":"https://lifihelp.zendesk.com/hc/en-us","label":"Support"}],"primary":{"type":"button","label":"Get Started","href":"https://portal.li.fi/signup"}},"footer":{"socials":{"x":"https://x.com/lifiprotocol","github":"https://github.com/lifinance","website":"https://li.fi/"},"links":[{"header":"Company","items":[{"label":"Careers","href":"https://li.fi/careers"},{"label":"Brand Assets","href":"https://li.fi/brand-assets"},{"label":"About","href":"https://li.fi/"}]},{"header":"Tools","items":[{"label":"LI.FI Explorer","href":"https://explorer.li.fi/?utm_source=lifi\u0026utm_medium=footer_link_tools\u0026utm_campaign=lifi_to_explorer"}]},{"header":"Legal","items":[{"label":"Privacy Policy","href":"https://li.fi/legal/privacy-policy"},{"label":"Terms of Service","href":"https://li.fi/legal/terms-and-conditions"},{"label":"Imprint","href":"https://li.fi/legal/imprint"}]}]},"styling":{"eyebrows":"section","codeblocks":"system","latex":false},"integrations":{"ga4":{"measurementId":"G-NTE1P73M4Q"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"languages":[{"language":"en","href":"introduction/introduction"},{"language":"zh-Hans","href":"zh-Hans/introduction/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"lifi","hasAudioNarration":false,"actualSubdomain":"lifi","customDomains":["docs.li.fi"],"gitSource":{"type":"github","owner":"lifinance","repo":"public-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae4467b6255dab49421940b","collectionId":"fe96f741-47cb-43b3-b1b9-c7bfc174e641","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae4467b6255dab49421940b"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae4467b6255dab49421940b","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"en","tag":"Overview","count":48},{"language":"en","tag":"Composer","count":46},{"language":"zh-Hans","tag":"Composer","count":46},{"language":"zh-Hans","tag":"概述","count":44},{"language":"en","tag":"API Reference","count":34},{"language":"en","tag":"Intents \u0026 Solvers","count":32},{"language":"zh-Hans","tag":"意图与求解器","count":32},{"language":"en","tag":"Integrate via Composer API","count":30},{"language":"zh-Hans","tag":"通过 Composer API 集成","count":30},{"language":"zh-Hans","tag":"API 参考","count":29},{"language":"en","tag":"Reference","count":23},{"language":"en","tag":"For Agents","count":21},{"language":"en","tag":"Widget","count":20},{"language":"zh-Hans","tag":"Widget","count":20},{"language":"zh-Hans","tag":"参考文档","count":19},{"language":"en","tag":"Getting Started","count":16},{"language":"en","tag":"General API","count":16},{"language":"zh-Hans","tag":"通用 API","count":16},{"language":"zh-Hans","tag":"企业级功能","count":15},{"language":"zh-Hans","tag":"入门","count":14}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/earn-vaults/list-vaults-with-optional-filtering","slug":"/api-reference/earn-vaults/list-vaults-with-optional-filtering","pageMetadata":{"title":"List vaults with optional filtering","description":"Returns a paginated list of vaults with optional filtering and sorting.","deprecated":null,"version":null,"openapi":"/earn-openapi.yaml get /v1/vaults","href":"/api-reference/earn-vaults/list-vaults-with-optional-filtering","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Returns a paginated list of vaults with optional filtering and sorting.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"List vaults with optional filtering","description":"Returns a paginated list of vaults with optional filtering and sorting.","deprecated":null,"version":null,"openapi":"/earn-openapi.yaml get /v1/vaults","href":"/api-reference/earn-vaults/list-vaults-with-optional-filtering","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/lifi/951d8dd0c2dbce84/plausible.js","/_mintlify/custom/lifi/8e3c41579c236ea7/scripts/translate-docs.js","/_mintlify/custom/lifi/b34903975490ec23/scripts/generate-md-redirects.js","/_mintlify/custom/lifi/516472b23ab068ad/scripts/check-links.js","/_mintlify/custom/lifi/70364f7a7384bb43/scripts/markdown-chunker.js","/_mintlify/custom/lifi/6c99617851837b30/scripts/translation-config.js","/_mintlify/custom/lifi/8f88293865b45873/scripts/verify-translation-coverage.js"],"openApiReferenceData":{"operation":{"operationId":"VaultsController_listVaults_v1","summary":"List vaults with optional filtering","description":"Returns a paginated list of vaults with optional filtering and sorting.","tags":["Earn Vaults"],"parameters":["6a35624b-5f5a-48a3-90b1-7e8ce4b13884","82ffaf12-9249-4b4b-b557-b7be62aab0ad","19add022-95f4-4d6b-80b8-7cd177eb0fd8","b247fb6e-cad4-4bd4-92d1-0909135bd277","4ddd79a4-ac9b-4c39-9337-d7eae2062492","1c735366-a973-42b6-a899-0eb8e5386465","9c265857-fd01-4d4e-9253-d34cbb0581ed","7c379f2d-874b-4863-bae6-23f7e4bcf7e4","3f22d712-9dab-4331-b8d6-9a3db1e604ff","fb42a9e8-a4b9-44a0-9a7f-a1217b15f89c"],"responses":{"200":"2556f081-3224-4f2d-9c94-91b63c735775","400":"e125001a-0542-48b5-9f9c-ba1309c38fa4"},"method":"get","type":"path","servers":["0285defb-9487-4b01-974e-b9eb8019d542"],"security":["6e4bb3ee-0076-493b-ad3d-8546617c52af"],"path":"/v1/vaults","baseUrlOptions":["https://earn.li.fi"],"title":"List vaults with optional filtering","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"6a35624b-5f5a-48a3-90b1-7e8ce4b13884":{"name":"chainId","required":false,"in":"query","description":"Filter by EVM chain ID (e.g., `8453` for Base, `1` for Ethereum).","example":8453,"schema":{"type":"integer","minimum":1,"maximum":2147483647,"isRequired":false,"description":"Filter by EVM chain ID (e.g., `8453` for Base, `1` for Ethereum).","uniqueKey":"","typeLabel":"integer"}},"82ffaf12-9249-4b4b-b557-b7be62aab0ad":{"name":"asset","required":false,"in":"query","description":"Filter by underlying token symbol or address (e.g., `USDC`).","example":"USDC","schema":{"type":"string","minLength":1,"isRequired":false,"description":"Filter by underlying token symbol or address (e.g., `USDC`).","uniqueKey":"","typeLabel":"string"}},"19add022-95f4-4d6b-80b8-7cd177eb0fd8":{"name":"protocol","required":false,"in":"query","description":"Filter by protocol name (e.g., `morpho-v1`, `aave-v3`).","example":"morpho-v1","schema":{"type":"string","minLength":1,"isRequired":false,"description":"Filter by protocol name (e.g., `morpho-v1`, `aave-v3`).","uniqueKey":"","typeLabel":"string"}},"b247fb6e-cad4-4bd4-92d1-0909135bd277":{"name":"minTvlUsd","required":false,"in":"query","description":"Minimum TVL in USD. Use this to filter out low-liquidity vaults (e.g., `1000000` for $1M+).","example":100000,"schema":{"type":"number","minimum":0,"isRequired":false,"description":"Minimum TVL in USD. Use this to filter out low-liquidity vaults (e.g., `1000000` for $1M+).","uniqueKey":"","typeLabel":"number"}},"4ddd79a4-ac9b-4c39-9337-d7eae2062492":{"name":"isTransactional","required":false,"in":"query","description":"Filter by whether the vault supports programmatic deposits and withdrawals via the Composer API. Pass `true` to return only transactional vaults.","example":"true","schema":{"type":"string","enum":["true","false"],"isRequired":false,"description":"Filter by whether the vault supports programmatic deposits and withdrawals via the Composer API. Pass `true` to return only transactional vaults.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"1c735366-a973-42b6-a899-0eb8e5386465":{"name":"isRedeemable","required":false,"in":"query","description":"Filter by whether the vault currently supports redemptions (withdrawals). Pass `true` to return only vaults that can be redeemed.","example":"true","schema":{"type":"string","enum":["true","false"],"isRequired":false,"description":"Filter by whether the vault currently supports redemptions (withdrawals). Pass `true` to return only vaults that can be redeemed.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"9c265857-fd01-4d4e-9253-d34cbb0581ed":{"name":"isComposerSupported","required":false,"in":"query","description":"Filter by whether the vault is fully supported by the LI.FI Composer. Pass `true` to return only vaults ready for end-to-end cross-chain deposit flows.","example":"true","schema":{"type":"string","enum":["true","false"],"isRequired":false,"description":"Filter by whether the vault is fully supported by the LI.FI Composer. Pass `true` to return only vaults ready for end-to-end cross-chain deposit flows.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"7c379f2d-874b-4863-bae6-23f7e4bcf7e4":{"name":"sortBy","required":false,"in":"query","description":"Sort order for results. `apy` sorts by highest total APY first. `tvl` sorts by highest TVL first.","example":"apy","schema":{"type":"string","enum":["apy","tvl"],"isRequired":false,"description":"Sort order for results. `apy` sorts by highest total APY first. `tvl` sorts by highest TVL first.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"3f22d712-9dab-4331-b8d6-9a3db1e604ff":{"name":"cursor","required":false,"in":"query","description":"Pagination cursor from a previous response's `nextCursor` field. Omit to start from the beginning.","example":"eyJpZCI6MTAwfQ","schema":{"type":"string","minLength":1,"isRequired":false,"description":"Pagination cursor from a previous response's `nextCursor` field. Omit to start from the beginning.","uniqueKey":"","typeLabel":"string"}},"fb42a9e8-a4b9-44a0-9a7f-a1217b15f89c":{"name":"limit","required":false,"in":"query","description":"Number of results per page. Defaults to `50`.","example":10,"schema":{"type":"integer","minimum":1,"maximum":100,"isRequired":false,"description":"Number of results per page. Defaults to `50`.","uniqueKey":"","typeLabel":"integer"}}},"responses":{"2556f081-3224-4f2d-9c94-91b63c735775":{"description":"Paginated vault list","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","total"],"properties":{"data":{"type":"array","description":"Array of vault objects matching the filters.","items":{"type":"object","additionalProperties":false,"required":["address","network","chainId","slug","name","protocol","underlyingTokens","lpTokens","tags","analytics","syncedAt","isTransactional","isRedeemable","depositPacks","redeemPacks"],"properties":{"address":{"type":"string","description":"Vault contract address (0x-prefixed, 40 hex characters).","example":"0x7BfA7C4f149E7415b73bdeDfe609237e29CBF34A","isRequired":true,"uniqueKey":"data.items.[INDEX].address","typeLabel":"string"},"network":{"type":"string","description":"Network name as a lowercase string (e.g., `base`, `ethereum`).","example":"base","isRequired":true,"uniqueKey":"data.items.[INDEX].network","typeLabel":"string"},"chainId":{"type":"integer","description":"EVM chain ID of the network the vault is deployed on.","example":8453,"minimum":-9007199254740991,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"data.items.[INDEX].chainId","typeLabel":"integer"},"slug":{"type":"string","description":"URL-safe unique identifier for the vault, combining protocol, network, asset, and a short address suffix.","example":"morpho-base-usdc-0x7bfa","isRequired":true,"uniqueKey":"data.items.[INDEX].slug","typeLabel":"string"},"name":{"type":"string","description":"Human-readable display name for the vault.","example":"Morpho USDC Vault","isRequired":true,"uniqueKey":"data.items.[INDEX].name","typeLabel":"string"},"protocol":{"type":"object","description":"The DeFi protocol that operates this vault.","additionalProperties":false,"required":["name","url"],"properties":{"name":{"type":"string","description":"Protocol display name.","example":"Morpho","isRequired":true,"uniqueKey":"data.items.[INDEX].protocol.name","typeLabel":"string"},"url":{"type":"string","description":"Protocol website URL.","example":"https://morpho.org","isRequired":true,"uniqueKey":"data.items.[INDEX].protocol.url","typeLabel":"string"},"logoUri":{"type":"string","description":"URL to the protocol's logo image.","example":"https://example.com/morpho-logo.png","uniqueKey":"data.items.[INDEX].protocol.logoUri","typeLabel":"string"}},"isRequired":true,"uniqueKey":"data.items.[INDEX].protocol","typeLabel":"object"},"underlyingTokens":{"type":"array","description":"The tokens you deposit into this vault.","items":{"type":"object","additionalProperties":false,"required":["address","symbol","decimals"],"properties":{"address":{"type":"string","description":"Token contract address.","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","isRequired":true,"uniqueKey":"data.items.[INDEX].underlyingTokens.items.[INDEX].address","typeLabel":"string"},"symbol":{"type":"string","description":"Token symbol.","example":"USDC","isRequired":true,"uniqueKey":"data.items.[INDEX].underlyingTokens.items.[INDEX].symbol","typeLabel":"string"},"decimals":{"type":"integer","description":"Number of decimal places for the token.","example":6,"minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"data.items.[INDEX].underlyingTokens.items.[INDEX].decimals","typeLabel":"integer"},"weight":{"type":"number","description":"Token weight in the pool, expressed as a fraction between 0 and 1. Only relevant for multi-asset vaults.","example":1,"uniqueKey":"data.items.[INDEX].underlyingTokens.items.[INDEX].weight","typeLabel":"number"}},"uniqueKey":"data.items.[INDEX].underlyingTokens.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.items.[INDEX].underlyingTokens","typeLabel":"object[]"},"lpTokens":{"type":"array","description":"LP (liquidity provider) tokens received when depositing into the vault.","items":{"type":"object","additionalProperties":false,"required":["address","symbol","decimals"],"properties":{"address":{"type":"string","description":"LP token contract address.","example":"0x7BfA7C4f149E7415b73bdeDfe609237e29CBF34A","isRequired":true,"uniqueKey":"data.items.[INDEX].lpTokens.items.[INDEX].address","typeLabel":"string"},"symbol":{"type":"string","description":"LP token symbol.","example":"mUSDC","isRequired":true,"uniqueKey":"data.items.[INDEX].lpTokens.items.[INDEX].symbol","typeLabel":"string"},"decimals":{"type":"integer","description":"Number of decimal places for the LP token.","example":18,"minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"data.items.[INDEX].lpTokens.items.[INDEX].decimals","typeLabel":"integer"},"priceUsd":{"type":"string","description":"Current LP token price in USD, as a decimal string.","example":"1.02","uniqueKey":"data.items.[INDEX].lpTokens.items.[INDEX].priceUsd","typeLabel":"string"}},"uniqueKey":"data.items.[INDEX].lpTokens.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.items.[INDEX].lpTokens","typeLabel":"object[]"},"tags":{"type":"array","description":"Descriptive labels for filtering and categorisation (e.g., `stablecoin`, `lending`, `yield`).","items":{"type":"string","uniqueKey":"data.items.[INDEX].tags.items.[INDEX]","typeLabel":"string"},"example":["stablecoin","lending"],"isRequired":true,"uniqueKey":"data.items.[INDEX].tags","typeLabel":"string[]"},"analytics":{"type":"object","description":"Real-time yield and TVL analytics for the vault.","additionalProperties":false,"required":["apy","apy1d","apy7d","apy30d","tvl","updatedAt"],"properties":{"apy":{"type":"object","description":"Current APY breakdown.","additionalProperties":false,"required":["base","reward","total"],"properties":{"base":{"oneOf":[{"type":"number","description":"Base APY from lending fees and protocol yield, expressed as a decimal (e.g., `0.0534` = 5.34%). Null if unavailable.","example":0.0534,"isRequired":true,"uniqueKey":"data.items.[INDEX].analytics.apy.base.oneOf.0","typeLabel":"number"},{"type":"null","description":"Base APY from lending fees and protocol yield, expressed as a decimal (e.g., `0.0534` = 5.34%). Null if unavailable.","example":0.0534,"isRequired":true,"uniqueKey":"data.items.[INDEX].analytics.apy.base.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].analytics.apy.base","typeLabel":"number | null"},"reward":{"oneOf":[{"type":"number","description":"Additional APY from token incentives, expressed as a decimal. Null if no rewards.","example":null,"isRequired":true,"uniqueKey":"data.items.[INDEX].analytics.apy.reward.oneOf.0","typeLabel":"number"},{"type":"null","description":"Additional APY from token incentives, expressed as a decimal. Null if no rewards.","example":null,"isRequired":true,"uniqueKey":"data.items.[INDEX].analytics.apy.reward.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].analytics.apy.reward","typeLabel":"number | null"},"total":{"type":"number","description":"Total APY (base + reward), expressed as a decimal.","example":0.0534,"isRequired":true,"uniqueKey":"data.items.[INDEX].analytics.apy.total","typeLabel":"number"}},"isRequired":true,"uniqueKey":"data.items.[INDEX].analytics.apy","typeLabel":"object"},"apy1d":{"oneOf":[{"type":"number","description":"1-day trailing APY, expressed as a decimal. Null if insufficient data.","example":0.0521,"isRequired":true,"uniqueKey":"data.items.[INDEX].analytics.apy1d.oneOf.0","typeLabel":"number"},{"type":"null","description":"1-day trailing APY, expressed as a decimal. Null if insufficient data.","example":0.0521,"isRequired":true,"uniqueKey":"data.items.[INDEX].analytics.apy1d.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].analytics.apy1d","typeLabel":"number | null"},"apy7d":{"oneOf":[{"type":"number","description":"7-day trailing APY, expressed as a decimal. Null if insufficient data.","example":0.0538,"isRequired":true,"uniqueKey":"data.items.[INDEX].analytics.apy7d.oneOf.0","typeLabel":"number"},{"type":"null","description":"7-day trailing APY, expressed as a decimal. Null if insufficient data.","example":0.0538,"isRequired":true,"uniqueKey":"data.items.[INDEX].analytics.apy7d.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].analytics.apy7d","typeLabel":"number | null"},"apy30d":{"type":"number","description":"30-day trailing APY, expressed as a decimal.","example":0.0545,"isRequired":true,"uniqueKey":"data.items.[INDEX].analytics.apy30d","typeLabel":"number"},"tvl":{"type":"object","description":"Total value locked in the vault.","additionalProperties":false,"required":["usd"],"properties":{"usd":{"type":"string","description":"TVL denominated in USD, as a decimal string.","example":"12500000.00","isRequired":true,"uniqueKey":"data.items.[INDEX].analytics.tvl.usd","typeLabel":"string"},"native":{"type":"string","description":"TVL denominated in the vault's native token units, as a string.","example":"12500000000000","uniqueKey":"data.items.[INDEX].analytics.tvl.native","typeLabel":"string"}},"isRequired":true,"uniqueKey":"data.items.[INDEX].analytics.tvl","typeLabel":"object"},"updatedAt":{"type":"string","format":"date-time","description":"ISO 8601 timestamp of when analytics were last updated.","example":"2026-03-31T14:30:00.000Z","isRequired":true,"uniqueKey":"data.items.[INDEX].analytics.updatedAt","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"data.items.[INDEX].analytics","typeLabel":"object"},"syncedAt":{"type":"string","format":"date-time","description":"ISO 8601 timestamp of when vault data was last synced from the provider.","example":"2026-03-31T14:30:00.000Z","isRequired":true,"uniqueKey":"data.items.[INDEX].syncedAt","typeLabel":"string\u003cdate-time>"},"isTransactional":{"type":"boolean","description":"Whether the vault supports programmatic deposits and withdrawals via the Composer API.","example":true,"isRequired":true,"uniqueKey":"data.items.[INDEX].isTransactional","typeLabel":"boolean"},"isRedeemable":{"type":"boolean","description":"Whether the vault currently supports redemptions (withdrawals).","example":true,"isRequired":true,"uniqueKey":"data.items.[INDEX].isRedeemable","typeLabel":"boolean"},"depositPacks":{"type":"array","description":"Available deposit operation configurations. Each pack defines the steps required to deposit into the vault.","items":{"type":"object","additionalProperties":false,"required":["name","stepsType"],"properties":{"name":{"type":"string","description":"Identifier for the deposit pack.","example":"morpho-deposit","isRequired":true,"uniqueKey":"data.items.[INDEX].depositPacks.items.[INDEX].name","typeLabel":"string"},"stepsType":{"type":"string","description":"`instant` means the deposit executes in a single transaction. `complex` means multiple steps are required.","enum":["instant","complex"],"example":"instant","isRequired":true,"uniqueKey":"data.items.[INDEX].depositPacks.items.[INDEX].stepsType","typeLabel":"enum\u003cstring>"}},"uniqueKey":"data.items.[INDEX].depositPacks.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.items.[INDEX].depositPacks","typeLabel":"object[]"},"redeemPacks":{"type":"array","description":"Available redemption operation configurations. Each pack defines the steps required to withdraw from the vault.","items":{"type":"object","additionalProperties":false,"required":["name","stepsType"],"properties":{"name":{"type":"string","description":"Identifier for the redemption pack.","example":"morpho-redeem","isRequired":true,"uniqueKey":"data.items.[INDEX].redeemPacks.items.[INDEX].name","typeLabel":"string"},"stepsType":{"type":"string","description":"`instant` means the redemption executes in a single transaction. `complex` means multiple steps are required.","enum":["instant","complex"],"example":"instant","isRequired":true,"uniqueKey":"data.items.[INDEX].redeemPacks.items.[INDEX].stepsType","typeLabel":"enum\u003cstring>"}},"uniqueKey":"data.items.[INDEX].redeemPacks.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.items.[INDEX].redeemPacks","typeLabel":"object[]"},"description":{"type":"string","description":"Short description of the vault's strategy or purpose.","example":"Optimized USDC lending vault on Morpho","uniqueKey":"data.items.[INDEX].description","typeLabel":"string"},"rewardTokens":{"type":"array","description":"Additional reward tokens distributed by the vault (e.g., governance tokens). Empty array if no rewards.","items":{"type":"object","additionalProperties":false,"required":["address","symbol","decimals"],"properties":{"address":{"type":"string","description":"Reward token contract address.","example":"0x0000000000000000000000000000000000000000","isRequired":true,"uniqueKey":"data.items.[INDEX].rewardTokens.items.[INDEX].address","typeLabel":"string"},"symbol":{"type":"string","description":"Reward token symbol.","example":"MORPHO","isRequired":true,"uniqueKey":"data.items.[INDEX].rewardTokens.items.[INDEX].symbol","typeLabel":"string"},"decimals":{"type":"integer","description":"Number of decimal places for the reward token.","example":18,"minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"data.items.[INDEX].rewardTokens.items.[INDEX].decimals","typeLabel":"integer"}},"uniqueKey":"data.items.[INDEX].rewardTokens.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.items.[INDEX].rewardTokens","typeLabel":"object[]"},"caps":{"type":"object","description":"Deposit capacity limits for the vault. Omitted if the vault has no cap.","additionalProperties":false,"properties":{"totalCap":{"type":"string","description":"Total deposit cap in native token units, as a string.","example":"50000000000000","uniqueKey":"data.items.[INDEX].caps.totalCap","typeLabel":"string"},"maxCap":{"type":"string","description":"Maximum deposit cap in native token units, as a string.","example":"100000000000000","uniqueKey":"data.items.[INDEX].caps.maxCap","typeLabel":"string"}},"uniqueKey":"data.items.[INDEX].caps","typeLabel":"object"},"timeLock":{"type":"integer","description":"Withdrawal time lock in seconds. `0` means withdrawals are instant.","example":0,"minimum":0,"maximum":9007199254740991,"uniqueKey":"data.items.[INDEX].timeLock","typeLabel":"integer"},"kyc":{"type":"boolean","description":"Whether KYC verification is required to interact with this vault.","example":false,"uniqueKey":"data.items.[INDEX].kyc","typeLabel":"boolean"}},"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data","typeLabel":"object[]"},"total":{"type":"integer","description":"Total number of vaults matching the filters across all pages.","example":47,"minimum":-9007199254740991,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"total","typeLabel":"integer"},"nextCursor":{"type":"string","description":"Cursor to pass as the `cursor` parameter to fetch the next page. Absent when there are no more results.","example":"eyJpZCI6MTAwfQ","uniqueKey":"nextCursor","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"data":[{"address":"0x7BfA7C4f149E7415b73bdeDfe609237e29CBF34A","network":"base","chainId":8453,"slug":"morpho-base-usdc-0x7bfa","name":"Morpho USDC Vault","description":"Optimized USDC lending vault on Morpho","protocol":{"name":"Morpho","logoUri":"https://example.com/morpho-logo.png","url":"https://morpho.org"},"underlyingTokens":[{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","decimals":6,"weight":1}],"lpTokens":[{"address":"0x7BfA7C4f149E7415b73bdeDfe609237e29CBF34A","symbol":"mUSDC","decimals":18,"priceUsd":"1.02"}],"rewardTokens":[],"tags":["stablecoin","lending"],"analytics":{"apy":{"base":0.0534,"reward":null,"total":0.0534},"apy1d":0.0521,"apy7d":0.0538,"apy30d":0.0545,"tvl":{"usd":"12500000.00","native":"12500000000000"},"updatedAt":"2026-03-31T14:30:00.000Z"},"caps":{"totalCap":"50000000000000","maxCap":"100000000000000"},"timeLock":0,"kyc":false,"syncedAt":"2026-03-31T14:30:00.000Z","isTransactional":true,"isRedeemable":true,"depositPacks":[{"name":"morpho-deposit","stepsType":"instant"}],"redeemPacks":[{"name":"morpho-redeem","stepsType":"instant"}]}],"nextCursor":"eyJpZCI6MTAwfQ","total":47},"examples":{"Example":{"title":"Example","value":{"data":[{"address":"0x7BfA7C4f149E7415b73bdeDfe609237e29CBF34A","network":"base","chainId":8453,"slug":"morpho-base-usdc-0x7bfa","name":"Morpho USDC Vault","description":"Optimized USDC lending vault on Morpho","protocol":{"name":"Morpho","logoUri":"https://example.com/morpho-logo.png","url":"https://morpho.org"},"underlyingTokens":[{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","decimals":6,"weight":1}],"lpTokens":[{"address":"0x7BfA7C4f149E7415b73bdeDfe609237e29CBF34A","symbol":"mUSDC","decimals":18,"priceUsd":"1.02"}],"rewardTokens":[],"tags":["stablecoin","lending"],"analytics":{"apy":{"base":0.0534,"reward":null,"total":0.0534},"apy1d":0.0521,"apy7d":0.0538,"apy30d":0.0545,"tvl":{"usd":"12500000.00","native":"12500000000000"},"updatedAt":"2026-03-31T14:30:00.000Z"},"caps":{"totalCap":"50000000000000","maxCap":"100000000000000"},"timeLock":0,"kyc":false,"syncedAt":"2026-03-31T14:30:00.000Z","isTransactional":true,"isRedeemable":true,"depositPacks":[{"name":"morpho-deposit","stepsType":"instant"}],"redeemPacks":[{"name":"morpho-redeem","stepsType":"instant"}]}],"nextCursor":"eyJpZCI6MTAwfQ","total":47}}},"exampleType":"examples"}},"exampleType":"examples"},"e125001a-0542-48b5-9f9c-ba1309c38fa4":{"description":"Validation failed","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["statusCode","message","errors"],"properties":{"statusCode":{"type":"number","description":"HTTP status code. Always `400` for validation errors.","example":400,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Human-readable summary of the validation failure.","example":"Validation failed","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"errors":{"type":"array","description":"List of individual validation errors.","items":{"type":"object","additionalProperties":false,"required":["code","message","path"],"properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"invalid_type","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","description":"Description of this specific validation failure.","example":"Expected integer, received string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"path":{"type":"array","description":"JSON path to the field that failed validation.","items":{"oneOf":[{"type":"string","uniqueKey":"errors.items.[INDEX].path.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"number","uniqueKey":"errors.items.[INDEX].path.items.[INDEX].oneOf.1","typeLabel":"number"}],"uniqueKey":"errors.items.[INDEX].path.items.[INDEX]","typeLabel":"string | number"},"example":["chainId"],"isRequired":true,"uniqueKey":"errors.items.[INDEX].path","typeLabel":"(string | number)[]"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":400,"message":"Validation failed","errors":[{"code":"invalid_type","message":"Expected integer, received string","path":["chainId"]}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"6e4bb3ee-0076-493b-ad3d-8546617c52af":{"x-lifi-api-key":{"type":"apiKey","in":"header","name":"x-lifi-api-key","scopes":[]}}},"servers":{"0285defb-9487-4b01-974e-b9eb8019d542":{"url":"https://earn.li.fi","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-lifi-api-key","scopes":[]},"schema":{"title":"x-lifi-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"x-lifi-api-key","name":"x-lifi-api-key"}],"title":"x-lifi-api-key"}]},"originalFileLocation":"earn-openapi.yaml"},"subdomain":"lifi","siteName":"LI.FI","title":"List vaults with optional filtering - LI.FI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/earn-vaults/list-vaults-with-optional-filtering","matchLevel":0},"zh-Hans":{"href":"/zh-Hans/introduction/introduction","matchLevel":4}}},"lastModified":"2026-05-04T12:51:10.706Z","originalFileLocation":"api-reference/earn-vaults/list-vaults-with-optional-filtering.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Returns a paginated list of vaults with optional filtering and sorting.\">\u003cmeta data-mint-head name=\"application-name\" content=\"LI.FI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List vaults with optional filtering - LI.FI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns a paginated list of vaults with optional filtering and sorting.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"LI.FI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.li.fi/api-reference/earn-vaults/list-vaults-with-optional-filtering\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://lifi.mintlify.app/_mintlify/api/og/v2?division=Vaults\u0026amp;title=List+vaults+with+optional+filtering\u0026amp;description=Returns+a+paginated+list+of+vaults+with+optional+filtering+and+sorting.\u0026amp;theme=bbd760f308f6962e114ab426\u0026amp;signature=dba84d3e5b5de83936cfae5a1fb117ee49026c3507061725f9e0d6fa9dd1281a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List vaults with optional filtering - LI.FI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns a paginated list of vaults with optional filtering and sorting.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://lifi.mintlify.app/_mintlify/api/og/v2?division=Vaults\u0026amp;title=List+vaults+with+optional+filtering\u0026amp;description=Returns+a+paginated+list+of+vaults+with+optional+filtering+and+sorting.\u0026amp;theme=bbd760f308f6962e114ab426\u0026amp;signature=dba84d3e5b5de83936cfae5a1fb117ee49026c3507061725f9e0d6fa9dd1281a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"LI.FI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5C67FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.li.fi/api-reference/earn-vaults/list-vaults-with-optional-filtering\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/earn-vaults/list-vaults-with-optional-filtering.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.li.fi/#organization\",\"name\":\"LI.FI\",\"url\":\"https://docs.li.fi\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/lifi/EmProAEgMrruLUbI/logo/light.png?fit=max\u0026auto=format\u0026n=EmProAEgMrruLUbI\u0026q=85\u0026s=f435348680e682acea6e3b9af339ed7a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.li.fi#website\",\"name\":\"LI.FI\",\"url\":\"https://docs.li.fi\",\"publisher\":{\"@id\":\"https://docs.li.fi/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.li.fi/api-reference/earn-vaults/list-vaults-with-optional-filtering#webpage\",\"url\":\"https://docs.li.fi/api-reference/earn-vaults/list-vaults-with-optional-filtering\",\"name\":\"List vaults with optional filtering\",\"description\":\"Returns a paginated list of vaults with optional filtering and sorting.\",\"dateModified\":\"2026-05-04T12:51:10.706Z\",\"isPartOf\":{\"@id\":\"https://docs.li.fi#website\"},\"breadcrumb\":{\"@id\":\"https://docs.li.fi/api-reference/earn-vaults/list-vaults-with-optional-filtering#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.li.fi/api-reference/earn-vaults/list-vaults-with-optional-filtering#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.li.fi/api-reference/earn-chains/list-chains-supported-by-lifi-earn\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List vaults with optional filtering\",\"item\":\"https://docs.li.fi/api-reference/earn-vaults/list-vaults-with-optional-filtering\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.li.fi/api-reference/earn-vaults/list-vaults-with-optional-filtering#apireference\",\"headline\":\"List vaults with optional filtering\",\"name\":\"List vaults with optional filtering\",\"description\":\"Returns a paginated list of vaults with optional filtering and sorting.\",\"url\":\"https://docs.li.fi/api-reference/earn-vaults/list-vaults-with-optional-filtering\",\"mainEntityOfPage\":{\"@id\":\"https://docs.li.fi/api-reference/earn-vaults/list-vaults-with-optional-filtering#webpage\"},\"dateModified\":\"2026-05-04T12:51:10.706Z\",\"publisher\":{\"@id\":\"https://docs.li.fi/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.li.fi#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"LI.FI\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"LI.FI","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":"/introduction/introduction"}]},{"tab":"Enterprise (New)","pages":[{"title":"Enterprise (New)","href":"/enterprise/overview"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"tab":"SDK","pages":[{"title":"SDK","href":"/sdk/overview"}]},{"tab":"Widget","pages":[{"title":"Widget","href":"/widget/overview"}]},{"tab":"Composer","pages":[{"title":"Composer","href":"/composer/overview"}]},{"tab":"Earn","groups":[{"group":"Getting Started","pages":[{"title":"What is LI.FI Earn?","href":"/earn/overview"},{"title":"Quickstart","href":"/earn/quickstart"},{"title":"How Earn Works","href":"/earn/how-it-works"}]},{"group":"Integration Guides","pages":[{"title":"API Integration","href":"/earn/guides/api-integration"},{"title":"Supported Protocols \u0026 Chains","href":"/earn/guides/supported-protocols"}]},{"group":"Recipes","pages":[{"title":"Discover and Deposit","href":"/earn/recipes/discover-and-deposit"}]},{"group":"API Reference","pages":[{"group":"Chains","pages":[{"title":"List chains supported by LI.FI Earn","description":"Returns the list of chains that have at least one Earn vault available. Derived from current vault data.\n\n**This endpoint is scoped to LI.FI Earn (vaults).** Only chains where Earn currently has indexed vaults are returned — it is not a general list of all chains the LI.FI platform supports, and it should not be used to determine SDK / Swaps / Bridges chain coverage.\n\nIf you are integrating Swaps or Bridges (via the LI.FI SDK or the main API), call [`GET https://li.quest/v1/chains`](/api-reference/get-information-about-all-currently-supported-chains) instead. That endpoint returns every chain supported by the LI.FI Aggregation API.\n","deprecated":null,"version":null,"openapi":"/earn-openapi.yaml get /v1/chains","href":"/api-reference/earn-chains/list-chains-supported-by-lifi-earn"}]},{"group":"Vaults","pages":[{"title":"List vaults with optional filtering","deprecated":null,"version":null,"openapi":"/earn-openapi.yaml get /v1/vaults","href":"/api-reference/earn-vaults/list-vaults-with-optional-filtering"},{"title":"Get vault by chain and address","description":"Returns the full details for a single vault.","deprecated":null,"version":null,"openapi":"/earn-openapi.yaml get /v1/vaults/{chainId}/{address}","href":"/api-reference/earn-vaults/get-vault-by-chain-and-address"}]},{"group":"Protocols","pages":[{"title":"List supported protocols","deprecated":null,"version":null,"openapi":"/earn-openapi.yaml get /v1/protocols","href":"/api-reference/earn-protocols/list-supported-protocols"}]},{"group":"Portfolio","pages":[{"title":"Get portfolio positions for a user","deprecated":null,"version":null,"openapi":"/earn-openapi.yaml get /v1/portfolio/{userAddress}/positions","href":"/api-reference/earn-portfolio/get-portfolio-positions-for-a-user"}]}]}]},{"tab":"Perps","pages":[{"title":"Perps","href":"/perps/overview"}]},{"tab":"Intents \u0026 Solvers","pages":[{"title":"Intents \u0026 Solvers","href":"/lifi-intents/introduction"}]},{"tab":"For Agents","pages":[{"title":"For Agents","href":"/agents/overview"}]},{"tab":"Widget Playground","href":"https://playground.li.fi/"},{"tab":"Bigmi","pages":[{"title":"Bigmi","href":"/bigmi/overview"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/gas-options"}]},{"tab":"FAQs","pages":[{"title":"FAQs","href":"/faqs/fees-monetization"}]}]},{"language":"zh-Hans","pages":[{"title":"zh-Hans","href":"/zh-Hans/introduction/introduction"}]}]},"basePath":"","title":"List vaults with optional filtering - LI.FI","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}