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
| Environment | Base URL |
|---|---|
| Mainnet | https://mainnet.proxy.ryze.pro |
| Testnet | https://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
| Method | Path | Description |
|---|---|---|
GET | /v2/updates/price/stream | SSE price stream (real-time) |
GET | /v2/updates/price/latest | Latest cached prices (one-shot) |
GET | /health | Service 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.25Blended 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"
}
}| Field | Description |
|---|---|
pythPrice | Pyth oracle price in WAD (1e18 = $1) |
cexPrice | CEX reference price in WAD |
blendFactor | Blend ratio in WAD: 0 = pure Pyth, 1e18 = pure CEX |
blendedPrice | Final 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:
| Token | Pyth Feed ID |
|---|---|
| ETH/USD | ff61491a931112ddf1bd8147cd1b641375f79f5825126d665480874634fd0ace |
| USDC/USD | eaa020c61cc479712813461ce153894a96a6c00b21ed0cfc2798d1f9a9e9c94a |
| cbBTC/USD | 2817d7bfe5c64b8ebd8cb2cb5f4f59c640453faa953a0f2f8067e0e83f4db8c9 |
| WETH/USD | 9d4294bbcd1174d6f2003ec365831e64cc31d9f6f15a2b85399db8d5000960f6 |