Skip to content

Price Proxy Reference

The Ryze Price Proxy serves real-time execution prices used by the protocol. It streams low-latency price data from Pyth Pro (Lazer) and optionally blends it with CEX reference prices, exposing a Hermes-compatible API.

Base URLs

EnvironmentBase URL
Mainnethttps://mainnet.proxy.ryze.pro
Testnethttps://sepolia.proxy.ryze.pro

Why Use the Proxy?

  • Execution prices: Returns the same blended prices the Ryze Router uses for quote calculations
  • Hermes-compatible: Drop-in replacement for hermes.pyth.network -- same SSE and REST format
  • Low latency: Powered by Pyth Pro (Lazer) with ~200ms updates
  • No API key needed: The proxy handles Pyth Pro authentication internally

Endpoints

MethodPathDescription
GET/v2/updates/price/streamSSE price stream (real-time)
GET/v2/updates/price/latestLatest cached prices (one-shot)
GET/healthService health and diagnostics

Price Format

Prices follow the standard Pyth format:

json
{
  "id": "ff61491a931112ddf1bd8147cd1b641375f79f5825126d665480874634fd0ace",
  "price": {
    "price": "160025000000",
    "conf": "0",
    "expo": -8,
    "publish_time": 1713200000
  },
  "ema_price": {
    "price": "160025000000",
    "conf": "0",
    "expo": -8,
    "publish_time": 1713200000
  }
}

To convert to a human-readable price:

javascript
// price = raw * 10^expo
const raw = BigInt("160025000000");
const expo = -8;
const price = Number(raw) * Math.pow(10, expo);
// = 1600.25

Blended Prices

When blending is active, each price includes a blend field showing how the execution price is computed:

json
{
  "id": "ff61491a...",
  "price": { "price": "160027500000", "conf": "0", "expo": -8, "publish_time": 1713200000 },
  "ema_price": { ... },
  "blend": {
    "token": "0x4200000000000000000000000000000000000006",
    "pythPrice": "1600250000000000000000",
    "cexPrice": "1600300000000000000000",
    "blendFactor": "500000000000000000",
    "blendedPrice": "1600275000000000000000"
  }
}
FieldDescription
pythPricePyth oracle price in WAD (1e18 = $1)
cexPriceCEX reference price in WAD
blendFactorBlend ratio in WAD: 0 = pure Pyth, 1e18 = pure CEX
blendedPriceFinal execution price in WAD

The blended price is what the Ryze Router uses for swap calculations.

Feed IDs

Get feed IDs from the assets endpoint. Common feeds:

TokenPyth Feed ID
ETH/USDff61491a931112ddf1bd8147cd1b641375f79f5825126d665480874634fd0ace
USDC/USDeaa020c61cc479712813461ce153894a96a6c00b21ed0cfc2798d1f9a9e9c94a
cbBTC/USD2817d7bfe5c64b8ebd8cb2cb5f4f59c640453faa953a0f2f8067e0e83f4db8c9
WETH/USD9d4294bbcd1174d6f2003ec365831e64cc31d9f6f15a2b85399db8d5000960f6