> For the complete documentation index, see [llms.txt](https://docs.supervol.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.supervol.io/developers/structure/oracle-and-fixing.md).

# Oracle & Fixing

### Price feed from Pyth <a href="#price-feed-from-pyth" id="price-feed-from-pyth"></a>

* SuperVol uses [Pyth](https://pyth.network/price-feeds), a pull-based oracle for crypto market data, for the fair calculation of its options.
* Pyth Price Feeds are used for the **Start Price** and **End Price** of each rounds, thus providing both a decentralised and accountable standard to determine user's trade results.
* From July 2025, SuperVol is powered by **Pyth Lazer** - providing real time price updates for super fast trading.&#x20;

{% hint style="info" %}
Display-wise, SuperVol uses chart data from TradingView charts (ex. [BTCUSD](https://www.tradingview.com/symbols/BTCUSD/))&#x20;

However, actual fixing and settlement is made in Pyth price feeds. We advise that users only view charts as a reference.
{% endhint %}

<figure><img src="/files/ZWdFuaWWRO5sZD4f6kIk" alt="" width="563"><figcaption><p>SuperVol 1 hour BTC Product: Charts powered by Tradingview <a href="https://www.tradingview.com/symbols/BTCUSD/">BTCUSD chart</a></p></figcaption></figure>

### Round Fixing & Settlement

{% tabs %}
{% tab title="1 Hour Option" %}
Due to various complexities in round fixing (including blockchain latency, market fluctuations, smart contract risk), orders with less than 1 minute left before expiry have a high risk of failure. It is recommended that users place orders with enough time remaining.

* The price of each coin/token at 00 minutes @ every hour will be used for the fixings of SuperVol's 1 Hour options.
* More precisely, SuperVol listens to the **Pyth price of HH:00:00** at HH:00:10 every hour.
* By structure, the End Price of Round 'N' will be used for the Start Price of Round 'N+1'. Failure in Pyth price retrieval leads to an error in both ending one round and starting a new one.
* Due to various reasons (i.e. delay/shutdown of Pyth, Ethereum or L2 network), SuperVol may fail to retrieve fixing prices.
  * For example, if SuperVol fails to fetch the End Price for Round 'N':
    1. SuperVol will retry every 2 minutes (ex. HH:02:10 / HH:04:10/ ...)
    2. Until Round 'N' is fixed, the opening of **Round 'N+1'** will be delayed (No Start Price).
       * If the issue persists for 60 minutes, **Round 'N+1'** will be cancelled.
    3. Afterwards, SuperVol will search the Start Price for **Round 'N+2'**
    4. Trading will be functional from **Round 'N+2'**
* Regardless of the operation of other rounds, SuperVol will attempt fixing of Round 'N' for a maximum of 24 hours (=Max. 720 attempts)
  * If fixing fails even after 24 hours, SuperVol will use Binance spot price of asset for End Price of **Round 'N'**
    {% endtab %}

{% tab title="1 Minute Option" %}
The price of each coin/token at 00 seconds @ every minute will be used for the fixings of SuperVol's 1 Minute options.

* More precisely, SuperVol listens to the **Pyth price of HH:MM:00** every minute.
* Due to various reasons (i.e. delay/shutdown of Pyth, Ethereum or L2 network), SuperVol may fail to retrieve fixing prices.
* Regardless of the operation of other rounds, SuperVol will attempt fixing of Round 'N' for a maximum of 24 hours (=Max. 720 attempts)
  * If fixing fails even after 24 hours, SuperVol will use Binance spot price of asset for End Price of **Round 'N'**
    {% endtab %}
    {% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.supervol.io/developers/structure/oracle-and-fixing.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
