Euler Data API (V3)
type: WebAPI
description: API specification for Euler Data v3. This spec defines the current resource-oriented contract for the platform, with emphasis on consistent schemas, predictable REST semantics, caching, observability,
version: 3.0.0
documentation: https://docs.euler.finance/developers/data-querying/euler-v3-api

ErrorResponse
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: error

HealthResponse
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: status
has property: version
has property: uptime
has property: timestamp

DetailedHealthResponse
type: DefinedTerm
in defined term set: EulerFinanceVocabulary

PlatformAuthSession
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: platformAdminId
has property: googleEmail
has property: googleSubject
has property: active
has property: expiresAt

PlatformAdminAccessRequest
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: googleEmail

PlatformAdminAccess
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: id
has property: googleEmail
has property: createdAt
has property: revokedAt

PlatformAdminCreateAccessResult
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: admin
has property: state

PlatformAdminRevokeAccessResult
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: admin
has property: state

Entity
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: id
has property: name
has property: logo
has property: description
has property: url
has property: socialTwitter
has property: socialYoutube
has property: socialDiscord
has property: socialTelegram
has property: socialGithub

EntityCreateRequest
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: id
has property: name
has property: logo
has property: description
has property: url
has property: socialTwitter
has property: socialYoutube
has property: socialDiscord
has property: socialTelegram
has property: socialGithub

EntityUpdateRequest
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: name
has property: logo
has property: description
has property: url
has property: socialTwitter
has property: socialYoutube
has property: socialDiscord
has property: socialTelegram
has property: socialGithub

EntityMember
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: id
has property: entityId
has property: email
has property: name
has property: role
has property: createdAt
has property: revokedAt

EntityMemberCreateRequest
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: email
has property: name
has property: role

EntityAddress
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: entityId
has property: chainId
has property: address
has property: label

EntityAddressCreateRequest
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: address
has property: label

EntityMemberUpdateRequest
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: name
has property: role

PaginationMeta
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: total
has property: hasMore
has property: offset
has property: limit
has property: timestamp
has property: chainId

Chain
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: id
has property: name
has property: status

ProtocolStats
type: DefinedTerm
description: EVK lending aggregates across the selected chains, with Earn TVL reported separately.
in defined term set: EulerFinanceVocabulary
has property: totalSuppliedUsd
has property: totalBorrowedUsd
has property: earnTotalAssetsUsd
has property: utilization
has property: vaultCount
has property: chainCount

ChainStats
type: DefinedTerm
in defined term set: EulerFinanceVocabulary

AssetRef
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: address
has property: symbol
has property: decimals
has property: name

OraclePriceRaw
type: DefinedTerm
description: Exact oracle quote values returned by contracts, represented as raw integer strings in the oracle unit-of-account scale.
in defined term set: EulerFinanceVocabulary
has property: queryFailure
has property: queryFailureReason
has property: amountIn
has property: amountOutMid
has property: amountOutBid
has property: amountOutAsk
has property: timestamp

VaultFees
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: interestFee
has property: accumulatedFeesShares
has property: accumulatedFeesAssets
has property: governorFeeReceiver
has property: protocolFeeReceiver
has property: protocolFeeShare

VaultHookedOperations
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: deposit
has property: mint
has property: withdraw
has property: redeem
has property: transfer
has property: skim
has property: borrow
has property: repay
has property: repayWithShares
has property: pullDebt

VaultHooks
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: hookedOperations
has property: hookTarget

VaultCaps
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: supplyCap
has property: borrowCap

VaultLiquidation
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: maxLiquidationDiscount
has property: liquidationCoolOffTime
has property: socializeDebt

VaultInterestRates
type: DefinedTerm
description: Contract interest-rate values formatted as decimal strings in fraction units, not public percent APY numbers.
in defined term set: EulerFinanceVocabulary
has property: borrowSPY
has property: borrowAPY
has property: supplyAPY

VaultInterestRateModel
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: address
has property: type
has property: data

SubAccount
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: owner
has property: addressPrefix
has property: blockNumber
has property: timestamp

OracleAdapterPythDetail
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: pyth
has property: base
has property: quote
has property: feedId
has property: maxStaleness
has property: maxConfWidth

OracleAdapterChainlinkDetail
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: oracle

OracleDetailedInfo
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: oracle
has property: name
has property: oracleInfo

OracleAdapterEntry
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: oracle
has property: name
has property: base
has property: quote
has property: pythDetail
has property: chainlinkDetail

OracleResolvedVault
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: vault
has property: quote
has property: asset
has property: resolvedAssets

OracleInfo
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: oracle
has property: name
has property: detailedInfo
has property: adapters
has property: resolvedVaults

Vault
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: address
has property: vaultType
has property: name
has property: symbol
has property: decimals
has property: shares
has property: asset
has property: totalAssets
has property: totalBorrows

VaultResolveEntry
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: address
has property: found
has property: vaultType
has property: factory
has property: resource
has property: snapshotTimestamp

VaultDetails
type: DefinedTerm
in defined term set: EulerFinanceVocabulary

VaultApyPoint
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: supplyApy
has property: borrowApy
has property: timestamp

VaultApy
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: current
has property: history

VaultApyMeta
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: vault
has property: resolution
has property: startTimestamp
has property: endTimestamp
has property: timestamp

VaultTotalsPoint
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: totalAssets
has property: totalBorrows
has property: cash
has property: utilization
has property: supplyApy
has property: borrowApy
has property: timestamp

VaultTotals
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: current
has property: history

VaultTotalsMeta
type: DefinedTerm
in defined term set: EulerFinanceVocabulary

VaultTotalsFreshness
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: mode
has property: forceFreshRequested
has property: refreshTriggered
has property: refreshCompleted
has property: timedOut
has property: rateLimited
has property: fallbackReason
has property: waitedMs
has property: latestSnapshotTimestamp
has property: ageSeconds

OracleRouterConfig
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: asset0
has property: asset1
has property: oracle
has property: blockNumber
has property: timestamp
has property: txHash

OracleRouterVault
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: vault
has property: asset
has property: blockNumber
has property: timestamp
has property: txHash

OracleRouterState
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: router
has property: deployer
has property: deployedAt
has property: configs
has property: vaults

CollateralConfigWithPrice
type: DefinedTerm
in defined term set: EulerFinanceVocabulary

VaultCollateralDetail
type: DefinedTerm
in defined term set: EulerFinanceVocabulary

VaultIncludePrices
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: asset
has property: collaterals

VaultDetailsWithIncludes
type: DefinedTerm
in defined term set: EulerFinanceVocabulary

VaultDetailResponse
type: DefinedTerm
description: Single-vault detail response shape for `GET /v3/evk/vaults/{chainId}/{address}`.
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: address
has property: vaultType
has property: name
has property: symbol
has property: decimals
has property: shares
has property: asset
has property: dToken
has property: oracle

VaultDetailResponseWithIncludes
type: DefinedTerm
in defined term set: EulerFinanceVocabulary

EvkVaultBatchRequest
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: addresses
has property: include

EvkVaultBatchMeta
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: count
has property: requested
has property: notFound
has property: timestamp
has property: chainId

EvkVaultBatchResponse
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: data
has property: meta

EarnVaultSummary
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: address
has property: name
has property: symbol
has property: decimals
has property: asset
has property: totalAssets
has property: totalShares
has property: lostAssets
has property: exchangeRate

EarnVaultBatchRequest
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: addresses
has property: include

EarnVaultBatchMeta
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: count
has property: requested
has property: notFound
has property: timestamp
has property: chainId

EarnVaultBatchItem
type: DefinedTerm
in defined term set: EulerFinanceVocabulary

EarnVaultBatchResponse
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: data
has property: meta

EarnVaultDetails
type: DefinedTerm
in defined term set: EulerFinanceVocabulary

EarnStrategy
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: address
has property: vaultType
has property: symbol
has property: name
has property: decimals
has property: suppliedAssets
has property: withdrawnAssets
has property: allocatedAssets
has property: allocatedAssetsUsd
has property: availableAssets

EarnVaultManagement
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: owner
has property: curator
has property: guardian
has property: feeRecipient
has property: timelockSeconds
has property: performanceFee

EarnVaultGovernance
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: owner
has property: creator
has property: curator
has property: guardian
has property: feeReceiver
has property: timelock
has property: pendingTimelock
has property: pendingTimelockValidAt
has property: pendingGuardian
has property: pendingGuardianValidAt

EarnStrategyAllocationCap
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: current
has property: pending
has property: pendingValidAt

EarnIncludePrices
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: asset

EarnVaultDetailsWithIncludes
type: DefinedTerm
in defined term set: EulerFinanceVocabulary

VaultPosition
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: account
has property: shares
has property: assets
has property: assetsUsd
has property: lastUpdatedBlock

AccountLiquidityValue
type: DefinedTerm
description: Contract-derived account-liquidity value in unit-of-account terms; each field is a raw 18-decimal bigint string.
in defined term set: EulerFinanceVocabulary
has property: borrowing
has property: liquidation
has property: oracleMid

AccountPositionLiquidity
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: vaultAddress
has property: unitOfAccount
has property: daysToLiquidation
has property: liabilityValue
has property: totalCollateralValue
has property: collaterals
has property: liabilityValueUsd
has property: totalCollateralValueUsd

AccountPosition
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: account
has property: vault
has property: vaultType
has property: asset
has property: shares
has property: assets
has property: borrowed
has property: assetsValue
has property: debtValue

AccountPortfolioResponse
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: owner
has property: portfolio
has property: account
has property: errors
has property: freshness

PortfolioSavingsPosition
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: position
has property: vault
has property: subAccount
has property: shares
has property: assets
has property: suppliedValueUsd
has property: apy
has property: apyBreakdown

PortfolioBorrowPosition
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: borrow
has property: collaterals
has property: collateral
has property: borrowVault
has property: collateralVault
has property: collateralVaults
has property: subAccount
has property: healthFactor
has property: userLTV
has property: currentLTV

YieldApyBreakdown
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: lending
has property: borrowing
has property: rewards
has property: intrinsicApy
has property: total

SerializedPortfolioAccountPosition
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: account
has property: vaultAddress
has property: vault
has property: asset
has property: shares
has property: assets
has property: borrowed
has property: isController
has property: isCollateral
has property: balanceForwarderEnabled

SerializedPortfolioVault
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: address
has property: type
has property: asset
has property: shares
has property: supplyApy
has property: borrowApy
has property: supplyApy1h
has property: strategyCount

DataIssue
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: code
has property: severity
has property: message
has property: locations
has property: source
has property: originalValue
has property: normalizedValue

AccountActivity
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: type
has property: chainId
has property: vault
has property: assets
has property: shares
has property: txHash
has property: blockNumber
has property: timestamp

Token
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: address
has property: name
has property: symbol
has property: decimals
has property: logoURI
has property: priceUsd
has property: metadata
has property: groups
has property: tags

TokenMetadata
type: DefinedTerm
description: Protocol integration metadata for a token.
in defined term set: EulerFinanceVocabulary
has property: isPendlePT
has property: isPendleLP
has property: pendleMarket

Price
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: address
has property: symbol
has property: decimals
has property: priceUsd
has property: source
has property: confidence
has property: blockNumber
has property: timestamp

IntrinsicApy
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: address
has property: symbol
has property: apy
has property: provider
has property: source
has property: timestamp

RewardsApy
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: vault
has property: campaigns
has property: totalApr

RewardsApyHistoryPoint
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: vault
has property: rewardsApy
has property: timestamp

RewardBreakdown
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: vault
has property: recipient
has property: rewardToken
has property: amount
has property: campaignId
has property: timestamp

OracleAdapter
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: asset0
has property: asset1
has property: adapter
has property: element
has property: addedAt
has property: addedAtBlock
has property: txHash

IntrinsicApyHistoryPoint
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: timestamp
has property: apy
has property: provider
has property: apyDuration

IntrinsicApyHistoryMeta
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: asset
has property: symbol
has property: resolution
has property: startTimestamp
has property: endTimestamp
has property: timestamp

SwapPool
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: address
has property: token0
has property: token1
has property: tvlUsd

CollateralConfig
type: DefinedTerm
description: Current LTV configuration for a collateral vault
in defined term set: EulerFinanceVocabulary
has property: collateral
has property: vaultType
has property: collateralName
has property: collateralSymbol
has property: asset
has property: assetSymbol
has property: assetDecimals
has property: borrowLTV
has property: liquidationLTV
has property: initialLiquidationLTV

LtvHistoryItem
type: DefinedTerm
description: Historical LTV configuration change
in defined term set: EulerFinanceVocabulary
has property: collateral
has property: borrowLTV
has property: liquidationLTV
has property: initialLiquidationLTV
has property: borrowLtv
has property: liquidationLtv
has property: initialLiquidationLtv
has property: targetTimestamp
has property: rampDuration
has property: blockNumber

CapHistoryItem
type: DefinedTerm
description: Historical cap configuration change
in defined term set: EulerFinanceVocabulary
has property: supplyCap
has property: borrowCap
has property: blockNumber
has property: timestamp
has property: txHash
has property: logIndex

VaultCapHealthItem
type: DefinedTerm
description: Vault cap-usage health row
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: vault
has property: capUsage
has property: supplyCap
has property: supplyCapUsage
has property: borrowCap
has property: borrowCapUsage
has property: totalAssets
has property: totalBorrows
has property: thresholdExceeded

IrmHistoryItem
type: DefinedTerm
description: Historical interest rate model change
in defined term set: EulerFinanceVocabulary
has property: interestRateModel
has property: blockNumber
has property: timestamp
has property: txHash
has property: logIndex

ConfigHistoryItem
type: DefinedTerm
description: Generic configuration change event
in defined term set: EulerFinanceVocabulary
has property: type
has property: data
has property: blockNumber
has property: timestamp
has property: txHash
has property: logIndex

ApiKeyCreateRequest
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: name
has property: ownerEmail
has property: keyType
has property: scopeMode
has property: vaultAllowlist
has property: rateLimit
has property: expiresInDays

ApiKeyCreateResponse
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: message
has property: key
has property: keyPrefix
has property: id
has property: name
has property: keyType
has property: scopeMode
has property: vaultAllowlist
has property: rateLimit
has property: expiresAt

ApiKeyResponse
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: id
has property: keyPrefix
has property: name
has property: ownerEmail
has property: keyType
has property: scopeMode
has property: vaultAllowlist
has property: rateLimit
has property: isActive
has property: createdAt

ApiKeyUsageResponse
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: period
has property: summary
has property: endpoints

UsageStatsResponse
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: identifier
has property: key
has property: stats
has property: rateLimit

CuratorInfo
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: apiKeyId
has property: name
has property: keyPrefix

CuratorVaultLabel
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: vaultAddress
has property: curator
has property: displayName
has property: description
has property: productCategory
has property: riskTier
has property: strategyDescription
has property: updatedAt

PublicVaultLabel
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: vaultAddress
has property: displayName
has property: description
has property: productCategory
has property: riskTier
has property: strategyDescription
has property: updatedAt

VaultVisibility
type: DefinedTerm
in defined term set: EulerFinanceVocabulary
has property: chainId
has property: vaultAddress
has property: status
has property: checks
has property: source
has property: evaluatedAt