Euler V3 API Preview

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

Because the API is in preview, endpoint behavior and response schemas may change as the service evolves. Use the interactive reference and OpenAPI document for the current API surface.

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 the V3 API Preview when you need indexed, normalized data across Euler markets and chains. Common use cases include:

• Listing supported chains, tokens, EVK vaults, and Euler Earn 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 on-chain state, direct contract calls and lens contracts may still be more appropriate. The V3 API Preview is optimized for off-chain data 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.

To request an API key for faster interaction with the preview API, or to share feedback on the V3 API, contact [email protected].

curl -H "X-API-Key: your-key" https://v3.euler.finance/v3/tokens
curl -H "Authorization: Bearer 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
  }
}

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:

Working With the API Reference

Start with the interactive docs when building a new integration. It exposes the current endpoint list, request parameters, example responses, and OpenAPI schemas in one place:

Open the Euler V3 API Preview Reference

For generated clients, schema validation, or automated tests, use the OpenAPI document directly:

Open the Euler V3 OpenAPI document