📈Price History

Purpose and functionality

The main purpose of the Price History contract is to periodically record the prices of selected assets on-chain, providing an open and transparent way to query historical asset prices.

Importance of historical price data

Historical price data is primarily used to calculate historical volatility (HV), which serves as an input to the Strike-Bound liquidity calculation for automatically selecting strike prices during epoch initialisation.

Price Recording Mechanism

Spot prices for all protocol-tracked assets are read from the on-chain oracle and writen to on-chain storage.

Asset coverage and selection criteria

The protocol tracks all assets for which Yield Harbour deploys markets.

Assets

• $KUJI

• More soon

Data Storage and Retrieval

The historical price data is paged, allowing the amount of historical data to be read and adjusted based on consuming needs.

Frequency

Prices are recorded every 30 minutes.

On-chain data structure and format

Coming soon.

Querying and accessing historical price data

Coming soon.

Upgrade and migration processes

The Price History contract is owned and managed by Yield Harbour, with the upgrade and migration processes governed by the Kujira on-chain governance.

Governance Summary

The Price History contract is a crucial component of the Yield Harbour protocol, designed to periodically record the prices of selected assets on-chain. This contract serves as an open and transparent way to query historical asset prices, which are primarily used to calculate historical volatility (HV) – an essential input for the Strike-Bound liquidity calculation during epoch initialization.

The contract currently tracks the prices of $KUJI, with plans to include more assets in the future. Prices are recorded every 30 minutes from the on-chain oracle, and the historical data is stored in a paged format, allowing for efficient retrieval and adjustment based on consumer needs.

The Price History contract will be open for free usage by the broader Kujira community, enabling developers and projects to access reliable historical price data for their applications.

The contract is owned and managed by Yield Harbour, with upgrade and migration processes governed by the Kujira on-chain governance system. Deploying this contract is a prerequisite for gathering price history ahead of deploying any markets within the Yield Harbour protocol, while also benefiting the larger Kujira ecosystem.

By implementing the Price History contract, Yield Harbour aims to establish a reliable and transparent source of historical asset prices, enabling accurate calculations of historical volatility and strike prices for its decentralized options markets, while also providing a valuable resource for the Kujira community.