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

Reward campaign APRs and per-account reward breakdowns. Rewards APY is intentionally separate from base vault APY in v3; combine them client-side when you need a legacy-style total supply APY.

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

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

Requests are made against a single base URL, /.

3 operations 3 paths 5 schemas 3 GET

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 Rewards 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 3

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

Rewards 3

Reward campaign APRs and per-account reward breakdowns. Rewards APY is intentionally separate from base vault APY in v3; combine them client-side when you need a legacy-style tota…

GET
/v3/apys/rewards
Rewards APYs
getApysRewards 2 params → 200
GET
/v3/apys/rewards/history
Rewards APY history
getApysRewardsHistory 7 params → 200400404429500
GET
/v3/rewards/breakdown
Per-user reward breakdowns
getRewardsBreakdown 3 params → 200

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are PaginationMeta (6 properties), AssetRef (4 properties), RewardsApyHistoryPoint (4 properties), RewardsApy (4 properties). Each schema is shown below with its type and property counts.

PaginationMeta
object
6 properties 1 required
RewardsApy
object
4 properties
ErrorResponse
object
1 property 1 required
RewardsApyHistoryPoint
object
4 properties
AssetRef
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

euler-rewards-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