Morpho Vaults
How to query Morpho Vaults Data thanks to the API?
Select the query you are interested in in the list below, and paste it into the GraphQL Playground: https://api.morpho.org/graphql
Discovery and Listing
Vaults List
query {
vaultV2s(first: 1000, where: { chainId_in: [1, 8453] }) {
items {
address
symbol
name
listed
asset {
id
address
decimals
}
chain {
id
network
}
}
}
}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
All Vaults
query {
vaultV2s(first: 100) {
items {
address
totalAssets
totalAssetsUsd
totalSupply
liquidityUsd
idleAssetsUsd
}
}
}query {
vaults(first: 100, orderBy: TotalAssetsUsd, orderDirection: Desc) {
items {
address
state {
totalAssets
totalAssetsUsd
totalSupply
}
}
}
}Specific Vault
query {
vaultV2ByAddress(
address: "0x04422053aDDbc9bB2759b248B574e3FCA76Bc145"
chainId: 1
) {
address
totalAssets
totalAssetsUsd
totalSupply
liquidity
liquidityUsd
idleAssetsUsd
}
}query {
vaultByAddress(
address: "0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB"
chainId: 1
) {
address
state {
totalAssets
totalAssetsUsd
totalSupply
}
liquidity {
underlying
usd
}
}
}APY (Native + Rewards)
All Vaults
query {
vaultV2s(first: 10) {
items {
address
asset {
yield {
apr
}
}
avgNetApyExcludingRewards
avgNetApy
performanceFee
managementFee
maxRate
rewards {
asset {
address
chain {
id
}
}
supplyApr
}
}
}
}
query {
vaults(first: 100, orderBy: TotalAssetsUsd, orderDirection: Desc) {
items {
address
asset {
yield {
apr
}
}
state {
apy
netApy
netApyExcludingRewards
avgNetApyExcludingRewards
avgNetApy
dailyApy: avgNetApyExcludingRewards(lookback: ONE_DAY)
dailyNetApy: avgNetApy(lookback: ONE_DAY)
weeklyApy: avgNetApyExcludingRewards(lookback: SEVEN_DAYS)
weeklyNetApy: avgNetApy(lookback: SEVEN_DAYS)
monthlyApy: avgNetApyExcludingRewards(lookback: THIRTY_DAYS)
monthlyNetApy: avgNetApy(lookback: THIRTY_DAYS)
allRewards {
asset {
address
chain {
id
}
}
supplyApr
}
allocation {
supplyAssets
supplyAssetsUsd
market {
marketId
state {
rewards {
asset {
address
chain {
id
}
}
supplyApr
borrowApr
}
}
}
}
}
}
}
}Specific Vault
query {
vaultV2ByAddress(
address: "0x04422053aDDbc9bB2759b248B574e3FCA76Bc145"
chainId: 1
) {
address
asset {
yield {
apr
}
}
avgNetApyExcludingRewards
avgNetApy
performanceFee
managementFee
maxRate
rewards {
asset {
address
chain {
id
}
}
supplyApr
}
}
}query {
vaultByAddress(
address: "0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB"
chainId: 1
) {
address
asset {
yield {
apr
}
}
state {
apy
netApy
netApyExcludingRewards
avgNetApyExcludingRewards
avgNetApy
dailyApy: avgNetApyExcludingRewards(lookback: ONE_DAY)
dailyNetApy: avgNetApy(lookback: ONE_DAY)
weeklyApy: avgNetApyExcludingRewards(lookback: SEVEN_DAYS)
weeklyNetApy: avgNetApy(lookback: SEVEN_DAYS)
monthlyApy: avgNetApyExcludingRewards(lookback: THIRTY_DAYS)
monthlyNetApy: avgNetApy(lookback: THIRTY_DAYS)
allRewards {
asset {
address
chain {
id
}
}
supplyApr
}
allocation {
supplyAssets
supplyAssetsUsd
market {
marketId
state {
rewards {
asset {
address
chain {
id
}
}
supplyApr
borrowApr
}
}
}
}
}
}
}Share Price (Token Value)
All Vaults
query {
vaultV2s(first: 10) {
items {
address
totalSupply
totalAssets
sharePrice
}
}
}query {
vaults(first: 100, orderBy: TotalAssetsUsd, orderDirection: Desc) {
items {
address
state {
sharePriceNumber
sharePriceUsd
}
}
}
}Specific Vault
query {
vaultV2ByAddress(
address: "0x04422053aDDbc9bB2759b248B574e3FCA76Bc145"
chainId: 1
) {
totalAssets
totalSupply
sharePrice
}
}query {
vaultByAddress(
address: "0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB"
chainId: 1
) {
address
state {
sharePriceNumber
sharePriceUsd
}
}
}Allocation & Strategy
Vault V2 allocation data is expressed via adapters, whereas Vault V1 allocations reference the underlying variable rate markets. For Vault V2, MorphoMarketV1Adapter exposes its per-market breakdown through positions.items: use each position's state.supplyAssetsUsd for market-level rows, and avoid counting both adapter.assetsUsd and the nested positions.items.state.supplyAssetsUsd in the same table. Include idleAssetsUsd when computing allocation percentages that should sum to 100%.
Current Allocations
All Vaults
query {
vaultV2s(first: 10) {
items {
address
totalAssetsUsd
totalAssets
totalSupply
idleAssets
idleAssetsUsd
adapters(first: 5) {
items {
__typename
address
assets
assetsUsd
type
... on MorphoMarketV1Adapter {
positions(first: 10) {
items {
market {
marketId
collateralAsset {
symbol
}
loanAsset {
symbol
}
}
state {
supplyAssets
supplyAssetsUsd
}
}
}
}
... on MetaMorphoAdapter {
metaMorpho {
address
name
asset {
symbol
}
}
}
... on MorphoVaultV2Adapter {
innerVault {
address
name
asset {
symbol
}
}
}
}
}
}
}
}query {
vaults(first: 100, orderBy: TotalAssetsUsd, orderDirection: Desc) {
items {
address
state {
allocation {
market {
marketId
loanAsset {
name
}
collateralAsset {
name
}
oracle {
address
}
irmAddress
lltv
}
supplyCap
supplyAssets
supplyAssetsUsd
}
}
}
}
}Specific Vault
query {
vaultV2ByAddress(
address: "0x04422053aDDbc9bB2759b248B574e3FCA76Bc145"
chainId: 1
) {
address
totalAssetsUsd
totalAssets
totalSupply
idleAssets
idleAssetsUsd
adapters(first: 20) {
items {
__typename
address
assets
assetsUsd
type
... on MorphoMarketV1Adapter {
positions(first: 50) {
items {
market {
marketId
collateralAsset {
symbol
}
loanAsset {
symbol
}
}
state {
supplyAssets
supplyAssetsUsd
}
}
}
}
... on MetaMorphoAdapter {
metaMorpho {
address
name
asset {
symbol
}
}
}
... on MorphoVaultV2Adapter {
innerVault {
address
name
asset {
symbol
}
}
}
}
}
}
}query {
vaultByAddress(
address: "0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB"
chainId: 1
) {
address
state {
allocation {
market {
marketId
loanAsset {
name
}
collateralAsset {
name
}
oracle {
address
}
irmAddress
lltv
}
supplyCap
supplyAssets
supplyAssetsUsd
}
}
}
}Strategy: Vault Queues (Morpho Vaults V1)
query {
vaults(first: 100, orderBy: TotalAssetsUsd, orderDirection: Desc) {
items {
address
state {
totalAssets
allocation {
supplyQueueIndex
withdrawQueueIndex
market {
marketId
}
}
}
}
}
}query {
vaultByAddress(
address: "0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB"
chainId: 1
) {
address
state {
totalAssets
allocation {
supplyQueueIndex
withdrawQueueIndex
market {
marketId
}
}
}
}
}Configuration & Curation
Vault Parameters
All Vaults
query {
vaultV2s(first: 10) {
items {
address
name
listed
metadata {
description
image
}
allocators {
allocator {
address
}
}
owner {
address
}
curators {
items {
addresses {
address
}
}
}
sentinels {
sentinel {
address
}
}
timelocks {
duration
selector
functionName
}
}
}
}query {
vaults(first: 100, orderBy: TotalAssetsUsd, orderDirection: Desc) {
items {
address
name
listed
metadata {
description
}
allocators {
address
}
state {
owner
curator
guardian
timelock
curators {
name
socials {
type
url
}
image
}
}
}
}
}Specific Vault
query {
vaultV2ByAddress(
address: "0x04422053aDDbc9bB2759b248B574e3FCA76Bc145"
chainId: 1
) {
address
name
listed
metadata {
description
image
}
allocators {
allocator {
address
}
}
owner {
address
}
curators {
items {
addresses {
address
}
}
}
sentinels {
sentinel {
address
}
}
timelocks {
duration
selector
functionName
}
}
}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
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
}
}
}
}
}
}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 {
marketId
loanAsset { symbol }
collateralAsset { symbol }
}
}
... on VaultSetTimelockPendingData {
timelock
}
... on VaultSetGuardianPendingData {
guardian { address }
}
... on VaultRemoveMarketPendingData {
caller { address }
market {
marketId
loanAsset { symbol }
collateralAsset { symbol }
}
}
}
}
}
}
}
}Risk Indicators
Vault Warnings
a. Warning type can be:
- unrecognized_deposit_asset,
- unrecognized_vault_curator.
- not_whitelisted.
b. Warning level is either:
YELLOW,RED.
query {
vaultV2s(first: 5) {
items {
name
warnings {
type
level
}
}
}
}query {
vaults {
items {
name
warnings {
type
level
}
}
}
}You can read more about warnings in the dedicated section here.
Vault Curation
Note: These curator-focused endpoints currently expose Vault V1 data.
Current Vaults Pending Caps
query {
vaults {
items {
pendingCaps {
validAt
supplyCap
market {
marketId
}
}
}
}
}Current Vaults Allocators
query {
vaultV2s(first: 10) {
items {
name
allocators {
allocator {
address
}
}
}
}
}query {
vaults(first: 10) {
items {
name
allocators {
address
}
}
}
}Fee Wrapper
A Fee Wrapper is a Vault V2 configured in a specific, constrained mode that enables distribution channels to add a fee layer on top of an existing Morpho Vault V2.
FeeWrapper List
query VaultV2ByAddress {
vaultV2ByAddress(
address: "0xd4468EF3745c315949a97090eD27b3F73b9b7C02"
chainId: 8453
) {
type
address
name
}
}query VaultV2s {
vaultV2s(skip: 0, first: 20, where: { type_in: [FeeWrapper] }) {
items {
address
name
}
}
}FeeWrapper Exposure
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
}
}
}
}query VaultV2s {
vaultV2s(skip: 0, first: 20, where: { type_in: [FeeWrapper] }) {
items {
type
address
adapters {
items {
type
address
... on MorphoVaultV2Adapter {
address
innerVault {
address
name
}
}
}
}
historicalState {
sharePrice(options: {
startTimestamp: 1771015645
endTimestamp: 1771915645
interval: HOUR
}) {
x
y
}
}
}
}
}FeeWrapper Yield
query VaultV2ByAddress {
vaultV2ByAddress(
address: "0xd4468EF3745c315949a97090eD27b3F73b9b7C02"
chainId: 8453
) {
type
apy
avgNetApyExcludingRewards
avgNetApy
performanceFee
performanceFeeRecipient
managementFee
managementFeeRecipient
rewards {
asset {
symbol
address
}
supplyApr
}
}
}query VaultV2s {
vaultV2s(skip: 0, first: 20, where: { type_in: [FeeWrapper] }) {
items {
type
address
apy
avgNetApyExcludingRewards
avgNetApy
performanceFee
performanceFeeRecipient
managementFee
managementFeeRecipient
rewards {
asset {
symbol
address
}
supplyApr
}
}
}
}Position Tracking
Vault Depositors
Specific Vault
query {
vaultV2ByAddress(
address: "0x04422053aDDbc9bB2759b248B574e3FCA76Bc145"
chainId: 1
) {
positions(first: 10, skip:0) {
items {
user {
address
}
assets
assetsUsd
shares
}
}
totalSupply
asset {
address
symbol
}
}
}
query {
vaultPositions(
first: 10
orderBy: Shares
orderDirection: Desc
where: { vaultAddress_in: ["0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB"] }
) {
items {
user {
address
}
state {
shares
assets
assetsUsd
}
}
}
}Set of Vaults (Morpho Vaults V1)
Vault V2 does not yet expose an equivalent batched depositor query.
query {
vaultPositions(
first: 10
orderBy: Shares
orderDirection: Desc
where: {
vaultAddress_in: [
"0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB"
"0x73e65DBD630f90604062f6E02fAb9138e713edD9"
]
}
) {
items {
vault {
address
}
user {
address
}
state {
shares
assets
assetsUsd
}
}
}
}User Positions
User All Vaults Position
query GetUserVaultPositions($address: String!, $chainId: Int!) {
userByAddress(address: $address, chainId: $chainId) {
address
chain {
id
}
vaultV2Positions {
shares
vault {
address
symbol
}
}
vaultPositions {
state {
shares
}
vault {
address
symbol
}
}
}
}Query Variables example:
{
"address": "USER_ADDRESS",
"chainId": 8453
}User Account Overview
query {
userByAddress(
chainId: 1
address: "0x821880a3E2bac432d67E5155e72BB655Ef65fa5E"
) {
address
marketPositions {
market {
marketId
}
state {
borrowAssets
borrowAssetsUsd
supplyAssets
supplyAssetsUsd
}
}
vaultPositions {
vault {
address
name
}
state {
assets
assetsUsd
shares
}
}
vaultV2Positions {
vault {
address
name
}
assets
assetsUsd
shares
}
}
vaultV1Transactions(
first: 10
orderBy: Time
orderDirection: Desc
where: {
userAddress_in: ["0x821880a3E2bac432d67E5155e72BB655Ef65fa5E"]
chainId_in: [1]
}
) {
items {
txHash
timestamp
type
}
}
marketTransactions(
first: 10
orderBy: Timestamp
orderDirection: Desc
where: {
userAddress_in: ["0x821880a3E2bac432d67E5155e72BB655Ef65fa5E"]
chainId_in: [1]
}
) {
items {
txHash
timestamp
type
}
}
vaultV2transactions(
first: 10
orderBy: Time
orderDirection: Desc
where: {
userAddress_in: ["0x821880a3E2bac432d67E5155e72BB655Ef65fa5E"]
chainId_in: [1]
}
) {
items {
txHash
timestamp
type
shares
assets
vault {
address
name
}
}
}
}User Earnings
Earnings on a Specific Vault
query {
vaultV2PositionByAddress(
userAddress: "USERADDRESS"
vaultAddress: "MORPHOVAULTV2ADDRESS"
chainId: 1
) {
vault {
name
address
}
assets
assetsUsd
shares
pnl
pnlUsd
roe # time-weighted return since inception (non-annualized)
}
}query {
vaultPositions(where: {
userAddress_in: ["USERADDRESS"]
vaultAddress_in: ["MORPHOVAULTV1ADDRESS"]
chainId_in: [1]
}) {
items {
vault {
name
address
}
state {
assets
assetsUsd
shares
pnl
pnlUsd
roe # time-weighted return since inception (non-annualized)
}
}
}
}Earnings Across All Vaults
query {
userByAddress(address: "USERADDRESS", chainId: 1) {
vaultV2Positions {
vault {
name
address
}
assets
assetsUsd
shares
pnl
pnlUsd
roe # time-weighted return since inception (non-annualized)
}
vaultPositions {
vault {
name
address
}
state {
assets
assetsUsd
shares
pnl
pnlUsd
roe # time-weighted return since inception (non-annualized)
}
}
}
}Transaction History
Specific Vault
query {
vaultV2transactions(
skip: 0
first: 10
orderBy: Time
orderDirection: Desc
where: {
vaultAddress_in: "0x04422053aDDbc9bB2759b248B574e3FCA76Bc145"
chainId_in: [1]
}
) {
items {
vault {
address
}
type
shares
blockNumber
timestamp
txHash
txIndex
logIndex
}
}
}query {
vaultV1Transactions(
first: 10
orderBy: Time
orderDirection: Desc
where: {
vaultAddress_in: ["0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB"]
chainId_in: [1]
}
) {
items {
vault {
address
}
type
shares
assets
blockNumber
timestamp
txHash
txIndex
logIndex
}
}
}Latest Transactions (All Vaults)
query {
vaultV2transactions(
first: 10
orderBy: Time
orderDirection: Desc
where: { type_in: [Deposit, Withdraw] }
) {
items {
type
shares
assets
blockNumber
timestamp
txHash
logIndex
chain {
id
network
}
vault {
address
}
data {
... on VaultV2DepositData {
sender
onBehalf
}
... on VaultV2WithdrawData {
sender
receiver
onBehalf
}
}
}
}
}query {
vaultV1Transactions(
first: 10
orderBy: Time
orderDirection: Desc
) {
items {
type
shares
assets
blockNumber
timestamp
txHash
logIndex
chain {
id
network
}
vault {
address
}
data {
... on VaultV1DepositData {
sender
onBehalf
}
... on VaultV1WithdrawData {
sender
receiver
onBehalf
}
}
}
}
}Public Allocator
Configuration
query {
vaultByAddress(
address: "0x38989BBA00BDF8181F4082995b3DEAe96163aC5D"
chainId: 1
) {
address
publicAllocatorConfig {
fee
flowCaps {
market {
marketId
}
maxIn
maxOut
}
}
}
}Reallocations
query {
vaultReallocates(
first: 10
skip: 0
orderBy: Timestamp
where: {vaultAddress_in:["0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB"]}
orderDirection: Desc
) {
items {
id
timestamp
hash
blockNumber
caller
shares
assets
type
vault {
address
chain {
id
}
}
market {
marketId
chain {
id
}
lltv
oracle {
address
}
irmAddress
creationBlockNumber
loanAsset {
symbol
}
collateralAsset {
symbol
}
}
}
pageInfo {
countTotal
count
skip
limit
}
}
}Historical Data
APY Historical State (Morpho Vaults V1)
query VaultApys($options: TimeseriesOptions) {
vaults(first: 10, orderBy: TotalAssetsUsd, orderDirection: Desc) {
items {
address
historicalState {
apy(options: $options) {
x
y
}
netApy(options: $options) {
x
y
}
}
}
}
}query VaultApys($options: TimeseriesOptions) {
vaultByAddress(address: "0x73e65DBD630f90604062f6E02fAb9138e713edD9") {
address
historicalState {
apy(options: $options) {
x
y
}
netApy(options: $options) {
x
y
}
}
}
}Query Variables:
{
"options": {
"startTimestamp": 1716249600,
"endTimestamp": 1716422400,
"interval": "DAY"
}
}Historical Allocation (Morpho Vaults V1)
query Vaults($options: TimeseriesOptions) {
vaults (first: 10, skip: 0, orderBy: TotalAssetsUsd, orderDirection: Desc) {
items {
address
name
historicalState {
allocation {
market {
marketId
}
supplyAssets(options: $options) {
x
y
}
supplyAssetsUsd(options: $options) {
x
y
}
}
}
}
}
}query VaultApys($options: TimeseriesOptions) {
vaultByAddress(address: "0x73e65DBD630f90604062f6E02fAb9138e713edD9") {
address
historicalState {
allocation {
market {
marketId
}
supplyAssets(options: $options) {
x
y
}
supplyAssetsUsd(options: $options) {
x
y
}
}
}
}
}Query Variables:
{
"options": {
"startTimestamp": 1768211594,
"endTimestamp": 1768384394,
"interval": "DAY"
}
}