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

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

The Euler V3 API serves current and historical USD prices for all 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 the price source, a confidence value, and a timestamp:

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

See the Euler V3 API page for authentication, rate limits, and response conventions, and 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.