Reading Market Data with Oracles

Mezo provides market data through two oracle systems: Skip Connect for BTC/USD and Pyth Network for additional price feeds.

Overview

Skip Oracle

The Skip oracle provides native BTC/USD price feeds on Mezo through a Chainlink-compatible aggregator interface.

• Contract address: 0x7b7c000000000000000000000000000000000015 (mainnet and testnet)
• Supported pair: BTC/USD only
• Interface: Chainlink Aggregator

Pyth Oracle

The Pyth oracle provides multiple price feeds beyond BTC/USD.

• Contract address: 0x2880aB155794e7179c9eE2e38200202908C17B43 (mainnet and testnet)
• Interface: Pyth EVM contract
• Update frequency: Every 1 hour or 1% price deviation
• Recommended method: getPriceNoOlderThan()

Best Practices

When building dApps that consume oracle data, follow these guidelines:

• Validate freshness: Always check timestamps and block numbers to detect stale data. Set appropriate staleness thresholds for your use case.
• Set price bounds: Implement sanity checks on price values to detect anomalies or manipulation attempts.
• Monitor market conditions: Be aware of volatility, liquidity, and potential manipulation events that may require pausing your application.
• Security audits: Ensure your contracts and dependencies meet security standards. Audit code that handles oracle data to prevent exploits.

Reading Price Feeds

Using Skip Oracle (BTC/USD)

The Skip oracle implements a Chainlink-compatible interface. Call latestRoundData() to retrieve the latest price:

Contract: 0x7b7c000000000000000000000000000000000015

Return values:

• roundId: The round ID when the price was updated
• answer: The BTC/USD price (use decimals() to get the decimal precision)
• startedAt: Unix timestamp when the round started
• updatedAt: Unix timestamp when the round was last updated

Using Pyth Oracle (Multiple Feeds)

Pyth provides multiple price feeds through its EVM contract. Use getPriceNoOlderThan() to fetch prices with built-in staleness checks.

Contract Mezo Mainnet: 0x2880aB155794e7179c9eE2e38200202908C17B43

Contract Mezo Testnet: 0x2880aB155794e7179c9eE2e38200202908C17B43

Example (Solidity):

import "@pythnetwork/pyth-sdk-solidity/IPyth.sol";
import "@pythnetwork/pyth-sdk-solidity/PythStructs.sol";

contract ReadPythPrice {
    IPyth public immutable pyth;

    constructor(address pythContract) {
        pyth = IPyth(pythContract); // 0x2880aB155794e7179c9eE2e38200202908C17B43 on Mezo
    }

    function getPrice(bytes32 priceId, uint256 maxAgeSeconds)
        external
        view
        returns (int64 price, uint64 conf, int32 expo, uint256 publishTime)
    {
        PythStructs.Price memory priceData = pyth.getPriceNoOlderThan(priceId, maxAgeSeconds);
        return (priceData.price, priceData.conf, priceData.expo, priceData.publishTime);
    }

    // Example: Get MUSD/USD price
    function getMUSDPrice() external view returns (int64, uint256) {
        bytes32 musdPriceId = 0x0617a9b725011a126a2b9fd53563f4236501f32cf76d877644b943394606c6de;
        PythStructs.Price memory price = pyth.getPriceNoOlderThan(musdPriceId, 3600); // Max 1 hour old
        return (price.price, price.publishTime);
    }
}

Reference: getPriceNoOlderThan API documentation

Offchain Price Data

You can query price feeds and metadata directly from the Pyth Network without interacting with the blockchain:

• Hermes API: https://hermes.pyth.network/docs/#/rest/price_feeds_metadata
• Price feed IDs: https://docs.pyth.network/price-feeds/price-feeds#feed-ids

Available Price Feeds

Skip Oracle Feeds

Available on both mainnet and testnet:

Pair	Contract Address	Network
BTC/USD	0x7b7c000000000000000000000000000000000015	Mainnet
BTC/USD	0x7b7c000000000000000000000000000000000015	Testnet

Node API (Testnet only): http://mezo-node-0.test.mezo.org:1317/connect/oracle/v2/get_price?currency_pair=BTC/USD

Pyth Oracle Feeds

Available on both mainnet and testnet at 0x2880aB155794e7179c9eE2e38200202908C17B43.

Currently supported price feed IDs:

Pair	Price Feed ID
SolvBTC/USD	0xf253cf87dc7d5ed5aa14cba5a6e79aee8bcfaef885a0e1b807035a0bbecc36fa
MUSD/USD	0x0617a9b725011a126a2b9fd53563f4236501f32cf76d877644b943394606c6de
BTC/USD	0xe62df6c8b4a85fe1a67db44dc12de5db330f7ac66b72dc658afedf0f4a415b43
cbBTC/USD	0x2817d7bfe5c64b8ea956e9a26f573ef64e72e4d7891f2d6af9bcc93f7aff9a97
USDC/USD	0xeaa020c61cc479712813461ce153894a96a6c00b21ed0cfc2798d1f9a9e9c94a
USDT/USD	0x2b89b9dc8fdf9f34709a5b106b472f0f39bb6ca9ce04b0fd7f2e971688e2e53b

Need more price feeds? Browse all available Pyth price feed IDs and contact the Mezo team to request additional feeds be enabled onchain.