For the complete documentation index, see llms.txt. This page is also available as Markdown.

Get on-chain price feeds

Read live asset and Fan Token prices directly in your smart contracts.

Chiliz Chain provides an on-chain, institutional-grade price feed system that delivers reliable, tamper-resistant asset prices directly to smart contracts. It implements the Chainlink AggregatorV3Interface: any dApp already integrated with Chainlink data feeds can connect with minimal changes.

Price data is sourced from multiple major centralised exchanges, aggregated via VWAP (Volume Weighted Average Price), filtered for outliers, and pushed on-chain by a permissioned signer in a fully automated, high-frequency pipeline.

How It Works

The oracle system is built as a three-stage off-chain pipeline that continuously pushes validated prices into on-chain contracts.

Stage 1: Fetcher Pulls real-time market data from centralised exchanges via WebSocket streams (Binance, Bybit, Bitget, Mexc, OKX, BingX) and REST polling (Binance, Bybit, Bitget, Gate, Coinex), plus subgraph queries (FanX). All fetched prices are stored in an internal cache, ready for the Aggregator.

Stage 2: Aggregator Applies VWAP calculation, ensuring higher-liquidity venues are given more weight, then filters for outliers. Decides whether to submit an update on-chain based on two rules:

  • Deviation threshold: an update is submitted if the aggregated price has moved beyond a configured percentage (e.g. 0.5%) from the last on-chain value.

  • Heartbeat: even if the price hasn't moved beyond the deviation threshold, an update is forced once the maximum time interval has elapsed. This guarantees the feed is never stale.

Stage 3: Signer Receives validated price jobs from the Aggregator and submits them on-chain via Fireblocks, an institutional-grade signing solution. The Signer only acts when the Aggregator says a price is ready.

Contract System

Contract
Role

PriceFeed

One contract per trading pair. This is the contract your dApp reads from. Implements Chainlink AggregatorV3Interface.

OracleFactory

Registry and manager. Holds the authoritative mapping from pair symbol (e.g. "PSG/USDT") to oracle address.

OracleFactoryReader

Read-only convenience contract. Fetch all active oracle addresses, resolve multiple pairs, or check health status across the system in a single call.

The oracle contracts have been audited by Halborn (January 2026).

Contract Addresses

Network parameters for both Mainnet and Testnet are available in the Developer Toolbox.

Contract
Address

OracleFactory

Coming soon...

OracleFactoryReader

Coming soon...

The Price Oracle Tracker shows all available pairs with live prices, decimals, heartbeat parameters, and individual contract addresses.

Last updated

Was this helpful?