Skip to main content

Oracle Design

The oracle path bridges external market data into Ollo's onchain funding and risk logic.

Public Market-Data Statement​

Ollo's market-data path is designed to use Chainlink Data Streams for FX pricing.

Design Architecture​

  1. External FX market data enters the Quote Service from Chainlink Data Streams.
  2. The Quote Service normalizes and writes price data into Redis.
  3. The Oracle Service reads index prices from Redis and perp prices from onchain markets.
  4. The Oracle Service pushes prices to the onchain FundingRateOracle.
  5. Authorized keepers trigger funding-rate updates.

Confirmed Onchain Controls​

The current FundingRateOracle contract exposes:

  • perpPrice
  • indexPrice
  • lastUpdate
  • Authorized price updaters
  • Authorized keepers
  • Configurable alpha and beta parameters
  • A configurable maximum price age

The default maximum price age in the contract is five minutes.

Funding Dependency​

Funding updates rely on fresh price inputs. If prices are stale, the oracle should not continue updating funding as though the market state were current.

Fallback Posture​

Hierarchical feeds, sanity checks, weekend handling, and circuit-breaker logic are part of the broader design. A complete public fallback policy is not yet published, so the public description remains limited to the architecture above.

Any future IR-aware funding release would also require a public explanation of the rate-input path used for the carry component. The description above covers the FX price path only.