Skip to main content
GET
/
v1
/
vaults
/
{chainId}
/
{address}
Get vault by chain and address
curl --request GET \
  --url https://earn.li.fi/v1/vaults/{chainId}/{address} \
  --header 'x-lifi-api-key: <api-key>'
{
  "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"
    }
  ]
}

Authorizations

​
x-lifi-api-key
string
header
required

Path Parameters

​
address
string
required

Vault contract address (0x-prefixed, 40 hex characters).

Pattern: ^0x[0-9a-fA-F]{40}$
​
chainId
integer
required

EVM chain ID of the network the vault is deployed on.

Required range: 1 <= x <= 2147483647

Response

Vault found

​
address
string
required

Vault contract address (0x-prefixed, 40 hex characters).

Example:

"0x7BfA7C4f149E7415b73bdeDfe609237e29CBF34A"

​
network
string
required

Network name as a lowercase string (e.g., base, ethereum).

Example:

"base"

​
chainId
integer
required

EVM chain ID of the network the vault is deployed on.

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

8453

​
slug
string
required

URL-safe unique identifier for the vault, combining protocol, network, asset, and a short address suffix.

Example:

"morpho-base-usdc-0x7bfa"

​
name
string
required

Human-readable display name for the vault.

Example:

"Morpho USDC Vault"

​
protocol
object
required

The DeFi protocol that operates this vault.

​
underlyingTokens
object[]
required

The tokens you deposit into this vault.

​
lpTokens
object[]
required

LP (liquidity provider) tokens received when depositing into the vault.

​
tags
string[]
required

Descriptive labels for filtering and categorisation (e.g., stablecoin, lending, yield).

Example:
["stablecoin", "lending"]
​
analytics
object
required

Real-time yield and TVL analytics for the vault.

​
syncedAt
string<date-time>
required

ISO 8601 timestamp of when vault data was last synced from the provider.

Example:

"2026-03-31T14:30:00.000Z"

​
isTransactional
boolean
required

Whether the vault supports programmatic deposits and withdrawals via the Composer API.

Example:

true

​
isRedeemable
boolean
required

Whether the vault currently supports redemptions (withdrawals).

Example:

true

​
depositPacks
object[]
required

Available deposit operation configurations. Each pack defines the steps required to deposit into the vault.

​
redeemPacks
object[]
required

Available redemption operation configurations. Each pack defines the steps required to withdraw from the vault.

​
description
string

Short description of the vault's strategy or purpose.

Example:

"Optimized USDC lending vault on Morpho"

​
rewardTokens
object[]

Additional reward tokens distributed by the vault (e.g., governance tokens). Empty array if no rewards.

​
caps
object

Deposit capacity limits for the vault. Omitted if the vault has no cap.

​
timeLock
integer

Withdrawal time lock in seconds. 0 means withdrawals are instant.

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

0

​
kyc
boolean

Whether KYC verification is required to interact with this vault.

Example:

false