# Table of Contents - [Welcome to Pyth Network – Pyth Network Documentation](#welcome-to-pyth-network-pyth-network-documentation) - [Welcome to Pyth Network – Pyth Network Documentation](#welcome-to-pyth-network-pyth-network-documentation) - [Introduction to Pyth Price Feeds – Pyth Network Documentation](#introduction-to-pyth-price-feeds-pyth-network-documentation) - [Pyth Lazer – Pyth Network Documentation](#pyth-lazer-pyth-network-documentation) - [Introduction – Pyth Network Documentation](#introduction-pyth-network-documentation) - [Entropy – Pyth Network Documentation](#entropy-pyth-network-documentation) - [GitHub](#github) - [GitHub](#github) - [Pyth on EVM – Pyth Network Documentation](#pyth-on-evm-pyth-network-documentation) - [Oracle Integrity Staking (OIS) – Pyth Network Documentation](#oracle-integrity-staking-ois-pyth-network-documentation) --- # Welcome to Pyth Network – Pyth Network Documentation Home Introduction Welcome to Pyth Network ======================= Pyth Network is the leading oracle protocol that connects the owners of market data to applications on multiple blockchains. [120+ first-party publishers (opens in a new tab)](https://insights.pyth.network/publishers?utm_source=docs) are onboarded to the Pyth Network, including some of the biggest exchanges and market making firms in the world. [Over 250 protocols (opens in a new tab)](https://defillama.com/oracles/Pyth) trust Pyth to secure their applications. Our Products[](https://docs.pyth.network/home#our-products) ------------------------------------------------------------ Core ### Price Feeds Real-time, high-fidelity market data for smart contracts with sub-second latency. Real-time price feeds 2000+ assets 100+ blockchains [Explore Price Feeds](https://docs.pyth.network/price-feeds) Lazer ### Lazer High-performance, low-latency price feeds for institutional applications. Ultra-low latency Institutional grade High-frequency data [Learn About Lazer](https://docs.pyth.network/lazer) MEV Protection ### Express Relay Eliminate MEV while gaining access to active searchers and liquidators. MEV protection Active searchers Multi-chain support [Explore Express Relay](https://docs.pyth.network/express-relay) Randomness ### Entropy Generate secure random numbers on the blockchain for your applications. Cryptographically secure Real-time generation Multi-chain support [Learn About Entropy](https://docs.pyth.network/entropy) Quick Start[](https://docs.pyth.network/home#quick-start) ---------------------------------------------------------- Get started with Pyth Network by exploring our comprehensive documentation: * **[Price Feeds Getting Started](https://docs.pyth.network/price-feeds/getting-started) ** - Integrate real-time price data * **[Lazer Documentation](https://docs.pyth.network/lazer) ** - High-performance price feeds * **[Express Relay Integration](https://docs.pyth.network/express-relay) ** - Better orderflow mechanism to eliminate MEV * **[Entropy Implementation](https://docs.pyth.network/entropy) ** - Secure randomness generation Additional Resources[](https://docs.pyth.network/home#additional-resources) ---------------------------------------------------------------------------- ### PYTH Token Learn about the Pyth governance token and its role in the network. [Learn More →](https://docs.pyth.network/pyth-token) ### Oracle Integrity Staking Understand how staking ensures data quality and network security. [Learn More →](https://docs.pyth.network/home/oracle-integrity-staking) ### Network Metrics Track the network's adoption, growth, and performance metrics. [Learn More →](https://docs.pyth.network/home/metrics) Developer Resources[](https://docs.pyth.network/home#developer-resources) -------------------------------------------------------------------------- * **[Contract Addresses](https://docs.pyth.network/price-feeds/contract-addresses) ** - Find deployment addresses across all supported chains * **[Whitepaper](https://docs.pyth.network/whitepaper) ** - Deep dive into Pyth Network's technical architecture * **[Security](https://docs.pyth.network/security) ** - Learn about Pyth's security model and best practices Last updated on August 29, 2025 --- # Welcome to Pyth Network – Pyth Network Documentation Home Introduction Welcome to Pyth Network ======================= Pyth Network is the leading oracle protocol that connects the owners of market data to applications on multiple blockchains. [120+ first-party publishers (opens in a new tab)](https://insights.pyth.network/publishers?utm_source=docs) are onboarded to the Pyth Network, including some of the biggest exchanges and market making firms in the world. [Over 250 protocols (opens in a new tab)](https://defillama.com/oracles/Pyth) trust Pyth to secure their applications. Our Products[](https://docs.pyth.network/#our-products) -------------------------------------------------------- Core ### Price Feeds Real-time, high-fidelity market data for smart contracts with sub-second latency. Real-time price feeds 2000+ assets 100+ blockchains [Explore Price Feeds](https://docs.pyth.network/price-feeds) Lazer ### Lazer High-performance, low-latency price feeds for institutional applications. Ultra-low latency Institutional grade High-frequency data [Learn About Lazer](https://docs.pyth.network/lazer) MEV Protection ### Express Relay Eliminate MEV while gaining access to active searchers and liquidators. MEV protection Active searchers Multi-chain support [Explore Express Relay](https://docs.pyth.network/express-relay) Randomness ### Entropy Generate secure random numbers on the blockchain for your applications. Cryptographically secure Real-time generation Multi-chain support [Learn About Entropy](https://docs.pyth.network/entropy) Quick Start[](https://docs.pyth.network/#quick-start) ------------------------------------------------------ Get started with Pyth Network by exploring our comprehensive documentation: * **[Price Feeds Getting Started](https://docs.pyth.network/price-feeds/getting-started) ** - Integrate real-time price data * **[Lazer Documentation](https://docs.pyth.network/lazer) ** - High-performance price feeds * **[Express Relay Integration](https://docs.pyth.network/express-relay) ** - Better orderflow mechanism to eliminate MEV * **[Entropy Implementation](https://docs.pyth.network/entropy) ** - Secure randomness generation Additional Resources[](https://docs.pyth.network/#additional-resources) ------------------------------------------------------------------------ ### PYTH Token Learn about the Pyth governance token and its role in the network. [Learn More →](https://docs.pyth.network/pyth-token) ### Oracle Integrity Staking Understand how staking ensures data quality and network security. [Learn More →](https://docs.pyth.network/home/oracle-integrity-staking) ### Network Metrics Track the network's adoption, growth, and performance metrics. [Learn More →](https://docs.pyth.network/home/metrics) Developer Resources[](https://docs.pyth.network/#developer-resources) ---------------------------------------------------------------------- * **[Contract Addresses](https://docs.pyth.network/price-feeds/contract-addresses) ** - Find deployment addresses across all supported chains * **[Whitepaper](https://docs.pyth.network/whitepaper) ** - Deep dive into Pyth Network's technical architecture * **[Security](https://docs.pyth.network/security) ** - Learn about Pyth's security model and best practices Last updated on August 29, 2025 --- # Introduction to Pyth Price Feeds – Pyth Network Documentation Price Feeds Introduction Introduction to Pyth Price Feeds ================================ Pyth Network provides real-time financial market data to smart contract applications on 100+ blockchains. Data is sourced from 120+ first-party providers including major exchanges and market makers. Key Features[](https://docs.pyth.network/price-feeds#key-features) ------------------------------------------------------------------- * **1600+ price feeds** across all major asset classes * **Sub-second latency** with high-frequency updates * **Cryptographically signed** and verifiable on-chain * **Multi-chain support** including EVM, Cosmos, Solana, Aptos, and more Our Products[](https://docs.pyth.network/price-feeds#our-products) ------------------------------------------------------------------- Core ### Real-Time Price Feeds Real-time, high-fidelity market data for smart contracts. Real-time price feeds High-frequency data Multi-chain support [Explore Price Feeds](https://docs.pyth.network/price-feeds/use-real-time-data) Benchmarks ### Historical Data Access to historical price data for settlement and backtesting. Signed data Verifiable prices Time-stamped prices [Access Historical Data](https://docs.pyth.network/price-feeds/use-historic-price-data) Lazer ### Lazer High-performance, low-latency price feeds for institutional applications. Ultra-low latency Institutional grade High-frequency data [Learn About Lazer](https://docs.pyth.network/lazer) Quick Start[](https://docs.pyth.network/price-feeds#quick-start) ----------------------------------------------------------------- Follow the [Getting Started](https://docs.pyth.network/price-feeds/getting-started) guide to integrate Pyth Price Feeds into your application. For contract addresses and deployment details, see [Contract Addresses](https://docs.pyth.network/price-feeds/contract-addresses) . Last updated on August 25, 2025 --- # Pyth Lazer – Pyth Network Documentation Lazer Introduction Pyth Lazer ========== Pyth Lazer is a low latency, highly customizable price oracle. It offers a customizable set of price feeds, target chains (EVM or Solana) and channels (real time or fixed rate): * Real time channels send updates as frequently as they become available; * Fixed rate channels send updates at fixed time intervals (you can choose between 50 ms or 200 ms). The table below shows the difference between Pyth Core and Pyth Lazer: | | **Pyth Core** | **Pyth Lazer** | | --- | --- | --- | | **Solution Type** | Stable, secure, and decentralized price data source for a broad spectrum of DeFi or TradFi applications. | **Permissioned** service focused on **ultra-low-latency** price and market data for highly latency-sensitive users. | | **Frequency** | 400ms on Pythnet appchain with support for risk mitigation via Benchmarks and confidence intervals. | **1ms** (**real-time**), 50ms, and 200ms channels, **customizable** frequencies, and throttling support to address different needs. | | **Data Types** | Aggregate price and confidence intervals. | Aggregate price, bid/ask price, and **customizable** market data (market depth and more). | | **Fees** | On-chain fee per signed cross-chain price update. | On-chain fee per signed cross-chain price update. | | **Update Costs** | \>1,000-byte proofs and complex signature verification. | **100-byte proofs** and simple signature verification. | | **Integration Process** | Open and permissionless integration for any Web3 or Web2 protocol. | **Specialized** and **permissioned** solution for protocols prioritizing performance over some elements of decentralization. | Last updated on August 20, 2025 --- # Introduction – Pyth Network Documentation Express Relay Introduction Introduction ============ Express Relay is a priority auction which enables better orderflow mechanisms that eliminate [Maximal Extractable Value (opens in a new tab)](https://www.ledger.com/academy/glossary/maximal-extractable-value-mev) (MEV). * **For Protocol Developers:** Express Relay allows protocols to recapture MEV and access a network of searchers for more competitive pricing than on-chain sources provide. With Express Relay, protocols get access to plug-and-play liquidity. * **For Searchers:** Express Relay provides easy and unified access to a range of orderflow opportunities across integrated DeFi protocols. Integration[](https://docs.pyth.network/express-relay#integration) ------------------------------------------------------------------- To integrate with Express Relay, you can integrate as a protocol (to power token swaps) or as a searcher. [Integrate with Express Relay as a Protocol](https://docs.pyth.network/express-relay/integrate-as-protocol) [Integrate with Express Relay as a Searcher](https://docs.pyth.network/express-relay/integrate-as-searcher) Learn[](https://docs.pyth.network/express-relay#learn) ------------------------------------------------------- To learn more about Express Relay, refer to the following resources: [How Express Relay Works](https://docs.pyth.network/express-relay/how-express-relay-works) --- # Entropy – Pyth Network Documentation Entropy Introduction Entropy ======= Pyth Entropy allows developers to quickly and easily generate secure random numbers on the blockchain. Entropy's rapid response time allows developers to build applications such as NFT mints and games with responsive UX. Entropy also provides [strong security guarantees](https://docs.pyth.network/entropy/protocol-design) to ensure that both users and application developers can trust that the results are random. Pyth Entropy is currently available on several [EVM networks](https://docs.pyth.network/entropy/contract-addresses) . If you would like a deployment on another network, please [ask in Discord (opens in a new tab)](https://discord.gg/invite/PythNetwork) . Getting Started[](https://docs.pyth.network/entropy#getting-started) --------------------------------------------------------------------- Using Pyth Entropy is permissionless and developers can integrate in a few minutes. Please see [How to Generate Random Numbers Using Pyth Entropy](https://docs.pyth.network/entropy/generate-random-numbers) to start integrating Pyth Entropy into your application. Additional Resources[](https://docs.pyth.network/entropy#additional-resources) ------------------------------------------------------------------------------- To learn more about how the protocol works, please see [Protocol Design](https://docs.pyth.network/entropy/protocol-design) . Reference Material[](https://docs.pyth.network/entropy#reference-material) --------------------------------------------------------------------------- * [Protocol Design](https://docs.pyth.network/entropy/protocol-design) * [Contract Addresses](https://docs.pyth.network/entropy/contract-addresses) * [Error Codes](https://docs.pyth.network/entropy/error-codes) * [Entropy Debugger (opens in a new tab)](https://entropy-debugger.pyth.network/) - Interactive tool for diagnosing callback issues --- # GitHub Home PYTH Token PYTH Token ========== The Pyth Network, as a distributed system, needs to have a constitution and a clear governance system. PYTH is the governance token of the Pyth Network, and the [Pyth DAO constitution (opens in a new tab)](https://github.com/pyth-network/governance/blob/main/docs/constitution/pyth-dao-constitution.md) is the governance framework for the Pyth DAO. The constitution outlines the rules and procedures of the Pyth DAO. These rules and procedures are generally enforced through on-chain contracts and the associated parameters, unless specified by the Pyth DAO for actuation off-chain. PYTH Token Staking[](https://docs.pyth.network/home/pyth-token#pyth-token-staking) ----------------------------------------------------------------------------------- PYTH Token can be staked for Governance and Oracle Integrity. ### Staking PYTH for Governance[](https://docs.pyth.network/home/pyth-token#staking-pyth-for-governance) PYTH token holders can participate in Pyth governance through [staking (opens in a new tab)](https://staking.pyth.network/) and [governance (opens in a new tab)](https://app.realms.today/dao/PYTH) . Token holders use their staked tokens in the Pyth staking program to vote on community governance proposals. Governance uses a 1:1 coin-voting system, where each staked token confers one vote. Any PYTH Token holder can submit proposals to the Pyth DAO as long as they have **0.25%** of the total PYTH tokens staked. At the end of the **7 day** voting period, a proposal is passes if it meets the following conditions: * **More yesses** have been cast than nos. * The "**Approval Quorum**" has been met. **Approval Quorum** is a percentage of staked PYTH tokens that must have voted yes for the proposal to pass. "Community Vote Threshold Percentage" is expressed as percentage of staked tokens at the start of the voting period for the proposal. This percentage threshold can vary depending on the type of proposal. The current threshold can be found in the "Governances" sections of the [parameters of the DAO (opens in a new tab)](https://app.realms.today/dao/PYTH/params) . Please note that the scope of community governance proposals may be expanded if the PYTH token holders (or the Pyth DAO) decide so. ### Staking PYTH for Oracle Integrity[](https://docs.pyth.network/home/pyth-token#staking-pyth-for-oracle-integrity) The Pyth Network is built to provide decentralized applications with reliable and trustworthy data. The quality of the data it provides is paramount for these application's functions and the network's overall success. Pyth's [Oracle Integrity Staking (OIS)](https://docs.pyth.network/home/oracle-integrity-staking) concentrates on producing quality data in the hands of a limited set of semi-trusted entities to achieve more coverage and lower latency than the competition. The responsibility of publishers over data quality is not just ethical but also incentivized through economics: * **Staking and Slashing:** Publishers can self-stake PYTH tokens as collateral. It also allows other stakers to choose publishers to delegate their PYTH tokens. In the event of data inaccuracies or inconsistencies, a portion of this stake can be slashed as a penalty. This mechanism ensures that publishers have a vested interest in providing accurate data * **Reputation:** The reputation of data publishers is directly linked to the quality of data they provide. Publishers with a track record of providing accurate data are more likely to be trusted and attract more interest. --- # GitHub Home [PYTH Token](https://docs.pyth.network/home/pyth-token) PYTH Token Distribution PYTH Distribution ================= There is a total of 10,000,000,000 (10B) PYTH tokens existing. The initial circulating supply (November 2023) was 1,500,000,000 (15%) PYTH. And the remaining supply (85%) are initially locked and locked tokens will unlock 6, 18, 30 and 42 months after the initial token launch. **PYTH Lockup Schedule** ![](https://docs.pyth.network/_next/image?url=%2F_next%2Fstatic%2Fmedia%2FPyth_Lockup_Schedule.a4edba9d.png&w=3840&q=75) Token Distribution[](https://docs.pyth.network/home/pyth-token/pyth-distribution#token-distribution) ----------------------------------------------------------------------------------------------------- Below is the PYTH Token distribution table as per the whitepaper. ![](https://docs.pyth.network/_next/image?url=%2F_next%2Fstatic%2Fmedia%2FToken_breakdown.80010441.png&w=3840&q=75) Publisher Rewards[](https://docs.pyth.network/home/pyth-token/pyth-distribution#publisher-rewards) --------------------------------------------------------------------------------------------------- 22% — 2,200,000,000 PYTH This allocation is reserved for the Pyth Network data providers, or "publishers". The publishers are responsible for publishing price data to the Pyth Network. The “Publisher Rewards” allocation consists of reserved tokens for various reward mechanisms and grant programs to encourage publishers to publish accurate and timely price data. This is designed to encourage more publishers to support new symbols which may lack the initial popularity or liquidity for the network to launch immediately. ~2% (50M) of the 2.2B PYTH Tokens are unlocked. The remaining PYTH Tokens (2.15B) are subject to the lockup schedule described above. Note that these rewards can only be distributed to publishers once they are unlocked. ![](https://docs.pyth.network/_next/image?url=%2F_next%2Fstatic%2Fmedia%2FPYTH_Publisher_Rewards_Lockup_Schedule.35fb0d55.png&w=3840&q=75) Ecosystem Growth[](https://docs.pyth.network/home/pyth-token/pyth-distribution#ecosystem-growth) ------------------------------------------------------------------------------------------------- 52% — 5,200,000,000 PYTH The “Ecosystem Growth” allocation is a strategic portion of tokens set aside for contributors to the Pyth Network, including developers, educators, researchers, strategic contributors, early publishers, and more. This allocation aims to facilitate practical initiatives including funding research projects aimed at advancing the Pyth Network, incentivizing developers to build complementary tooling and resources, and supporting public education programs to increase awareness. This allocation aims to recognize and reward individuals and organizations that go beyond the contributors in fostering the expansion and vitality of the Pyth Network. 13% (700M) of the 5.2B PYTH Tokens are unlocked. The remaining tokens (4.5B) are subject to the unlock schedule described above. ![](https://docs.pyth.network/_next/image?url=%2F_next%2Fstatic%2Fmedia%2FPYTH_Ecosystem_Growth_Lockup_Schedule.a5fa3ccd.png&w=3840&q=75) Protocol Development[](https://docs.pyth.network/home/pyth-token/pyth-distribution#protocol-development) --------------------------------------------------------------------------------------------------------- 10% — 1,000,000,000 This portion of the token supply has been allocated to contributors focused on building oracle tooling, products, and infrastructure to expand the network’s suite of decentralized data services. 15% (150M) of the 1B PYTH Tokens are unlocked. The remaining tokens (850M) are subject to the unlock schedule described above. ![](https://docs.pyth.network/_next/image?url=%2F_next%2Fstatic%2Fmedia%2FPYTH_Protocol_Development_Lockup_Schedule.c8633a51.png&w=3840&q=75) Community and Launch[](https://docs.pyth.network/home/pyth-token/pyth-distribution#community-and-launch) --------------------------------------------------------------------------------------------------------- 6% — 600,000,000 This portion of PYTH Tokens is set aside for the initial launch phase and related activities and initiatives. 41% (250M) of the 600M PYTH tokens were allocated to DeFi Participants (of an application that use Pyth data) ; 16% (100M) of the Community and Launch bucket are directly assigned to protocols and DAOs ; and the rest (250M) was used for other launch activities. All 600M PYTH Tokens of “Community and Launch” allocation are unlocked from day one. ![](https://docs.pyth.network/_next/image?url=%2F_next%2Fstatic%2Fmedia%2FPYTH_Community_Launch_Lockup_Schedule.56825feb.png&w=3840&q=75) Private Sales[](https://docs.pyth.network/home/pyth-token/pyth-distribution#private-sales) ------------------------------------------------------------------------------------------- 10% — 1,000,000,000 This category represents two historical funding rounds to strategic contributors who add value to the network in terms of advisory and infrastructure support. All of 1B PYTH Tokens are locked and subject to the unlock schedule described above. ![](https://docs.pyth.network/_next/image?url=%2F_next%2Fstatic%2Fmedia%2FPYTH_Private_Sales_Lockup_Schedule.a4892476.png&w=3840&q=75) --- # Pyth on EVM – Pyth Network Documentation Home [PYTH Token](https://docs.pyth.network/home/pyth-token) PYTH Token Contract Addresses Pyth on EVM =========== The PYTH token is a native Solana token following the SPL model. Through the use of permissionless bridges like Wormhole, (wrapped) PYTH tokens may exist on various other chains. Below is the list of all official PYTH token representation on various blockchains: Networks[](https://docs.pyth.network/home/pyth-token/pyth-token-addresses#networks) ------------------------------------------------------------------------------------ | Network | Token address | | --- | --- | | Solana | [`HZ1JovNiVvGrGNiiYvEozEVgZ58xaU3RKwX8eACQBCt3` (opens in a new tab)](https://solana.fm/address/HZ1JovNiVvGrGNiiYvEozEVgZ58xaU3RKwX8eACQBCt3?cluster=mainnet-solanafmbeta) | | Ethereum | [`0xeFc0CED4B3D536103e76a1c4c74F0385C8F4Bdd3` (opens in a new tab)](https://etherscan.io/token/0xeFc0CED4B3D536103e76a1c4c74F0385C8F4Bdd3) | | Arbitrum | [`0xE4D5c6aE46ADFAF04313081e8C0052A30b6Dd724` (opens in a new tab)](https://arbiscan.io/token/0xE4D5c6aE46ADFAF04313081e8C0052A30b6Dd724) | | Optimism | [`0x99C59ACeBFEF3BBFB7129DC90D1a11DB0E91187f` (opens in a new tab)](https://optimistic.etherscan.io/token/0x99C59ACeBFEF3BBFB7129DC90D1a11DB0E91187f) | | Fantom | [`0x77ad3B2dA29FBd208F12c3C701E969F4422aAD79` (opens in a new tab)](https://ftmscan.com/token/0x77ad3B2dA29FBd208F12c3C701E969F4422aAD79) | | Base | [`0x4c5d8A75F3762c1561D96f177694f67378705E98` (opens in a new tab)](https://basescan.org/token/0x4c5d8A75F3762c1561D96f177694f67378705E98) | | BNB Chain | [`0xb0188B0bb2cD4a6D2744637fC83C94a284B247Da` (opens in a new tab)](https://bscscan.com/token/0xb0188B0bb2cD4a6D2744637fC83C94a284B247Da) | | Polygon | [`0xFa4B761A1e07909Ba31331a5dfa12390E3ff5583` (opens in a new tab)](https://polygonscan.com/token/0xFa4B761A1e07909) | | Avalanche | [`0x8A0691e602B7a5FCc51a27E4a08376dE50889B42` (opens in a new tab)](https://avascan.info/blockchain/c/token/0x8A0691e602B7a5FCc51a27E4a08376dE50889B42) | | Manta | [`0x90E95735378A31BfAD2Dcd87128Fbb80FFeB6917` (opens in a new tab)](https://manta-pacific.calderaexplorer.xyz/address/0x90E95735378A31BfAD2Dcd87128Fbb80FFeB6917) | | Aptos | [`0x770211b47954e15bec1a4271bf33bacebc2d2adb43b7dc1ca45efa787615dd4c` (opens in a new tab)](https://explorer.aptoslabs.com/account/0x770211b47954e15bec1a4271bf33bacebc2d2adb43b7dc1ca45efa787615dd4c?network=mainnet) | | Sui | [`0x9c6d76eb273e6b5ba2ec8d708b7fa336a5531f6be59f326b5be8d4d8b12348a4` (opens in a new tab)](https://suiexplorer.com/object/0x9c6d76eb273e6b5ba2ec8d708b7fa336a5531f6be59f326b5be8d4d8b12348a4) | | Injective | [`inj1tjcf9497fwmrnk22jfu5hsdq82qshga54ajvzy` (opens in a new tab)](https://explorer.injective.network/asset/?tokenType=tokenFactory&denom=factory/inj14ejqjyq8um4p3xfqj74yld5waqljf88f9eneuk/inj1tjcf9497fwmrnk22jfu5hsdq82qshga54ajvzy) | | Sei | [`sei1cl90kjpf6wnfa9vvynmqva6vpy7xv3u84e6fkx96tx89axsf3gcq2vuync` (opens in a new tab)](https://sei.explorers.guru/account/sei1cl90kjpf6wnfa9vvynmqva6vpy7xv3u84e6fkx96tx89axsf3gcq2vuync) | | NEAR | [`21.contract.portalbridge.near` (opens in a new tab)](https://nearblocks.io/address/21.contract.portalbridge.near) | --- # Oracle Integrity Staking (OIS) – Pyth Network Documentation Home Oracle Integrity Staking (OIS) Oracle Integrity Staking (OIS) ============================== This document outlines the design principles and implementation details of the [Oracle Integrity Staking (OIS) (opens in a new tab)](https://staking.pyth.network/) protocol. Design Principles[](https://docs.pyth.network/home/oracle-integrity-staking#design-principles) ----------------------------------------------------------------------------------------------- OIS's economic design focuses on awarding and penalizing stakers over the primary dimension of data accuracy. Stakers are incentivized to help maintain data quality by receiving rewards from an open-ended pool. However, they also face the risk of having their stake slashed as a penalty for failing to maintain data accuracy. The core design principles behind OIS include the following: * Oracle Integrity Staking secures all current and future price feeds produced by the Pyth Network. * Data Publishers are individually responsible for data accuracy. * Rewards and penalties are proportionate to the stake assigned to each publisher. Delegators share the risks and rewards of the publisher(s) to whom they assign their stake. * A higher number of publishers for each price feed contributes positively to the security of such feed. * Staking for **OIS** is complementary to staking for **governance**, and eligible $PYTH tokens can be used for both purposes. * The ability to slash stake in OIS requires **unlocked** $PYTH tokens, whereas staking for governance can use both locked and unlocked $PYTH tokens. * All parameter related to the OIS protocol are subject to the governance of the Pyth DAO. Implementation[](https://docs.pyth.network/home/oracle-integrity-staking#implementation) ----------------------------------------------------------------------------------------- OIS implements the design principles above through the following structure: 1. OIS is subject to the same 7-day epoch as governance voting. All parameters used in the OIS protocol are captured at each start of the epoch on Thursdays at 0:00 UTC and remain constant until the end of the epoch. Staking into OIS is also subject to warmup and cooldown period prior and post epoch respectively. 2. Each publisher is programmatically assigned a staking pool where they can self-stake and to which other stakers can delegate. * The staking pool assigned to each publisher covers all price feeds/symbols they publish. * Each staking pool has a soft cap. This soft cap dynamically expands and shrinks given the number of symbols published by the assigned publisher. * Price feeds with a low number of publishers contribute more to the cap's expansion. * Staking into the pool can exceed the soft cap. However no rewards are paid for the excess amount. On the contrary, the excess amount is subject to the penalty if the assigned publisher's data is inaccurate. * The OIS protocol prioritizes self-stake attributed to the **publisher's stake** when distributing rewards to the publisher's pool. * All staking pools charge the same delegation fee for stakers who are delegating stake to one or many pools. 3. Each pool has a maximum reward rate per epoch, which applies only to the staked amount within the soft cap. 4. The total amount of rewards paid to all pools is bound by the same cap relative to the amount of rewards available to the OIS protocol. 5. Slashing of stake has a hard percentage cap and only impacts pools that assigned to publishers responsible for the poor data quality. Both self-stakers and delegators are also slashed proportionally to their staked amount in the impacted pools. ---