Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Getting Lists of Known Vaults

Euler vaults are permissionless: anyone can deploy one. Integrators, dashboards, and analytics tools therefore need a way to distinguish known vaults from unknown or experimental ones. Euler provides public HTTP endpoints for this — the same vault lists and metadata used by the Euler app.

Public Endpoints for Known Vaults

The endpoints are hosted at https://app.euler.finance/api/public and require no API key. Requests are rate limited per IP, and responses are cacheable for short periods (about 30 seconds). Addresses must be valid EIP-55 checksummed or all-lowercase hex; response keys are always checksummed.

Check or List Known Vaults

GET /api/public/is-known returns whether addresses are known vaults on a given chain:

curl "https://app.euler.finance/api/public/is-known?chainId=1&addresses=0x797DD80692c3b2dAdabCe8e30C07fDE5307D48a9"
{
  "0x797DD80692c3b2dAdabCe8e30C07fDE5307D48a9": true
}
  • chainId (required): the chain to check against
  • addresses (optional): comma-separated list of up to 100 addresses

Omit addresses to get the full known set for the chain, returned as an object with true values:

curl "https://app.euler.finance/api/public/is-known?chainId=1"

Fetch Vault Metadata

GET /api/public/metadata returns display metadata for known vaults — name, description, vault type, deprecation status, product, underlying asset, and the entities (curators) behind it:

curl "https://app.euler.finance/api/public/metadata?chainId=1&addresses=0x797DD80692c3b2dAdabCe8e30C07fDE5307D48a9"
{
  "0x797DD80692c3b2dAdabCe8e30C07fDE5307D48a9": {
    "chainId": 1,
    "address": "0x797DD80692c3b2dAdabCe8e30C07fDE5307D48a9",
    "type": "evk",
    "name": "K3 Capital Prime Market",
    "description": "A lending and borrowing market for stablecoin-denominated assets and selected collateral, configured by K3 Capital",
    "portfolioNotice": null,
    "deprecationReason": null,
    "deprecated": false,
    "governanceLimited": false,
    "productId": "k3-prime",
    "asset": {
      "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "symbol": "USDC",
      "name": "USD Coin",
      "decimals": 6,
      "url": "https://token-images.euler.finance/1/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
    },
    "entities": [
      {
        "name": "K3 Capital",
        "logo": "https://labels.euler.finance/master/logo/k3.svg",
        "description": "K3 Capital is a third-party curator using Euler infrastructure...",
        "url": "https://k3.capital/"
      }
    ]
  }
}
  • chainId (required): the chain to query
  • addresses (optional): comma-separated list of up to 100 addresses; unknown addresses return null
  • productId (optional): only return vaults belonging to a given product slug (e.g. k3-prime)

Omit addresses to list metadata for every known vault on the chain. type is one of evk (borrowable vault), earn (EulerEarn vault), or securitize (Securitize collateral vault).

Typical Integration Flow

  1. Discover vault and account addresses from the subgraph, lens contracts, or the Euler V3 API.
  2. Filter the vault list through /api/public/is-known to keep only known vaults.
  3. Enrich the results with names, curator entities, and deprecation status from /api/public/metadata — in particular, check deprecated before presenting a vault as active.

Underlying Data: euler-labels

The vault lists and metadata served by these endpoints are derived from the euler-labels repository, which is maintained by the Euler Labs team and acts as the source of truth for vault labels, products, entities, and known-vault status. You can consume the repository directly if you prefer to build your own view of the data.

Legacy: On-Chain Perspectives