Concepts › Price oracle
BTC/USD — BtcwPriceFeed
Contract 0x6E0687A5D5a5b98CC5fb05c4d8d742fBD75ba96c, Chainlink AggregatorV3Interface-compatible, 8 decimals.
- The feeder takes the median of 6 sources: Chainlink BSC, Chainlink ETH, Binance, Coinbase, Kraken, OKX.
- At least 3 sources must be live. It writes on-chain when the price deviates by at least 0.05% from the on-chain price, or at most every 30 seconds even if the price is unchanged.
- Price-jump guard: no single update may move the price more than 10% from the previous one (
PriceJumpTooLarge) — even a compromised feeder key cannot move the price far in one write. - Only the
updateraddress can write (NotUpdater); the Owner hasownerSubmitfor manual writes and can change the updater and the jump limit.
BtcwPriceFeed provides the BTC/USD price. BTCw price = this price × OracleAMM's peg ratio ratioWad (currently 1).
345 price-tracker tokens — PriceHub
Contract 0xE87FDdCC0b668564a20B23F3bE1EE108C805ecb4, 18 decimals. Each token's price is the median across multiple sources (at least 3, discarding any source more than 2% from the median) — if one source goes down, others remain. Each class has its own source set:
- Crypto (100): multiple major crypto exchanges.
- US stocks and ETFs (202 + 20): during the US regular session, 6 public quote sources — Robinhood, Yahoo Finance, CNBC, TradingView, Nasdaq and Binance's stock list
(Nasdaq has no ETFs, so ETFs have 5); at least 3 must agree. These are
unofficial public APIs of those sites and may change or be blocked. The price is the regular-session price ×
splitFactor. - Pre-IPO (2, since 7 Oct 2026): OPENAIw follows the OpenAI pre-IPO perpetual
io:OAIand ANTHw (since 8 Oct) the Anthropic pre-IPO perpetualio:ANTH, both on Hyperliquid (HIP-3 market "io", traded 24/7; OPENAIw since 8 Oct 2026) — not shares of either company. Each price is its perp's mark price, used only while the perp's 24h volume is at least 250,000 USD and the mark is within 2% of that market's oracle price; it may move at most 20% per 10 minutes; otherwise the last price is kept. Before 8 Oct OPENAIw followed the "OPENAI Pre IPO Token" on Robinhood Chain (DEX pools via GeckoTerminal and DexScreener). - Metals, indices, commodities, FX (21, since 9 Oct 2026): the markets of Himbit's Metals, Indices, Commodities and FX tabs, each following its
Hyperliquid HIP-3 perpetual —
xyz:GOLD,xyz:SILVER,xyz:COPPER,xyz:PLATINUM,xyz:PALLADIUM,xyz:XYZ100,xyz:SP500,xyz:JP225,xyz:KR200,para:BTCD,para:OTHERS,para:TOTAL2,para:10Y,para:2Y,para:30Y,xyz:CL,xyz:NATGAS,xyz:BRENTOIL,xyz:JPY,xyz:EUR,xyz:GBP— with the same rules as the pre-IPO trackers, except the 24h volume floor: 250,000 USD by default, 100,000 USD for PALLADIUM, KR200, OTHERS, TOTAL2 and 10Y, and 20,000 USD for the thin BTCD, 2Y, 30Y and GBP markets. The price is the perp's own number: JPYw is USD/JPY (yen per dollar), 10Yw / 2Yw / 30Yw are yields in percent, BTCDw is Bitcoin dominance in percent, OTHERSw / TOTAL2w are market values in billion USD.
Stocks outside US hours (since 6 Oct 2026)
Prices keep updating after hours, overnight and at weekends. 206 of the 222 tickers have an off-hours source:
- 134 from equity perpetual markets (Binance, Hyperliquid HIP-3, Bitget, Gate, MEXC, Bybit, OKX), OKX spot stock tokens
(
X<TICKER>-USDT, 1 token = 1 share, traded around the clock including weekends: 33 reviewed tickers, plus the token of any other ticker that already has at least 2 other markets, used while its 24h volume is at least $50k) and Robinhood extended hours; - 40 from a same-index or same-sector reference, e.g. GOOG from GOOGL, IVV from SPY, ITUB from EWZ (ETFs with their own overnight quote, below, use that first and this reference as the fallback);
- 22 ADRs from their home listing × the FX rate (for example ICICI Bank in Mumbai × INR for IBN, Toyota in Tokyo × JPY for TM);
- 25 from Binance's public stock quote (its overnight session), the mid of bid and ask: 11 stocks — VFS (VinFast Auto), BRK-B, VZ, T, WM, CB, DUK, PM, NEE, UNP, SYK — and 14 ETFs — VOO, IVV, VTI, SPYM, BND, VGT, GLD, XLK, VUG, IEFA, VXUS, IEMG, AGG, VTV. BRK-B and the 14 ETFs also have a route above, so 206 counts them once. When the overnight book turns wide, the last tight quote is reused for up to 30 minutes; after that a ticker uses its other route if it has one, otherwise it keeps the close.
The other 16 keep the latest close until the US session opens (their Binance overnight books are too wide). Guards on every off-hours price:
- Per market: a perpetual or spot stock-token market with less than $50k of 24h volume, or a spread wider than 1.5% (the same spread limit applies to the Binance stock quote), is ignored; the remaining markets still count.
- Per ticker: if no market is left, a reference or home quote is missing, or the price is more than 15% from the last US close, the token keeps its last regular-session close. A partial result is never used.
- On chain: PriceHub refuses any single update that moves the price more than 10% (a
Rejectedevent, see below). - At the US open every ticker returns to the median of the 5 regular-session sources.
The feeder only prices tokens on each class's list — unknown tokens in the factory are skipped, never guessed from their symbol. It writes when the price deviates by at least 0.1%, or at most every 180 seconds. There is also a per-write jump guard; a blocked write emits a Rejected event instead of reverting the whole batch.
function latestRoundData(address asset) view returns (uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound)
function prices(address[] assets) view returns (int256[] answers, uint256[] updatedAts)
Full signatures: Contract reference.
Staleness and when to stop
OracleAMM and OracleRebalancer stop trading when the price is older than 300 seconds. Your application should do the same:
- REST: check
staleandage_secondsin/api/price; for tokens,priceAgeSin/api/v2/pools. - On-chain: compare
updatedAtwith the block timestamp; do not use a price that is too old.
If the feeder stops (server failure, all sources failing at once), the price freezes — nothing on-chain updates it automatically.
Oracle risks
- The 10%-per-write jump guard limits speed, not direction: several consecutive writes can still move the price far.
- The Owner can change the updater and the jump limit, with no delay.