Get Data

Before Starting

In this tutorial, you might see different ways to fetch data for Morpho Vaults:

API: Using the Morpho public API (see endpoint below). This is the easiest and most direct way for most applications. Note that only a subset of chains are supported.
Typescript: Using Typescript snippet. For Developers expecting to perform offchain computation.
Smart Contract: Fetching data directly onchain. This is best for real-time or trustless data.
SDK: [Examples Incoming] Using the Morpho SDKs for pre-built abstractions and faster development.

For each topic below, you'll find short guides for each method (where possible). This avoids redundancy and helps you choose the best approach for your use case.

Discovery and Listing

Vaults List

Morpho Vaults V2

API

query {
  vaultV2s(first: 1000, where: { chainId_in: [1, 8453] }) {
    items {
      address
      symbol
      name
      listed
      asset {
        id
        address
        decimals
      }
      chain {
        id
        network
      }
    }
  }
}

Morpho Vaults V1

API

query {
  vaults(first: 1000, where: { chainId_in: [1, 8453] }) {
    items {
      address
      symbol
      name
      listed
      asset {
        id
        address
        decimals
      }
      chain {
        id
        network
      }
    }
  }
}

Vault Metrics

Total Deposits & Assets

Morpho Vaults V2

Unique Vault

query {
  vaultV2ByAddress(
    address: "0x04422053aDDbc9bB2759b248B574e3FCA76Bc145"
    chainId: 1
  ) {
    address
     totalAssets
      totalAssetsUsd
      totalSupply
      liquidity
      liquidityUsd
      idleAssetsUsd
  }
}

On Morpho Vaults V1

Unique Vault

query {
  vaultByAddress(
    address: "0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB"
    chainId: 1
  ) {
    address
    state {
      totalAssets
      totalAssetsUsd
      totalSupply
    }
    liquidity {
      underlying
      usd
    }
  }
}

APY (Native + Rewards)

Morpho Vaults V2

Morpho Vaults V2 can be eligible for 2 levels of rewards:

Market level rewards: These are inherited from the Morpho Markets V1 where the Morpho Vault V2 allocates assets.
Vault level rewards:
1. One type of rewards here are inherited from the Morpho Vaults V1 where the Morpho Vault V2 allocates assets.
2. Second type of rewards here are distributed directly to the Morpho Vault V2 itself.

Note for Morpho Vault V2: all rewards appearing on the Morpho Api are displayed under rewards section directly.

APY Components Breakdown:

Native APY: The base yield earned from depositing assets into either Morpho Markets V1 or Morpho Vaults V1.
Underlying Token Yield: The yield generated by the underlying token itself (when applicable). For yield-bearing loan assets, this is calculated using daily exchange rate changes queried at 1-day block intervals. Access this via asset.yield.apr.
Reward APRs: Additional incentives from both types. All rewards are currently accessible via rewards (Note, it is different from the queries for Morpho Vaults V1 below)
Performance Fee Adjustment: The performance fee is applied only to the Native APY component.
Management Fee Adjustment: A time-based fee (annual rate, if applicable) deducted from the total assets regardless of performance.

The combination of these components results in the Net APY:

\text{Net APY}= \text{Native APY} \times (1 - \text{Performance Fee}) + \text{Underlying Token Yield}

\phantom{\text{Net APY} =} + \sum \text{Rewards APR} - \text{Management Fee}

Where:

Performance Fee is applied only to Native APY (as a percentage)
Management Fee is applied to total assets (as an annual rate)
Underlying Token Yield applies only to yield-bearing assets (0 otherwise)
Rewards APR is the sum of all reward incentives

Important UI Reference one might find on apps:

avgApy represents the Native APY (6h average vault APY excluding rewards, before deducting the performance fee)
avgNetApy represents the complete APY (6h average vault APY including rewards, after deducting the performance fee)

Unique Vault

query {
  vaultV2ByAddress(
    address: "0x04422053aDDbc9bB2759b248B574e3FCA76Bc145"
    chainId: 1
  ) {
    address
    asset {
      yield {
        apr
      }
    }
    avgApy
    avgNetApy
    performanceFee
    managementFee
    maxRate
    rewards {
      asset {
        address
        chain {
          id
        }
      }
      supplyApr
      yearlySupplyTokens
    }
  }
}

Morpho Vaults V1

Morpho Vaults V1 can be eligible for 2 levels of rewards:

Market level rewards: These are inherited from the markets where the vault allocates assets, accessible via state.allocation.market.state.rewards (e.g., supplyApr).
Vault level rewards: These are distributed directly to the vault itself, accessible via state.rewards (e.g., supplyApr).

APY Components Breakdown:

Native APY: The base yield earned from depositing assets into markets.
Underlying Token Yield: The yield generated by the underlying token itself (when applicable). For yield-bearing loan assets, this is calculated using daily exchange rate changes queried at 1-day block intervals. Access this via asset.yield.apr.
Reward APRs: Additional incentives from both:
- Vault-level rewards: Direct rewards to the vault via state.rewards
- Market-level rewards: Allocated proportionally from markets via state.allocations.market.state.rewards using weighted averages on allocations
Performance Fee Adjustment: The performance fee is applied only to the Native APY component.

The combination of these components (adding rewards, subtracting fees) results in the Net APY.

Net Apy = Native APY + Underlying Token Yield + Rewards APRs - Perf Fee_{onNativeApy}

Important UI Reference one might find on apps:

avgApy represents the Native APY (6h average vault APY excluding rewards, before deducting the performance fee)
avgNetApy represents the complete APY (6h average vault APY including rewards, after deducting the performance fee)

Unique Vault

query {
  vaultByAddress(
    address: "0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB"
    chainId: 1
  ) {
    address
    asset {
      yield {
        apr
      }
    }
    state {
      apy
      netApy
      netApyWithoutRewards
      avgApy
      avgNetApy
      dailyApy
      dailyNetApy
      weeklyApy
      weeklyNetApy
      monthlyApy
      monthlyNetApy
      rewards {
        asset {
          address
          chain {
            id
          }
        }
        supplyApr
        yearlySupplyTokens
      }
      allocation {
        supplyAssets
        supplyAssetsUsd
        market {
          uniqueKey
          state {
            rewards {
              asset {
                address
                chain {
                  id
                }
              }
              supplyApr
              borrowApr
            }
          }
        }
      }
    }
  }
}

Share Price (Token Value)

Why You Shouldn't Calculate Manually

Computing the exchange rate as totalAssets / totalSupply can show false "drops" during fee accruals. This happens because these values update at different times, creating temporary inconsistencies.

How ERC-4626 Calculates Share Price

The standard includes virtual offsets to prevent inflation attacks and ensure consistency:

Virtual Assets: +1 added to totalAssets
Virtual Shares: +10^DECIMALS_OFFSET added to totalSupply
- DECIMALS_OFFSET matches the underlying asset decimals (6 for USDC, 18 for WETH)

Formula for pricing 1 share (10^18 wei):

\text{sharePrice} = \frac{10^{18} \times (\text{totalAssets} + 1)}{\text{totalSupply} + 10^{\text{DECIMALS\_OFFSET}}}

The result is in raw underlying asset units. To get the human-readable price, divide by 10^assetDecimals.

Recommended Methods:

API: Use the sharePrice field (already computed correctly)
Onchain: Use convertToAssets(10^18) instead of manual calculation

Practical Example with USDC Vault

Using real data from a USDC vault (6 decimals):

\text{totalAssets: } 473{,}435{,}155{,}471{,}028 \text{ (raw USDC units)}

\text{totalSupply: } 427{,}784{,}657{,}006{,}652{,}956{,}819{,}706{,}379 \text{ (raw share units)}

Applying the formula:

\text{sharePrice} = \frac{10^{18} \times 473{,}435{,}155{,}471{,}029}{427{,}784{,}657{,}006{,}652{,}956{,}819{,}706{,}379 + 10^6} = 1{,}106{,}713 \text{ (raw units)}

Converting to human-readable:

\frac{1{,}106{,}713}{10^6} = 1.106713 \text{ USDC per share}

This matches the API's sharePrice field value!

Morpho Vaults V2

Unique Vault

query {
  vaultV2ByAddress(
    address: "0x04422053aDDbc9bB2759b248B574e3FCA76Bc145"
    chainId: 1
  ) {
    totalAssets
    totalSupply
  }
}

Morpho Vaults V1

Unique Vault

query {
  vaultByAddress(
    address: "0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB"
    chainId: 1
  ) {
    address
    state {
      sharePrice
      sharePriceUsd
    }
  }
}

Allocation & Strategy

Current Allocations

Morpho Vaults V2

Unique Vault

query {
  vaultV2ByAddress(
    address: "0x04422053aDDbc9bB2759b248B574e3FCA76Bc145"
    chainId: 1
  ) {
    totalAssetsUsd
    totalAssets
    totalSupply
    adapters {
      items {
        address
        assets
        assetsUsd
        type
      }
    }
  }
}

Morpho Vaults V1

Unique Vault

query {
  vaultByAddress(
    address: "0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB"
    chainId: 1
  ) {
    address
    state {
      allocation {
        market {
          uniqueKey
          loanAsset {
            name
          }
          collateralAsset {
            name
          }
          oracleAddress
          irmAddress
          lltv
        }
        supplyCap
        supplyAssets
        supplyAssetsUsd
      }
    }
  }
}

Vault Queues

Unique Vault

query {
  vaultByAddress(
    address: "0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB"
    chainId: 1
  ) {
    address
    state {
      totalAssets
      lastTotalAssets
      allocation {
        supplyQueueIndex
        withdrawQueueIndex
        market {
          uniqueKey
        }
      }
    }
  }
}

Configuration & Governance

Vault Parameters

Morpho Vaults V2

Unique Vault

query {
  vaultV2ByAddress(
    address: "0x04422053aDDbc9bB2759b248B574e3FCA76Bc145"
    chainId: 1
  ) {
    address
    name
    listed
    metadata {
      description
      forumLink
      image
    }
    allocators {
      allocator {
        address
      }
    }
    owner {
      address
    }
    curators {
      items {
        addresses {
          address
        }
      }
    }
    sentinels {
      sentinel {
        address
      }
    }
    timelocks {
      duration
      selector
      functionName
    }
  }
}

Morpho Vaults V1

Unique Vault

query {
  vaultByAddress(
    address: "0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB"
    chainId: 1
  ) {
    address
    name
    listed
    metadata {
      description
    }
    allocators {
      address
    }
    state {
      owner
      curator
      guardian
      timelock
      curators {
         name
        socials {
          type
          url
          }
        image
      }
    }
  }
}

Pending Actions

All governance/configuration changes go through a submit → (wait) → accept/revoke lifecycle enforced by the timelock. The three events to watch are Submit, Revoke, and Accept.

Monitoring & Alerts

To get notified when pending actions are submitted, accepted, or revoked, you have two options:

Build your own notification system leveraging the query below (API, TypeScript/viem, or from the smart contract).
Off-the-shelf threat monitoring with Hypernative. Offering out-of-the-box threat/monitoring alerts for Morpho vaults.

Morpho Vaults V2

query VaultV2PendingActions {
  vaultV2ByAddress(
    address: "VAULT_ADDRESS"
    chainId: 1
  ) {
    address
    name
 
    # pending timelocked actions
    pendingConfigs(first: 100) {
      items {
        validAt
        functionName
        txHash
        decodedData {
          __typename
 
          ... on VaultV2SetIsAllocatorPendingData {
            isAllocator
            account { address }
          }
 
          ... on VaultV2SetReceiveSharesGatePendingData {
            receiveSharesGate
          }
 
          ... on VaultV2SetSendSharesGatePendingData {
            sendSharesGate
          }
 
          ... on VaultV2SetReceiveAssetsGatePendingData {
            receiveAssetsGate
          }
 
          ... on VaultV2SetSendAssetsGatePendingData {
            sendAssetsGate
          }
 
          ... on VaultV2SetAdapterRegistryPendingData {
            adapterRegistry
          }
 
          ... on VaultV2AdapterPendingData {
            adapterAddress
          }
 
          ... on VaultV2TimelockPendingData {
            timelock
            selector
            functionName
          }
 
          ... on VaultV2SetPerformanceFeePendingData {
            performanceFee
          }
 
          ... on VaultV2SetManagementFeePendingData {
            managementFee
          }
 
          ... on VaultV2SetPerformanceFeeRecipientPendingData {
            performanceFeeRecipient
          }
 
          ... on VaultV2SetManagementFeeRecipientPendingData {
            managementFeeRecipient
          }
 
          ... on VaultV2IncreaseCapPendingData {
            cap
            config {
              id
              type
            }
          }
 
          ... on VaultV2SetForceDeallocatePenaltyPendingData {
            adapterAddress
            forceDeallocatePenalty
          }
 
          ... on VaultV2AbdicatePendingData {
            selector
            functionName
          }
        }
      }
    }
  }
}

Morpho Vaults V1

query VaultV1PendingActions {
  vaultByAddress(
    address: "VAULT_ADDRESS"
    chainId: 1
  ) {
    address
    name
 
    state {
      # pending owner transfer (separate from pendingConfigs)
      pendingOwner
 
      # pending timelocked actions
      pendingConfigs(first: 50) {
        items {
          validAt
          functionName
          txHash
          decodedData {
            __typename
 
            ... on VaultSetCapPendingData {
              supplyCap
              market {
                uniqueKey
                loanAsset { symbol }
                collateralAsset { symbol }
              }
            }
 
            ... on VaultSetTimelockPendingData {
              timelock
            }
 
            ... on VaultSetGuardianPendingData {
              guardian { address }
            }
 
            ... on VaultRemoveMarketPendingData {
              caller { address }
              market {
                uniqueKey
                loanAsset { symbol }
                collateralAsset { symbol }
              }
            }
          }
        }
      }
    }
  }
}

Risk Indicators

Morpho Vault Warnings

API

query {
  vaultV2s(first: 5) {
    items {
      name
      warnings {
        type
        level
      }
    }
  }
}

Fee Wrapper

FeeWrapper List

Unique FeeWrapper

query VaultV2ByAddress {
  vaultV2ByAddress(
    address: "0xd4468EF3745c315949a97090eD27b3F73b9b7C02"
    chainId: 8453
  ) {
    type
    address
    name
  }
}

FeeWrapper Exposure

Unique FeeWrapper

query VaultV2ByAddress {
  vaultV2ByAddress(
    address: "0xd4468EF3745c315949a97090eD27b3F73b9b7C02"
    chainId: 8453
  ) {
    type
    adapters {
      items {
        type
        address
        ... on MorphoVaultV2Adapter {
          address
          innerVault {
            address
            name
          }
        }
      }
    }
    historicalState {
      sharePrice(options: {
        startTimestamp: 1771015645
        endTimestamp: 1771915645
        interval: HOUR
      }) {
        x
        y
      }
    }
  }
}

FeeWrapper Yield

Unique FeeWrapper

query VaultV2ByAddress {
  vaultV2ByAddress(
    address: "0xd4468EF3745c315949a97090eD27b3F73b9b7C02"
    chainId: 8453
  ) {
    type
    apy
    avgNetApyExcludingRewards
    avgNetApy
    performanceFee
    performanceFeeRecipient
    managementFee
    managementFeeRecipient
    rewards {
      asset {
        symbol
        address
      }
      supplyApr
    }
  }
}

Position Tracking

User All Vaults Position

Morpho Vaults V2 & V1

query GetUserVaultPositions($address: String!, $chainId: Int!) {
  userByAddress(address: $address, chainId: $chainId) {
    id
    vaultV2Positions {
      shares
      vault {
        address
        symbol
      }
    }
    vaultPositions {
      state {
        shares
      }
      vault {
        address
        symbol
      }
    }
  }
}

Vault Depositors

Morpho Vaults V2

Unique Vault

query {
  vaultV2ByAddress(
    address: "0x04422053aDDbc9bB2759b248B574e3FCA76Bc145"
    chainId: 1
  ) {
    positions(first: 10, skip:0) {
      items {
        user {
          address
        }
        assets
        assetsUsd
        shares
      }
    }
    totalSupply
    asset {
      address
      symbol
    }
  }
}

Morpho Vaults V1

Unique Vault

query {
  vaultPositions(
    first: 10
    orderBy: Shares
    orderDirection: Desc
    where: { vaultAddress_in: ["0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB"] }
  ) {
    items {
      user {
        address
      }
      state {
        shares
        assets
        assetsUsd
      }
    }
  }
}

Transaction History

Morpho Vaults V2

Unique Vault

query {
  vaultV2transactions(
    first: 10
    skip: 0
    where: { vaultAddress_in: "0x04422053aDDbc9bB2759b248B574e3FCA76Bc145" }
  ) {
    items {
      vault {
        address
      }
      type
      shares
      blockNumber
      timestamp
      txHash
      txIndex
    }
  }
}

Morpho Vaults V1

Unique Vault

query {
  transactions(
    first: 10
    orderBy: Timestamp
    orderDirection: Desc
    where: { vaultAddress_in: ["0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB"] }
  ) {
    items {
      blockNumber
      hash
      type
      user {
        address
      }
    }
  }
}

Historical Data

APY Historical State

Morpho Vaults v2

Coming soon.

Morpho Vaults V1

Unique Vault

query VaultApys($options: TimeseriesOptions) {
  vaultByAddress(address: "0x73e65DBD630f90604062f6E02fAb9138e713edD9") {
    address
    historicalState {
      apy(options: $options) {
        x
        y
      }
      netApy(options: $options) {
        x
        y
      }
    }
  }
}

With those variables:

{
  "options": {
    "startTimestamp": 1740000000,
    "endTimestamp": 1742564817,
    "interval": "DAY"
  }
}