Docs
Launch App

Morpho API Changelog

This page tracks Morpho API field deprecations, field removals, and other API changes.

In this changelog:

Change typeMeaning
Field deprecationA field that is still present in the schema but not maintained anymore. Will be removed at a later stage.
Field removalA field that is or will be removed from the schema. Using this field in a query will throw an error.

Deprecation/Removal Rollout - May 2026 to October 2026

October 21, 2026 - View scheduled field removals
Deprecated FieldReplacementDeprecation date
Asset.priceUsdprice.usd2026-03-19
Market.oracleAddressoracle.address2025-10-14
Market.targetBorrowUtilizationN/A2026-04-13
Market.targetWithdrawUtilizationN/A2026-04-13
VaultMetadata.forumLinkN/A2026-04-10
VaultV2Metadata.forumLinkN/A2026-04-10
September 30, 2026 - View scheduled field removals
Deprecated FieldReplacementDeprecation date
Asset.oraclePriceUsdprice.usd2026-02-05
Asset.spotPriceEthN/A2026-01-20
Asset.totalSupplyN/A2026-01-20
Market.monthlyApysstate.monthlyApys2025-09-09
Market.oracleInfooracle.data2025-10-14
VaultState.dailyApyavgNetApyExcludingRewards2026-02-15
VaultState.dailyNetApyavgNetApy2026-02-15
VaultState.netApyWithoutRewardsnetApyExcludingRewards2026-02-15
VaultState.rewardsallRewards2026-03-30
VaultState.weeklyApyavgNetApyExcludingRewards2026-02-15
VaultState.weeklyNetApyavgNetApy2026-02-15
August 26, 2026 - View scheduled field removals
Deprecated FieldReplacementDeprecation date
Market.dailyApysstate.dailyApys2025-09-09
Query.oracleFeedByAddressN/A2026-07-10
Query.oracleFeedsN/A2026-07-10
Query.oracleVaultByAddressN/A2026-07-10
Query.oracleVaultsN/A2026-07-10
Query.publicAllocatorN/A2026-07-10
Query.publicAllocatorsN/A2026-07-10
Query.vaultFactoriesN/A2026-07-10
Query.vaultFactoryByAddressN/A2026-07-10
Query.vaultV2FactoriesN/A2026-07-10
Query.vaultV2MetaMorphoAdapterFactoriesN/A2026-07-10
VaultV2.avgApyavgNetApyExcludingRewards2026-02-15
July 29, 2026 - View scheduled field removals
Deprecated FieldReplacementDeprecation date
Asset.isWhitelistedisListed2025-12-22
Market.collateralPricestate.price2025-09-09
Market.creatorAddressmorphoBlue2026-01-27
Query.transactionsvaultV2transactions, vaultV1Transactions, marketTransactions2026-04-23
User.transactionsvaultV1Transactions, marketTransactions2026-04-23
VaultState.lastTotalAssetstotalAssets2026-04-16
June 24, 2026 - View scheduled field removals
Deprecated FieldReplacementDeprecation date
Asset.historicalSpotPriceEthN/A2026-01-20
Asset.riskAnalysisN/A2026-01-20
AssetsFilters.credoraRiskScore_gteN/A2025-11-26
AssetsFilters.credoraRiskScore_lteN/A2025-11-26
Curator.urlsocials.url2025-09-09
Market.concentrationN/A2025-09-09
Market.idmarketId and chain.id2026-05-14
Market.oracleFeedoracle.data2025-10-14
Market.riskAnalysisN/A2025-09-09
MarketConcentration.borrowHhiN/A2026-01-28
MarketConcentration.supplyHhiN/A2026-01-28
MarketFilters.credoraRiskScore_gteN/A2025-11-26
MarketFilters.credoraRiskScore_lteN/A2025-11-26
MarketHistory.feeN/A2026-01-07
MarketHistory.priceN/A2026-01-19
MarketOracleAccuracy.
averagePercentDifference		N/A2025-09-09
MarketOracleAccuracy.
maxPercentDifference		N/A2025-09-09
MarketStateReward.
amountPerBorrowedToken		N/A2025-09-12
MarketStateReward.
amountPerSuppliedToken		N/A2025-09-12
MarketStateReward.yearlyBorrowTokensN/A2025-09-12
MarketStateReward.yearlySupplyTokensN/A2025-09-12
OracleFeed.descriptionN/A2025-10-08
OracleFeed.historicalPriceN/A2025-10-08
OracleFeed.pairN/A2025-10-08
OracleFeed.priceN/A2025-10-08
OracleFeed.vendorN/A2025-10-08
OracleVault.decimalsN/A2025-10-20
OracleVault.pairN/A2025-10-20
OracleVault.vendorN/A2025-10-20
Query.marketOracleAccuracymarketById(marketId:, chainId:)2026-05-14
Query.transactionByHashN/A2025-01-02
Query.usersuserByAddress(address:, chainId:) when the address is known; otherwise use address-scoped queries2026-05-14
User.idaddress and chain.id2026-05-14
User.tagN/A2026-05-14
Vault.idaddress and chain.id2026-05-14
VaultAllocationDto.enabledN/A2026-01-15
VaultFilters.credoraRiskScore_gteN/A2025-11-26
VaultFilters.credoraRiskScore_lteN/A2025-11-26
VaultState.idParent Vault.address and Vault.chain.id2026-05-14
VaultStateReward.
amountPerSuppliedToken		N/A2026-03-20
VaultStateReward.
yearlySupplyTokens		N/A2026-03-20

When fetching an entity, pass chainId as an input argument where available. When reading an entity from the response, select chain { id }.

May 20, 2026 - View scheduled field removals
Deprecated FieldReplacementDeprecation date
AssetsFilters.id_inaddress_in2026-02-11
AssetsFilters.whitelistedlisted2025-12-22
CuratorFilters.chainIdchainId_in2025-09-09
Market.allTimeApysstate.allTimeApy2025-09-09
Market.quarterlyApysstate.quarterlyApys2025-09-09
Market.uniqueKeymarketId2026-03-30
Market.weeklyApysstate.weeklyApys2025-09-09
Market.whitelistedlisted2026-01-29
Market.yearlyApysstate.yearlyApys2025-09-09
MarketFilters.collateralAssetId_incollateralAssetSelector_in2026-01-29
MarketFilters.id_inselector_in2026-01-29
MarketFilters.loanAssetId_inloanAssetSelector_in2026-01-29
MarketFilters.whitelistedlisted2026-02-27
MarketHistory.allTimeNetBorrowApyallTimeBorrowApy2026-01-19
MarketHistory.allTimeNetSupplyApyallTimeSupplyApy2026-01-19
MarketHistory.rateAtUTargetapyAtTarget2025-12-23
MarketPosition.borrowAssetsstate.borrowAssets2025-09-09
MarketPosition.borrowAssetsUsdstate.borrowAssetsUsd2025-09-09
MarketPosition.borrowSharesstate.borrowShares2025-09-09
MarketPosition.collateralstate.collateral2025-09-09
MarketPosition.collateralUsdstate.collateralUsd2025-09-09
MarketPosition.supplyAssetsstate.supplyAssets2025-09-09
MarketPosition.supplyAssetsUsdstate.supplyAssetsUsd2025-09-09
MarketPosition.supplySharesstate.supplyShares2025-09-09
MarketPosition.whitelistedlisted2026-02-03
MarketPositionFilters.marketId_inmarketUniqueKey_in2026-02-11
MarketPositionFilters.
marketWhitelisted		marketListed2026-02-27
MarketPositionFilters.userId_inuserAddress_in2026-01-20
MarketState.rateAtUTargetapyAtTarget2026-01-07
MarketStateReward.borrowApyborrowApr2024-05-28
MarketStateReward.supplyApysupplyApr2024-05-28
MorphoBlueFilters.id_inaddress_in2026-02-11
MorphoChainlinkOracleData.vaultbaseOracleVault2025-09-09
MorphoChainlinkOracleV2Data.baseVaultbaseOracleVault2025-09-09
MorphoChainlinkOracleV2Data.quoteVaultquoteOracleVault2025-09-09
PublicAllocatorFilters.id_inaddress_in2026-02-11
PublicAllocatorSharedLiquidity.
allocationMarket		withdrawMarket2025-12-17
PublicAllocatorSharedLiquidity.marketsupplyMarket2025-12-17
PublicallocatorReallocateFilters.
marketId_in		marketSelector_in2026-01-27
PublicallocatorReallocateFilters.
vaultId_in		vaultSelector_in2026-01-27
Query.assetassetByAddress2026-02-12
Query.marketmarketById2025-09-09
Query.marketAverageApysstate2025-07-28
Query.marketByUniqueKeymarketById2026-04-01
Query.morphoBluemorphoBlueByAddress2026-02-12
Query.searchmarkets and vaults2026-03-20
Query.transactiontransactions2026-02-12
Query.useruserByAddress2026-02-12
Query.vaultvaultByAddress2026-02-12
Query.vaultFactoryvaultFactoryByAddress2026-02-12
RiskAnalysis.isUnderReviewanalysis.isUnderReview2025-09-09
RiskAnalysis.ratinganalysis.rating2025-09-09
RiskAnalysis.scoreanalysis.score2025-09-09
RiskAnalysis.timestampanalysis.timestamp2025-09-09
TransactionFilters.assetId_inassetAddress_in2026-02-11
TransactionFilters.assetSymbol_inassetAddress_in2026-02-16
TransactionFilters.marketId_inmarketUniqueKey_in2026-02-11
TransactionFilters.userId_inuserAddress_in2026-02-11
TransactionFilters.vaultId_invaultAddress_in2026-02-11
TransactionFilters.assetsUsd_gteN/A2026-02-16
TransactionFilters.assetsUsd_lteN/A2026-02-16
TransactionFilters.badDebtAssetsUsd_gteN/A2026-02-16
TransactionFilters.badDebtAssetsUsd_lteN/A2026-02-16
TransactionFilters.repaidAssetsUsd_gteN/A2026-02-16
TransactionFilters.repaidAssetsUsd_lteN/A2026-02-16
TransactionFilters.seizedAssetsUsd_gteN/A2026-02-16
TransactionFilters.seizedAssetsUsd_lteN/A2026-02-16
UsersFilters.assetId_inassetAddress_in2026-02-11
UsersFilters.id_inaddress_in2026-02-11
UsersFilters.marketId_inmarketUniqueKey_in2026-02-11
UsersFilters.vaultId_invaultAddress_in2026-02-11
Vault.dailyApystate.avgNetApyExcludingRewards(lookback: ONE_DAY)2026-01-15
Vault.dailyApysstate.avgNetApyExcludingRewards(lookback: ONE_DAY) and state.avgNetApy(lookback: ONE_DAY)2026-01-15
Vault.monthlyApystate.avgNetApyExcludingRewards(lookback: THIRTY_DAYS)2026-01-15
Vault.monthlyApysstate.avgNetApyExcludingRewards(lookback: THIRTY_DAYS) and state.avgNetApy(lookback: THIRTY_DAYS)2026-01-15
Vault.pendingCapsstate.pendingConfigs2026-01-15
Vault.promotedfeatured2026-02-11
Vault.riskAnalysiswarnings2025-11-26
Vault.weeklyApysstate.avgNetApyExcludingRewards(lookback: SEVEN_DAYS) and state.avgNetApy(lookback: SEVEN_DAYS)2026-01-15
Vault.whitelistedlisted2026-02-11
VaultFilters.assetId_inassetAddress_in2026-02-11
VaultFilters.curator_incuratorAddress_in2026-02-11
VaultFilters.id_inaddress_in2026-02-11
VaultFilteVaultFilters.promotedfeatured2026-02-11
VaultFilters.whitelistedlisted2026-02-11
VaultHistoryDto.curatorvault.adminEvents2026-04-20
VaultHistoryDto.feeRecipientvault.adminEvents2026-04-20
VaultHistoryDto.guardianvault.adminEvents2026-04-20
VaultHistoryDto.ownervault.adminEvents2026-04-20
VaultHistoryDto.sharePricesharePriceNumber2026-01-15
VaultHistoryDto.skimRecipientvault.adminEvents2026-04-20
VaultMetadata.curatorsstate.curators2025-09-09
VaultPosition.assetsstate.assets2025-09-09
VaultPosition.assetsUsdstate.assetsUsd2025-09-09
VaultPosition.sharesstate.shares2025-09-09
VaultPosition.whitelistedlisted2025-12-22
VaultPositionFilters.userId_inuserAddress_in2026-01-20
VaultPositionFilters.vaultId_invaultAddress_in2026-01-20
VaultPositionFilters.
vaultWhitelisted		vaultListed2026-02-11
VaultReallocateFilters.marketId_inmarketUniqueKey_in2026-02-11
VaultReallocateFilters.vaultId_invaultAddress_in2026-02-11
VaultState.allTimeApyavgNetApyExcludingRewards2026-02-15
VaultState.allTimeNetApyavgNetApy2026-02-15
VaultState.avgApyavgNetApyExcludingRewards2026-02-15
VaultState.biweeklyApyavgNetApyExcludingRewards2026-02-15
VaultState.biweeklyNetApyavgNetApy2026-02-15
VaultState.monthlyApyavgNetApyExcludingRewards2026-02-15
VaultState.monthlyNetApyavgNetApy2026-02-15
VaultState.pendingGuardianpendingConfigs2026-01-15
VaultState.pendingGuardianValidAtpendingConfigs2026-01-15
VaultState.pendingTimelockpendingConfigs2026-01-15
VaultState.pendingTimelockValidAtpendingConfigs2026-01-15
VaultState.quarterlyApyavgNetApyExcludingRewards2026-02-15
VaultState.quarterlyNetApyavgNetApy2026-02-15
VaultState.sharePricesharePriceNumber2026-01-15
VaultState.yearlyApyavgNetApyExcludingRewards2026-02-15
VaultState.yearlyNetApyavgNetApy2026-02-15
VaultV2.gatesgatesConfig2025-11-25
VaultV2.whitelistedlisted2025-12-22
VaultV2sFilters.assetId_inaddress_in2026-02-11
VaultV2sFilters.curator_incuratorAddress_in2025-11-25
VaultV2sFilters.whitelistedlisted2026-02-11

August 28, 2026 - Core and Midnight REST API updates

View change details

The Core REST API added the following endpoint:

APIChange
coreAdded GET /v0/blue/markets/{market-selector}/liquidity, which returns MarketLiquidityResponse with market_liquidity, reallocatable_liquidity, borrow_amount_to_target_utilization, and last_indexed_block. All four fields are bigint-as-string values.

The Midnight REST API expanded the supported chain_ids values:

APIChain IDChange
midnight1chain_ids now supports Ethereum mainnet in addition to Base (8453) on endpoints that expose this parameter.

August 26, 2026 - Core and Midnight REST API updates

View change details

The Core REST API added the following endpoints:

APIChange
coreAdded GET /v0/blue/markets/{market-selector}/users/{user-address}/position/performance.
coreAdded a 404 response to GET /v0/blue/markets/{market-selector}/users/{user-address}/position.
coreAdded GET /v0/vaults-v1 and GET /v0/vaults-v2.
coreAdded GET /v1/blue/markets, GET /v1/vaults-v1/users/{user-address}/positions, and GET /v1/vaults-v2/users/{user-address}/positions.
coreAdded the MarketListResponse, UserMarketPositionPerformanceResponse, UserVaultPositionsResponse, VaultV1ListResponse, and VaultV2ListResponse schemas.
coreRemoved GET /v0/vaults-v1/{vault-selector}/apy and GET /v0/vaults-v2/{vault-selector}/apy.
coreRemoved the VaultApyResponse schema.

The Midnight REST API changed the following response fields, schemas, status codes, query parameters, and result-set behavior:

APIChange
midnightAdded market_family_id to market detail, market state, and market list responses.
midnightAdded verified nullable Blue callback metadata to each item in OfferGroupsResponse, and added warning to takeable-offer response structures.
midnightAdded the discriminated TakeabilityWarningResponse with warning codes including MAKER_LIQUIDITY, MAKER_ALLOWANCE, SOURCE_LIQUIDITY, REDUCE_ONLY, POSITION_CAPACITY, AMOUNT_ROUNDING, CALLBACK_NOT_REGISTERED, RATIFIER_NOT_AUTHORIZED, SIMULATION_FAILED, SINGLE_TAKE_LIMIT, ROOT_CANCELED, ROOT_NOT_RATIFIED, SIGNER_NOT_AUTHORIZED, and BELOW_MINIMUM_SIZE.
midnightAdded the BlueCallbackValidationIssueResponse and BlueCallbackRegistryIssueDetailsResponse schemas, including callback_not_registered and callback_owner_mismatch registry values.
midnightChanged shared ErrorResponse.details from a nullable object to a nullable array whose items remain untyped. Added typed callback validation details and typed details entries to the MidnightErrorResponse envelope.
midnightAdded the market_family_ids query parameter to GET /v0/midnight/markets, GET /v0/midnight/users/{user-address}/positions, and GET /v0/midnight/users/{user-address}/transactions. It filters by Midnight market family; on positions and transactions, it combines with market_ids using AND semantics.
midnightAdded maturity_gte and maturity_lte to GET /v0/midnight/books, and added status, callback_type, and market_family_ids to GET /v0/midnight/users/{user-address}/offer-groups.
midnightChanged the existing maturities filter on GET /v0/midnight/books from unrestricted numbers to integers from 1 through 9007199254740991; zero and fractional values are no longer accepted.
midnightChanged GET /v0/midnight/books to return only active maturities admitted by the current policy. Unlisted and past maturities are excluded even when requested with ids; books disappear immediately when a maturity leaves the policy, including books with existing offers.
midnightUnder /v0/midnight, added 500 responses to GET /markets, /markets/{market-id}, /markets/{market-id}/state, /markets/{market-id}/transactions, /markets/{market-id}/positions, /markets/{market-id}/users/{user-address}/position, /markets/{market-id}/users/{user-address}/position/performance, /users/{user-address}/transactions, /users/{user-address}/positions, and /users/{user-address}/offer-groups.
midnightUnder /v0/midnight, added 400 responses to GET /markets/{market-id}, /markets/{market-id}/state, /markets/{market-id}/users/{user-address}/position, and /markets/{market-id}/users/{user-address}/position/performance. Added VALIDATION_FAILED to the 400 response contracts for all ten operations that gained 500 responses.

April 23, 2026 - Morpho Vault V1 historical admin fields deprecation

View deprecation details

The jobs backing the admin-address time series on Morpho Vaults V1 have been retired. The following fields remain in the schema for backwards compatibility but are no longer maintained and will be removed at a later stage.

Deprecated fields & alternatives

FieldAlternative
vault.historicalState.
curator		vault.adminEvents
(where: { type_in: ["setCurator"] })
vault.historicalState.
feeRecipient		vault.adminEvents
(where: { type_in: ["setFeeRecipient"] })
vault.historicalState.
guardian		vault.adminEvents
(where: { type_in: ["setGuardian"] })
vault.historicalState.
owner		vault.adminEvents
(where: { type_in: ["ownershipTransferred"] })
vault.historicalState.
skimRecipient		vault.adminEvents
(where: { type_in: ["setSkimRecipient"] })

Apply the same pattern for the other four fields, using the matching type_in value and ... on <Event>Data fragment:

Event or fieldFragment or alternative
setFeeRecipientSetFeeRecipientEventData { feeRecipient }
setGuardianSetGuardianEventData { guardian }
vault.historicalState.
guardian		vault.adminEvents
(where: { type_in: ["setGuardian"] })
ownershipTransferredOwnershipEventData { owner }
setSkimRecipientSetSkimRecipientEventData { skimRecipient }

May 6, 2026 - Legacy rewards API deprecation

View deprecation details

Rewards distribution has migrated from the legacy Morpho Universal Rewards Distributor (URD) system to Merkl. All new campaigns from July 2025 onwards use Merkl exclusively.

Deprecated endpointAlternative
rewards.morpho.org/docsDeprecated. Historical rewards can still be claimed via
rewards-legacy.morpho.org.

April 2, 2026 - pnl API fields removal

View removal details

Removed fields:

Removed field
vaultPosition.state.roeUsd
vaultPosition.historicalState.
pnl pnlUsd roe roeUsd
vaultV2Position.roeUsd
vaultV2Position.historicalState.
pnl pnlUsd roe roeUsd
marketPosition.state.
pnl pnlUsd roe roeUsd
marketPosition.state.
supplyPnl supplyPnlUsd supplyRoe supplyRoeUsd
marketPosition.state.borrowRoeUsd
marketPosition.state.
collateralPnlUsd collateralRoeUsd
marketPosition.state.
marginPnl marginPnlUsd marginRoe marginRoeUsd
marketPosition.historicalState.
supplyPnl supplyPnlUsd supplyRoe supplyRoeUsd
marketPosition.historicalState.
borrowPnl borrowPnlUsd borrowRoe borrowRoeUsd
marketPosition.historicalState.
collateralPnlUsd collateralRoeUsd
marketPosition.historicalState.
marginPnl marginPnlUsd marginRoe marginRoeUsd
user.state.
vaultsPnlUsd vaultsRoeUsd vaultV2sPnlUsd vaultV2sRoeUsd
marketsPnlUsd marketsRoeUsd marketsSupplyPnlUsd marketsSupplyRoeUsd
marketsBorrowPnlUsd marketsBorrowRoeUsd marketsCollateralPnlUsd marketsCollateralRoeUsd
marketsMarginPnlUsd marketsMarginRoeUsd
user.historicalState.
vaultsPnlUsd vaultsRoeUsd vaultV2sPnlUsd vaultV2sRoeUsd
marketsPnlUsd marketsRoeUsd marketsSupplyPnlUsd marketsSupplyRoeUsd
marketsBorrowPnlUsd marketsBorrowRoeUsd marketsCollateralPnlUsd marketsCollateralRoeUsd
marketsMarginPnlUsd marketsMarginRoeUsd

The fields that will be kept are:

Kept fieldNote
vaultPosition.
state.
pnl		—
vaultPosition.
state.
pnlUsd		changed definition from "p&l if each interaction was realizing profit/loss in USD" to "currently p&l in underlying assets quoted in USD at the latest price"
vaultPosition.
state.
roe		—
vaultV2Position.
pnl
pnlUsd
roe		—
marketPosition.
state.
borrowPnl
borrowPnlUsd
borrowRoe		—

April 2, 2026 - API fields removal

View removal details

This is the first removal notice of the Morpho API. One can expect this kind of removal notice every 6 months. This is a cleanup fields removal, removing only fields that are marked as deprecated for more than 1 year, with an alternative or a non longer maintained feature.

Fields removed & alternatives

FieldAlternative
_crossVersionVaultsNA
marketAverageApysmarket(s).state
transactionByHashNA
marketOracleAccuracyNA
asset.
historicalSpotPriceEth spotPriceEth riskAnalysis totalSupply		NA
curators.items.urlcurators.items.socials.url
market(s).
allTimeApys dailyApys monthlyApys quaterlyApys weeklyApys yearlyApys		market(s).state.
allTimeBorrowApy dailyApys monthlyApys quaterlyApys weeklyApys yearlyApys
market(s).collateralPricemarket(s).state.price
market(s).concentrationNA
market(s).
oracleAddress oracleFeed oracleInfo		market(s).oracle.address
market(s).oracle.data... (×2)
vault(s).
dailyApy(s) monthlyApy(s) weeklyApy(s) pendingCaps		vault(s).state.
dailyApy monthlyApy weeklyApy pendingConfigs
marketPosition(s).
borrowAssets borrowAssetsUsd borrowShares collateral collateralUsd supplyAssets supplyAssetsUsd supplyShares		marketPosition(s).state.
borrowAssets borrowAssetsUsd borrowShares collateral collateralUsd supplyAssets supplyAssetsUsd supplyShares
vaultPosition(s).
assets assetsUsd shares		vaultPosition(s).state.
assets assetsUsd shares
on MorphoChainlinkOracleV2Data
.baseVault .quoteVault
on MorphoChainlinkOracleData
.vault		on MorphoChainlinkOracleV2Data
.baseOracleVault .quoteOracleVault
on MorphoChainlinkOracleData
.baseOracleVault

Changes represented by market(s) / vault(s) are also applied to marketByUniqueKey and vaultByAddress queries.

October 16, 2025 - Limiting the maximum complexity of a query

View change details

Action

GraphQL complexity details:

Item
Max allowed complexity: 1,000,000
Base cost per operation: 10
Each field adds cost; some fields declare explicit costs and/or multipliers.

For details on how to check your queries' complexity and reduce it if needed, see Maximum complexity of a GraphQL query.

September 20, 2025 - Search limitation

View change details

Rational

The numberOfResults was previously unbounded so the query can yield a huge amount of results which can have an impact on the performance of the Morpho API.

Action

ParameterConstraintDefault
numberOfResultsMust be within [0, 1000] in the search root resolver.5

September 19, 2025 - Fields removal

View removal details

Rational

Some rewards fields were wrongly computed since the Merkl integration:

Affected fieldOutcome
yearlySupplyTokensWill always be set to 0 and be removed from the schema.
yearlyBorrowTokensWill always be set to 0 and be removed from the schema.
amountPerSuppliedTokenWill always be set to 0 and be removed from the schema.
amountPerBorrowedTokenWill always be set to 0 and be removed from the schema.

Action

These fields will always be set to 0 and be removed in the schema.


Troubleshoot

The Morpho API is integrating Merkl, these fields shouldn't be used and instead supplyApy and borrowApy fields should satisfy integrators needs.


The only removed use-cases along with this 4 fields should be:


Removed use-case
displaying rewards for an unpriced asset
computing the apy with a custom price (fdv feature on the Morpho app)

Rewards

Previous Page

Get Started

Next Page

On this page

Deprecation/Removal Rollout - May 2026 to October 2026August 28, 2026 - Core and Midnight REST API updatesAugust 26, 2026 - Core and Midnight REST API updatesApril 23, 2026 - Morpho Vault V1 historical admin fields deprecationMay 6, 2026 - Legacy rewards API deprecationApril 2, 2026 - pnl API fields removalApril 2, 2026 - API fields removalOctober 16, 2025 - Limiting the maximum complexity of a querySeptember 20, 2025 - Search limitationSeptember 19, 2025 - Fields removal