Skip to main content
GET
List vaults with optional filtering

Authorizations

x-lifi-api-key
string
header
required

Query Parameters

chainId
integer

Filter by EVM chain ID (e.g., 8453 for Base, 1 for Ethereum).

Required range: 1 <= x <= 2147483647
asset
string

Filter by underlying token symbol or address (e.g., USDC).

Minimum string length: 1
protocol
string

Filter by protocol name (e.g., morpho-v1, aave-v3).

Minimum string length: 1
minTvlUsd
number

Minimum TVL in USD. Use this to filter out low-liquidity vaults (e.g., 1000000 for $1M+).

Required range: x >= 0
isTransactional
enum<string>

Filter by whether the vault supports programmatic deposits and withdrawals via the Composer API. Pass true to return only transactional vaults.

Available options:
true,
false
isRedeemable
enum<string>

Filter by whether the vault currently supports redemptions (withdrawals). Pass true to return only vaults that can be redeemed.

Available options:
true,
false
isComposerSupported
enum<string>

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.

Available options:
true,
false
sortBy
enum<string>

Sort order for results. apy sorts by highest total APY first. tvl sorts by highest TVL first.

Available options:
apy,
tvl
cursor
string

Pagination cursor from a previous response's nextCursor field. Omit to start from the beginning.

Minimum string length: 1
limit
integer

Number of results per page. Defaults to 50.

Required range: 1 <= x <= 100

Response

Paginated vault list

data
object[]
required

Array of vault objects matching the filters.

total
integer
required

Total number of vaults matching the filters across all pages.

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

47

nextCursor
string

Cursor to pass as the cursor parameter to fetch the next page. Absent when there are no more results.

Example:

"eyJpZCI6MTAwfQ"