Euler Data API V3

Euler Data API V3 is a hosted HTTP API for querying indexed Euler protocol data. It is intended for dashboards, portfolio views, bots, risk systems, research workflows, and integrations that need protocol data without running their own indexer.

Use the interactive reference and OpenAPI document for the current API contract. Versioned clients should still tolerate documented deprecations, indexing lag, and service errors.

The interactive API reference is available at:

The OpenAPI document is the current source of truth for request parameters, response schemas, and endpoint availability:

Base URL

All public endpoints are versioned under /v3.

https://v3.euler.finance/v3

For example:

curl https://v3.euler.finance/v3/chains
curl "https://v3.euler.finance/v3/evk/vaults?chainId=1&limit=20"

When to use it

Use Euler Data API V3 when you need indexed, normalized data across Euler markets and chains. Common use cases include:

• Listing supported chains, tokens, EVK vaults, and EulerEarn vaults
• Reading vault details, totals, positions, holders, debt holders, labels, and visibility
• Querying account positions, sub-accounts, and activity
• Fetching token prices, historical prices, APYs, and rewards
• Monitoring liquidations, oracle state, governance actions, and indexed protocol events
• Building analytics workflows without managing RPC calls, event backfills, or local indexing infrastructure

For transaction construction or protocol reads that must exactly match current onchain state, use direct contract calls or lens contracts and simulate against the intended block. The Data API is optimized for offchain access, aggregation, and historical analysis.

Authentication and rate limits

The API can be queried without an API key. Unauthenticated requests are rate limited by IP address.

API keys can be sent with either X-API-Key or a bearer token and provide higher rate limits.

curl -H "X-API-Key: your-key" \
  "https://v3.euler.finance/v3/tokens"

Rate limit information is returned in response headers, including RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset.

Endpoint families

The API reference contains the full list of endpoints and schemas. At a high level, the API is organized around these resource families:

Response conventions

Responses use a consistent envelope. Successful list responses generally return data with optional pagination metadata:

{
  "data": [],
  "meta": {
    "total": 100,
    "limit": 20,
    "offset": 0,
    "timestamp": "2026-07-15T12:00:00.000Z"
  }
}

Errors return an error object with a stable code, message, and request id:

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid chain ID",
    "requestId": "req_abc123"
  }
}

Common field conventions:

Querying Off-Chain Prices

When building analytics tools, dashboards, or performing off-chain calculations (such as collateral market value), you often need up-to-date asset prices.

Fetching Prices from the Euler V3 API

Euler Data API V3 serves current and historical USD prices for assets used across Euler deployments:

# Current prices for one or more assets (comma-separated)
curl "https://v3.euler.finance/v3/prices?chainId=1&addresses=0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0,0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
 
# Current price for a single token
curl "https://v3.euler.finance/v3/tokens/1/0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0/price"
 
# Historical prices over a time range (Unix seconds)
curl "https://v3.euler.finance/v3/prices/history?chainId=1&addresses=0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0&from=1750000000&to=1752000000"

Prices are returned as USD numbers (not fixed-point integers), together with a provider-redacted source category and timestamp. The source value is one of onchain, offchain, or hardcoded; the response does not include a confidence field:

{
  "data": [
    {
      "chainId": 1,
      "address": "0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0",
      "symbol": "wstETH",
      "decimals": 18,
      "priceUsd": 2323.31,
      "source": "offchain",
      "timestamp": "2026-07-14T16:11:24.895Z"
    }
  ]
}

Use the interactive API reference for exact parameters and schemas.

Context: Why Use Off-Chain Prices?

In some cases, protocol risk managers configure oracles that do not directly reflect the current market price. For example, they may use hardcoded values for certain assets, or rely on oracles (such as Chainlink) that are naturally lagging behind the market due to heartbeat intervals or update thresholds. This means the on-chain price used for risk management and liquidations may differ from the real-time market price.

For analytics, risk assessment, or user interfaces, you may want to use a more up-to-date or market-reflective price. Off-chain prices can help you calculate the real-time market value of a collateral position and provide users with more accurate portfolio valuations.

Data API price values are for display and analytics. They are not necessarily the configured oracle values a vault uses for solvency or liquidation. For execution-sensitive checks, read the vault's deployed oracle path or the relevant lens at the intended block. Verify chain, token, quote unit, timestamp, and units before consuming any value.

Read next

• Data querying overview
• Build
• Lens contracts