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 Earn API

Euler Earn vault resources and historical data. These endpoints are separate from EVK vaults and should be modeled independently in client code.

Euler Finance Earn 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 Earn. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and rate-limit docs.

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

Requests are made against a single base URL, /.

4 operations 4 paths 20 schemas 3 GET1 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 Earn 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 4

Across 4 paths, the API surfaces 4 operations — 3 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Earn 4

Euler Earn vault resources and historical data. These endpoints are separate from EVK vaults and should be modeled independently in client code.

GET
/v3/earn/vaults
Earn vaults
getEarnVaults 3 params → 200
POST
/v3/earn/vaults/batch
Earn vault batch
postEarnVaultBatch body → 200400404413415429500
GET
/v3/earn/vaults/{chainId}/{address}
Earn vault detail
getEarnVaultsByChainIdByAddress 3 params → 200400404429500
GET
/v3/earn/vaults/{chainId}/{address}/events
Unified Euler Earn vault event timeline
getEarnVaultsByChainIdByAddressEvents 7 params → 200400404429500

Schemas 20

The contract defines 20 schemas that model the data the API accepts and returns. The most detailed are EarnVaultSummary (22 properties), EarnStrategy (18 properties), EarnVaultGovernance (10 properties), Price (9 properties). Each schema is shown below with its type and property counts.

EarnVaultBatchMeta
object
5 properties
EarnVaultManagement
object
6 properties
EarnVaultBatchRequest
object
3 properties 2 required
EarnStrategyAllocationCap
object
3 properties
VaultApy
object
2 properties
VaultApyPoint
object
3 properties
EarnVaultBatchResponse
object
2 properties
EarnVaultSummary
object
22 properties
ErrorResponse
object
1 property 1 required
VaultTotals
object
2 properties
EarnVaultDetailsWithIncludes
EarnIncludePrices
object
1 property
EarnStrategy
object
18 properties
Price
object
9 properties
AssetRef
object
4 properties
EarnVaultBatchItem
EarnVaultDetails
PaginationMeta
object
6 properties 1 required
EarnVaultGovernance
object
10 properties
VaultTotalsPoint
object
7 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

euler-earn-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 Entities API
Euler Finance EVC API
Euler Finance FeeFlow API
Euler Finance GraphQL API