Skip to main content

Mainnet Price Oracles

Chain ID: 1
Total Oracles: 37

Overview​

Mainnet hosts the largest number of Harbor price oracles, including v3, v4, and leverage v4 oracle contracts. Most v3 contracts use a proxy pattern for upgradeability.

Oracles are grouped the same way as markets: by haToken, then one page per collateral (plus related hs / sUSDe / deprecated feeds under that haToken).

When a pair lists both a market-wired address (on the minter / market page) and an inventory-only alias, treat the market-wired address as primary for integrations. Keep inventory-only addresses as secondary references.

To add a new aggregator: add mainnet/<hatoken>/<collateral>.md, update that haToken index.md, and add a sidebar entry.

By haToken​

haTokenMarket collateralsIndex
haETHfxUSDhaETH oracles
haBTCfxUSD, stETHhaBTC oracles
haEURfxUSD, stETHhaEUR oracles
haGOLDfxUSD, stETHhaGOLD oracles
haSILVERfxUSD, stETHhaSILVER oracles
haMCAPfxUSD, stETHhaMCAP oracles
haUSDstETH, PAXG, wBTC, tBTChaUSD oracles

haETH​

OracleAddressStatusVersion
fxUSD0x71437C90F1E0785dd691FD02f7bE0B90cd14c097 (market-wired; inventory also 0xea5292…)Activev3
hs fxUSD0xA8643E35Ef119F983B09C322039e8AA49A3e3372Activev4 leverage
sUSDe0x969Fb67331d6Fa3E729292FAa5752BBA759f2b7FActivev4

haBTC​

OracleAddressStatusVersion
fxUSD0xF7657CD7890904d108384E289997c993e2e2bBc0Activev3
stETH0x42018953e5174dC07058BeEE0618aa569fbFBE90Activev3
hs fxUSD0xF36648F44763eFE7c528140a2f804b2124CC3FE1Activev4 leverage
hs stETH0xFf37Db6dea33228A5D84546250a5D0D0da942fd7Activev4 leverage
sUSDe0x0D0fDBb10B9EAf18A1034e9942F95af0147CC310Activev4

haEUR​

OracleAddressStatusVersion
fxUSD0x305454F8B46Aa3485D8B350D8E832459974F5e9FActivev3
stETH0x5e27965689B4B8B425d98fbc676fE22d74caf7C7Activev3
hs fxUSD0x657bE7a2b91F95222D163Bee3B5F4C27bed598C5Activev4 leverage
hs stETH0x777BD12e1f61B8cac19Cbd30c0233C46B4683C00Activev4 leverage
sUSDe0xDA6097f2b8805a01FcBE8BA8Fc2c45FCb7D3e206Activev4

haGOLD​

OracleAddressStatusVersion
fxUSD0x1f7F62889E599E51b9e21B27d589Fa521516D147Activev3
stETH0x4ebde6143C5E366264ba7416FdEa18BC27C04A31Activev3
hs fxUSD0x652E9B0ad84fD2A0c3806129bDbDEF4585bb29e8Activev4 leverage
hs stETH0x34dfDF00262E1A3b61c7a0616F0645A928Dd8187Activev4 leverage
sUSDe0x5C38C744CfF6ec051d955566384BF921CFAaAc26Activev4
fxUSD/XAU0xd71538769Af1c8f4D663BD0a5eA667D67E1623e2Deprecatedv3
stETH/XAU0x2962ECcF1B9cc46FE1aFf7bfc0f7179Fc87939eeDeprecatedv3
sUSDe/XAU0xA8A130Bbf041962B60e81009F09C41bd930D1294Deprecatedv4

haSILVER​

OracleAddressStatusVersion
fxUSD0x14816ff286f2eA46AB48c3275401Fd4b1ef817B5Activev3
stETH0x7223E17bD4527AcbE44644300eA0F09A4AeBC995Activev3
hs fxUSD0x70387587a0d3A01a2C75904Dd8CA355a921cd1F3Activev4 leverage
hs stETH0x50E198a8Fa7e4c95B355E34cba026133F68D1637Activev4 leverage
sUSDe0x7A4AC7b91bCbd069Fa0B45bdb5e393915A663cfDActivev4
fxUSD/XAG0xB4E46a2E299F28FFa86BaeE19201B1BB9cd4c153Deprecatedv3
stETH/XAG0x7FE8D4590A5aa0C8bdcA581BBc30d68aB59Dad78Deprecatedv3
sUSDe/XAG0x436C33222136554192733C6771669c4B51B7fE3DDeprecatedv4

haMCAP​

OracleAddressStatusVersion
fxUSD0x88430c0F09A6D603c43E2816F2EA9Ab45dB7e1a8Activev3
stETH0x4fe6fa14db0D3C8a4709A4F3e37C1c862381859FActivev3
sUSDe0xf2ac2880E1569D2CaB50be41F6bfA92e5e6e03C9Activev4

haUSD​

App-wired addresses for the mainnet USD stack (contracts.mainnetUsd.ts). Earlier inventory addresses are listed as aliases on each detail page.

OracleAddressStatusVersion
stETH0xcE8633B7198d02860873689Bb2566BD2efD11F52Activev4
PAXG0x647633122f9d9ba87210210d5A3ded365911BF9bActivev4
wBTC0x189d6CA0271F06c222873b4C09A26C83AdCCF73dActivev4
tBTC0x4D72FfE2499C4e66b2c6C11D7AfeA04001dB440CActivev4
wstETH0x28bBAaf05dEE8A06d4206089bCd17c1129e6EdcaActivev4 inventory

Market Integration​

Prefer the market-wired address on each pair / market page as the primary integration target. Where an inventory-only alias is also listed (notably some early ETH/BTC markets), treat it as a secondary reference only. Consumers:

Oracle pairMarket doc(s)
fxUSD/ETHhaETH / fxUSD
fxUSD/BTChaBTC / fxUSD
stETH/BTChaBTC / stETH
fxUSD/EURhaEUR / fxUSD
stETH/EURhaEUR / stETH
fxUSD/GOLDhaGOLD / fxUSD
stETH/GOLDhaGOLD / stETH
fxUSD/SILVERhaSILVER / fxUSD
stETH/SILVERhaSILVER / stETH
fxUSD/MCAPhaMCAP / fxUSD
stETH/MCAPhaMCAP / stETH
stETH/USDhaUSD / stETH
PAXG/USDhaUSD / PAXG
wBTC/USDhaUSD / wBTC
tBTC/USDhaUSD / tBTC

Version Information​

  • v3 Contracts: Use proxy pattern for upgradeability
  • v4 Contracts: Direct implementation (no proxy)
  • v4 Leverage Contracts: Specialized for leveraged token pricing

Pending: Harbor Yield ETH-peg oracles​

harbor-price-aggregators PR #4 (harbor-yield) adds CREATE3-wired mainnet helpers for Harbor Yield valuation — not yet in the inventory tables above until merge + deploy:

PairRole
ETH/ETHConstant 1e18 peg
Peg/ETHpeg_USD / ETH_USD
stETH/ETHstETH/ETH + wstETH rate
BTC/EUR/GOLD/MCAP/SILVER → ETHPeg→ETH wrappers

See Harbor Yield.

Notes​

  • Deprecated oracles (XAU/XAG) live under haGOLD / haSILVER and have been replaced by GOLD/SILVER naming for active markets
  • Most v3 contracts are upgradeable via proxy pattern
  • Leverage oracles track NAV of leveraged tokens for pricing