Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Euler Finance Vaults API

Canonical vault resources, vault history, holders, borrowers, and open-interest views. In v3, vault detail is decomposed into focused endpoints instead of one large legacy response.

Euler Finance Vaults API is one of 24 APIs that Euler Finance publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Vaults. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and rate-limit docs.

This API exposes 22 operations across 21 paths, and defines 47 schemas. It is described by OpenAPI 3.1.0, at version 3.0.0.

Requests are made against a single base URL, /.

22 operations 21 paths 47 schemas 20 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
3.0.0
Base URL
https://v3.euler.finance/v3
Authentication
API Key, HTTP Bearer, API Key, API Key, API Key
Resource Areas
1

Authentication & Security 5

Euler Finance Vaults API declares 5 security schemes for authenticating requests. An API key is passed in the header as X-API-Key (ApiKeyAuth). It accepts HTTP bearer tokens (API key) (BearerAuth). An API key is passed in the header as X-Admin-Secret (AdminSecret). An API key is passed in the cookie as euler_platform_session (PlatformSession). An API key is passed in the header as X-CSRF-Token (PlatformCsrf).

  • ApiKeyAuth — API key authentication (optional; higher rate limits).
  • BearerAuth — Alternative to X-API-Key using Authorization: Bearer
  • AdminSecret — Admin secret (server-to-server) for API key management.
  • PlatformSession — Signed, httpOnly platform-operator browser session cookie.
  • PlatformCsrf — Double-submit CSRF token required for unsafe cookie-authenticated methods.

Paths & Operations 22

Across 21 paths, the API surfaces 22 operations — 20 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Vaults 22

Canonical vault resources, vault history, holders, borrowers, and open-interest views. In v3, vault detail is decomposed into focused endpoints instead of one large legacy respons…

GET
/v3/evk/vaults
List vaults
getVaults 9 params → 200
POST
/v3/evk/vaults/batch
Batch vault details
postEvkVaultBatch body → 200400404413415429500
GET
/v3/resolve/vaults
Resolve a vault address to its family
getVaultResolve 2 params → 200404
POST
/v3/resolve/vaults
Resolve multiple vault addresses to their families
postVaultResolve body → 200413415
GET
/v3/evk/vaults/health/utilization
Vault utilization health
getVaultsHealthUtilization 5 params → 200400404429500
GET
/v3/evk/vaults/health/caps
Vault cap usage health
getVaultsHealthCaps 5 params → 200400404429500
GET
/v3/evk/vaults/{chainId}/{address}
Vault details
getVaultsByChainIdByAddress 4 params → 200
GET
/v3/evk/vaults/{chainId}/{address}/labels
Public curator labels for a vault
getVaultsByChainIdByAddressLabels 2 params → 200400404429500
GET
/v3/evk/vaults/{chainId}/{address}/visibility
Deterministic visibility status for a vault
getVaultsByChainIdByAddressVisibility 2 params → 200400404429500
GET
/v3/evk/vaults/{chainId}/{address}/positions
Positions in a vault
getVaultsByChainIdByAddressPositions 6 params → 200
GET
/v3/evk/vaults/{chainId}/{address}/config-history
Vault configuration history
getVaultsByChainIdByAddressConfigHistory 7 params → 200
GET
/v3/evk/vaults/{chainId}/{address}/collaterals
Current accepted collaterals with LTV configurations
getVaultsByChainIdByAddressCollaterals 2 params → 200404
GET
/v3/evk/vaults/{chainId}/{address}/ltv-history
Vault LTV history
getVaultsByChainIdByAddressLtvHistory 7 params → 200
GET
/v3/evk/vaults/{chainId}/{address}/cap-history
Vault cap history (supply/borrow)
getVaultsByChainIdByAddressCapHistory 6 params → 200
GET
/v3/evk/vaults/{chainId}/{address}/irm-history
Vault interest rate model history
getVaultsByChainIdByAddressIrmHistory 6 params → 200
GET
/v3/evk/vaults/{chainId}/{address}/events
Unified core vault event timeline
getVaultsByChainIdByAddressEvents 7 params → 200400404429500
GET
/v3/evk/vaults/{chainId}/{address}/totals
Vault totals with historical series
getVaultsByChainIdByAddressTotals 6 params → 200
GET
/v3/evk/vaults/{chainId}/{address}/holders
Vault share holders
getVaultsByChainIdByAddressHolders 7 params → 200
GET
/v3/evk/vaults/{chainId}/{address}/debt-holders
Vault debt holder candidates
getVaultsByChainIdByAddressDebtHolders 4 params → 200
GET
/v3/evk/vaults/open-interest
Open interest across vaults
getVaultsOpenInterest 4 params → 200
GET
/v3/evk/vaults/open-interest/by-collateral
Collateral-covered debt by collateral vault
getVaultsOpenInterestByCollateral 1 param → 200
GET
/v3/evk/vaults/bad-debt
Bad debt by borrow vault
getVaultsBadDebt 5 params → 200

Schemas 47

The contract defines 47 schemas that model the data the API accepts and returns. The most detailed are VaultDetailResponse (43 properties), Vault (16 properties), VaultHookedOperations (15 properties), LtvHistoryItem (13 properties). Each schema is shown below with its type and property counts.

CollateralConfigWithPrice
VaultVisibility
object
6 properties 6 required
VaultFees
object
6 properties
CollateralConfig
object
Current LTV configuration for a collateral vault
12 properties
OracleDetailedInfo
object
3 properties
VaultHooks
object
2 properties
VaultCapHealthItem
object
Vault cap-usage health row
10 properties
SubAccount
object
5 properties 5 required
EvkVaultBatchRequest
object
3 properties 2 required
VaultApy
object
2 properties
VaultApyPoint
object
3 properties
LtvHistoryItem
object
Historical LTV configuration change
13 properties
VaultIncludePrices
object
2 properties
VaultDetailResponse
object
Single-vault detail response shape for GET /v3/evk/vaults/{chainId}/{address}.
43 properties
VaultTotalsFreshness
object
10 properties
ErrorResponse
object
1 property 1 required
OracleInfo
object
5 properties
VaultPosition
object
5 properties
VaultDetailResponseWithIncludes
VaultTotalsMeta
VaultLiquidation
object
3 properties
VaultTotals
object
2 properties
OracleResolvedVault
object
4 properties
Vault
object
16 properties
OracleAdapterPythDetail
object
6 properties
VaultResolveEntry
object
7 properties
VaultDetailsWithIncludes
VaultInterestRates
object
Contract interest-rate values formatted as decimal strings in fraction units, not public percent APY numbers.
3 properties
OracleAdapterChainlinkDetail
object
1 property
Price
object
9 properties
VaultCollateralDetail
AssetRef
object
4 properties
VaultCaps
object
2 properties
OraclePriceRaw
object
Exact oracle quote values returned by contracts, represented as raw integer strings in the oracle unit-of-account scale.
7 properties
VaultInterestRateModel
object
3 properties
VaultHookedOperations
object
15 properties
VaultDetails
ConfigHistoryItem
object
Generic configuration change event
6 properties
CapHistoryItem
object
Historical cap configuration change
6 properties
IrmHistoryItem
object
Historical interest rate model change
5 properties
PaginationMeta
object
6 properties 1 required
EvkVaultBatchResponse
object
2 properties
PublicVaultLabel
object
8 properties 4 required
OracleAdapterEntry
object
6 properties
VaultApyMeta
object
6 properties
VaultTotalsPoint
object
7 properties
EvkVaultBatchMeta
object
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

euler-vaults-api-openapi.yml Raw ↑

Other APIs Euler Finance publishes across the network.

Euler Off-Chain Prices API
Euler Subgraphs (GraphQL)
Euler V2 TypeScript SDK
Euler Finance Accounts API
Euler Finance APYs API
Euler Finance Auth API
Euler Finance Chains API
Euler Finance Curator API
Euler Finance Earn API
Euler Finance Entities API
Euler Finance EVC API
Euler Finance FeeFlow API