<!--
Parallel Documentation — this page, as markdown.
Index of every page: https://docs.parallel.best/llms.txt
The whole documentation in one file: https://docs.parallel.best/llms-full.txt
-->

# Market

## Oracles Implementation

### Gas Wallets

Gas wallets are used to push data to oracle contracts. To ensure uninterrupted oracle operation, Cooper Labs is maintaining sufficient gas in them. Anyone can monitor the wallets below to ensure they remain adequately funded at all times.

| Blockchain         | Contract Address                                                                                                         |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| Base               | [0x8cdc088a6b19f58f7613cb65af03c7496adad893](https://basescan.org/address/0x8cdc088a6b19f58f7613cb65af03c7496adad893)    |
| Sonic (Deprecated) | [0xd35087bb5fa7c4d1a87050cabf73ee4f1649f666](https://sonicscan.org/address/0xd35087bb5fa7c4d1a87050cabf73ee4f1649f666)   |
| HyperEVM           | [0x14566aeb825a3f0605eecd65144dacc52d675b36](https://hyperevmscan.io/address/0x14566aeb825a3f0605eecd65144dacc52d675b36) |
| Avalanche          | [0xe9847Afb5564B221A079f66F3EF9cBa6D4954a4b](https://snowscan.xyz/address/0xe9847Afb5564B221A079f66F3EF9cBa6D4954a4b)    |

### Oracles Configuration

Settings that dictate how the oracle computes and updates data.

|                                   |                                                                                                                                                                                                                              |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Pricing Methodology               | Volume Weighted Average Price with Interquartile Range Filter (more details [here](https://www.diadata.org/docs/nexus/reference/pricing-methodologies/vwapir-volume-weighted-average-price-with-interquartile-range-filter)) |
| Deviation (%) & Refresh Frequency | 0.5% & 120 Seconds                                                                                                                                                                                                           |
| Heartbeat                         | 12 Hours                                                                                                                                                                                                                     |

### Assets Data

Available assets on the oracles and the Chainlink AggregatorV3Interface compatible contracts for each asset feed.

#### Avalanche

| Price Feed   | Contract Address                                                                                                           | Type   | Deviation (%) & Refresh Frequency | Hearbeat |
| ------------ | -------------------------------------------------------------------------------------------------------------------------- | ------ | --------------------------------- | -------- |
| USDp/USD     | [0xd826C5F7be24b33Cc825A9b9E9AcD8C5a2bD71F7](https://snowscan.xyz/address/0xd826C5F7be24b33Cc825A9b9E9AcD8C5a2bD71F7#code) | Market | 0.5% & 120 Seconds                | 12 hours |
| sUSDp/USD    | [0x4D165058332a39F2E2C32F438f4897BcF7694Fbd](https://snowscan.xyz/address/0x4D165058332a39F2E2C32F438f4897BcF7694Fbd#code) | Market | 0.5% & 120 Seconds                | 12 hours |

#### HyperEVM

| Price Feed   | Contract Address                                                                                                              | Type   | Deviation (%) & Refresh Frequency | Hearbeat |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------- | ------ | --------------------------------- | -------- |
| USDp/USD     | [0x2189f3d9Be89808Dfe6C34446FE7aaDA7A5aD1b6](https://hyperevmscan.io/address/0x2189f3d9Be89808Dfe6C34446FE7aaDA7A5aD1b6#code) | Market | 0.5% & 120 Seconds                | 12 hours |
| sUSDp/USD    | [0xdcA437D1492Db6E9438A82Ad31Cab92E2eE159E1](https://hyperevmscan.io/address/0xdcA437D1492Db6E9438A82Ad31Cab92E2eE159E1#code) | Market | 0.5% & 120 Seconds                | 12 hours |

#### Base

| Price Feed   | Contract Address                                                                                                           | Type   | Deviation (%) & Refresh Frequency | Hearbeat |
| ------------ | -------------------------------------------------------------------------------------------------------------------------- | ------ | --------------------------------- | -------- |
| USDp/USD     | [0x048710167827e4bd7286384653baa0be7d22e638](https://basescan.org/address/0x048710167827e4bd7286384653baa0be7d22e638#code) | Market | 0.5% & 120 Seconds                | 12 hours |
| sUSDp/USD    | [0xA6c34e47088331C0348bFe58fe97314A4567071A](https://basescan.org/address/0xA6c34e47088331C0348bFe58fe97314A4567071A#code) | Market | 0.5% & 120 Seconds                | 12 hours |

#### Sonic (Deprecated)

:::warning
USDp & sUSDp price feeds on Sonic are deprecated.
:::

| Price Feed    | Contract Address                                                                                                            | Type   | Deviation (%) & Refresh Frequency | Hearbeat |
| ------------- | --------------------------------------------------------------------------------------------------------------------------- | ------ | --------------------------------- | -------- |
| USDp/USD      | [0xf20f32c481ae55531ec3d923c03306d2d6dc294e](https://sonicscan.org/address/0xf20f32c481ae55531ec3d923c03306d2d6dc294e#code) | Market | 0.5% & 120 Seconds                | 12 hours |
| sUSDp/USD     | [0x06d6c926EF90260B71Bb3d9431958b8DA0C365F5](https://sonicscan.org/address/0x06d6c926EF90260B71Bb3d9431958b8DA0C365F5#code) | Market | 0.5% & 120 Seconds                | 12 hours |

### Data Sources

#### Base

| Price Feed   | API Endpoint                                                                                             |
| ------------ | -------------------------------------------------------------------------------------------------------- |
| USDp/USD     | [USDp on Base](https://www.diadata.org/app/price/asset/Base/0x76A9A0062ec6712b99B4f63bD2b4270185759dd5/) |
| sUSDp/USD    |                                                                                                          |

#### Sonic (Deprecated)

| Price Feed | API Endpoint                                                                                               |
| ---------- | ---------------------------------------------------------------------------------------------------------- |
| USDp/USD   | [USDp on Sonic](https://www.diadata.org/app/price/asset/Sonic/0x08417cdb7F52a5021bB4eb6E0deAf3f295c3f182/) |
| sUSDp/USD  |                                                                                                            |

:::warning
USDp & sUSDp price feeds on Sonic are deprecated.
:::

## How the Oracle Works

The market-based oracle aggregates trades from decentralized exchanges across multiple chains (Base, Sonic, etc.) using the VWAPIR methodology over a 1-hour window. Price updates are triggered when market prices deviate by 0.5% or every 12 hours as configured [here](#oracles-configuration).

:::info
The sUSDp/USD value can also be retrieved using the chainlink-compatible adapter [smart contract](#assets-data) for sUSDp/USD.
:::