Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
LABS
Glossary

Push-Based Oracle

A push-based oracle is a decentralized oracle design pattern where data is automatically broadcast to the blockchain by oracle nodes without requiring an on-chain request for each update.
Chainscore © 2026
definition
BLOCKCHAIN INFRASTRUCTURE

What is a Push-Based Oracle?

A push-based oracle is a blockchain data feed that proactively delivers external information to smart contracts on-chain, triggered by predefined conditions or schedules.

A push-based oracle is a type of blockchain oracle that actively pushes or transmits external data onto the blockchain without requiring a smart contract to first request it. This model is characterized by its proactive nature, where the oracle service monitors off-chain data sources and automatically initiates an on-chain transaction to update a data point—such as a price feed for an asset—when specific conditions are met. This contrasts with a pull-based oracle, where the smart contract must explicitly call for data, incurring gas costs and latency at the moment of need. Push oracles are fundamental for maintaining real-time, stateful information that multiple contracts can reliably reference.

The core mechanism involves a continuous off-chain process where oracle nodes fetch, aggregate, and validate data from APIs, sensors, or other sources. Upon detecting a significant deviation from the last reported value (a deviation threshold) or at regular time intervals (a heartbeat), the nodes construct and broadcast a signed transaction to a designated on-chain data feed or consumer contract. This update transaction writes the new data to the blockchain's immutable ledger, making it a persistent and verifiable oracle update. This design ensures that critical data, like the price of ETH/USD, is consistently available on-chain with minimal lag for dependent DeFi protocols.

Key technical components enabling push-based oracles include decentralized oracle networks (DONs) for security, cryptographic signatures to prove data authenticity, and on-chain aggregator contracts that reconcile reports from multiple nodes. A primary use case is maintaining perpetual price oracles for decentralized exchanges and lending platforms, which require uninterrupted, tamper-resistant market data to calculate collateral ratios and execute liquidations. Other applications include delivering verifiable randomness for NFTs, sports event outcomes for prediction markets, and weather data for parametric insurance contracts, where timely, automated updates are essential for protocol functionality.

The main advantages of the push model are low latency for consumer contracts, which do not need to wait for a data fetch, and predictable gas cost allocation, as the oracle provider typically covers the update transaction fees. However, this creates a continuous operational cost for the oracle service and can lead to data staleness if update conditions are not frequently met, potentially leaving contracts with outdated information. Therefore, careful configuration of deviation thresholds and heartbeat intervals is crucial to balance freshness, cost, and on-chain congestion. Protocols like Chainlink Data Feeds exemplify sophisticated push-based oracle systems securing tens of billions in value.

how-it-works
ORACLE ARCHITECTURE

How a Push-Based Oracle Works

A push-based oracle is a data-feed mechanism that proactively delivers off-chain data to smart contracts on-chain, contrasting with the request-response model of pull-based oracles.

A push-based oracle is an oracle design pattern where the oracle node or network initiates the data delivery to a smart contract without the contract first making an explicit request. This is typically implemented through a subscription model, where a smart contract registers its interest in a specific data feed (e.g., the ETH/USD price) and the oracle service automatically pushes updates when predefined conditions are met, such as a price deviation beyond a set threshold or at regular time intervals. This architecture shifts the gas cost burden for data delivery from the end-user's contract to the oracle service provider or a designated payer.

The core technical workflow involves several key components. First, an on-chain registry or manager contract maintains a list of subscriber contracts and their data requirements. Off-chain oracle nodes monitor these requirements and the relevant external data sources. When a node detects that an update condition is satisfied—like a significant market move—it constructs a transaction containing the new data and a validity proof. This transaction is then broadcast to the blockchain, where it calls the consumer contract's callback function (e.g., fulfill), delivering the verified data payload directly into its storage or logic.

This proactive delivery model offers distinct advantages for certain applications. It is highly efficient for high-frequency or time-critical data, such as price feeds for decentralized exchanges or lending protocols that require constant, up-to-date valuations for liquidations. It also enables event-driven automation, allowing contracts to react immediately to real-world occurrences. However, the model requires careful economic design to manage ongoing gas costs and necessitates robust reliability guarantees from the oracle to ensure data is delivered when needed, making trust in the oracle operator or decentralized network paramount.

Prominent examples of push-based oracle systems include Chainlink Data Feeds. In this implementation, decentralized oracle networks (DONs) continuously update aggregated price data on-chain. A dedicated upkeep transaction is sent periodically by oracle nodes to an aggregator contract, which then makes the latest median price available to all subscribed consumer contracts. This design ensures data is persistently available on-chain with low latency, eliminating the need for individual contracts to pay for and wait for a data fetch, thus optimizing performance for DeFi applications.

key-features
ARCHITECTURE

Key Features of Push-Based Oracles

Push-based oracles are a data delivery architecture where the oracle network proactively initiates data updates to smart contracts, rather than waiting for a contract to request it. This design fundamentally changes the interaction model between on-chain and off-chain systems.

01

Proactive Data Delivery

The core mechanism where the oracle network pushes data updates to subscribed smart contracts without waiting for an on-chain request. This is the opposite of the pull-based model. Key aspects include:

  • Event-Driven Updates: Data is transmitted when predefined conditions are met (e.g., price deviation threshold, time interval).
  • Subscriber Model: Smart contracts register or subscribe to specific data feeds.
  • Reduced Latency for Critical Updates: Eliminates the request-response cycle delay for time-sensitive data.
02

Gas Cost Management

Push oracles shift the gas cost burden for data delivery from the end-user's contract to the oracle service or data consumer. This has significant implications:

  • Predictable Operating Costs: DApp developers can budget for data feeds as a service cost, rather than users paying variable gas for pulls.
  • Removes User Friction: Users don't pay gas for oracle calls, simplifying the transaction experience.
  • Oracle Incentive Alignment: The entity paying for the push (often the DApp or data provider) is directly incentivized to optimize update efficiency and cost.
03

Real-Time & Scheduled Updates

Supports multiple update triggers essential for different application needs:

  • Threshold-Based Updates: Push new data only when the off-chain value changes by a specified percentage (e.g., >0.5% for a price feed). This optimizes gas usage.
  • Heartbeat Updates: Guaranteed periodic updates (e.g., every block, every hour) to ensure data freshness even during low volatility.
  • On-Demand Pushes: A hybrid approach where a contract can signal the need for an immediate update, which is then pushed.
04

Enhanced Reliability for Critical Functions

The push model is particularly suited for applications where missing an update can cause system failure or significant loss.

  • Liquidation Engines: In lending protocols, timely price updates are critical to trigger liquidations before positions become undercollateralized. A push ensures the update is attempted.
  • Derivative Settlements: Options or futures that expire at a specific time require a precise price push at expiry.
  • Alerts & Keepers: Can act as a decentralized keeper network, pushing transactions to execute when conditions are met off-chain.
05

Subscriber Management & Access Control

Requires an on-chain mechanism to manage which contracts receive data pushes and under what terms.

  • Registry Contracts: Maintain a list of authorized subscriber addresses for a given data feed.
  • Subscription Models: May implement fee-based subscriptions, granting push access for a period.
  • Permissioning: Allows for private data feeds where pushes are only sent to whitelisted contracts, useful for enterprise or institutional DeFi applications.
06

Comparison with Pull-Based Oracles

Understanding the trade-offs between push and pull models is crucial:

  • Initiator: Push = Oracle, Pull = Smart Contract.
  • Gas Payer: Push = Oracle/Sponsor, Pull = End User (tx sender).
  • Data Freshness: Push = Proactively maintained, Pull = Only fresh when requested.
  • Use Case Fit: Push is optimal for high-frequency, critical data (e.g., DEX prices, liquidation triggers). Pull is optimal for low-frequency, on-demand data (e.g., NFT rarity score, weather data for a parametric insurance claim).
examples
PUSH-BASED ORACLE

Examples & Use Cases

Push-based oracles proactively deliver external data to smart contracts, enabling real-time execution for applications requiring immediate responses. This section explores their primary applications.

02

Dynamic NFT & Gaming

In blockchain gaming and dynamic NFTs, push oracles enable real-world state changes to affect digital assets. Examples include:

  • An NFT whose appearance changes based on real-time weather data.
  • A game where in-game events are triggered by sports scores or election results.
  • Autonomous World mechanics that evolve based on external API feeds, pushed on-chain without user intervention.
03

Cross-Chain Messaging & Bridges

Secure cross-chain bridges often use a push-based oracle model for message relaying. When a transaction is finalized on a source chain (e.g., Ethereum), an off-chain relayer network validates the proof and proactively pushes a verification message and instruction to the destination chain (e.g., Avalanche), finalizing the asset transfer or contract call.

04

Insurance & Parametric Triggers

Parametric insurance smart contracts rely on push oracles for automatic payout execution. The contract defines objective parameters (e.g., hurricane wind speed at a specific location, flight delay duration). When a trusted oracle network verifies the qualifying event has occurred, it pushes the data on-chain, triggering an instant and transparent payout to policyholders.

05

Real-World Asset (RWA) Settlement

For tokenized real-world assets like commodities or invoices, push oracles facilitate final settlement. Upon confirmation of a physical delivery or payment in the traditional system, an authorized oracle pushes a verified attestation to the blockchain. This automatically triggers the release of digital tokens or updates the asset's on-chain status, bridging TradFi and DeFi.

DATA DELIVERY MODEL

Push-Based vs. Pull-Based Oracle

A comparison of the two fundamental architectures for how oracles provide off-chain data to on-chain smart contracts.

FeaturePush-Based OraclePull-Based OracleHybrid Oracle

Data Delivery Initiator

Oracle Node / Network

Smart Contract / User

Configurable (either)

Primary Use Case

Automated updates (e.g., price feeds)

On-demand, infrequent data

Balanced cost & latency needs

On-Chain Gas Cost Payer

Oracle service provider

Contract caller / end-user

Shared or configurable

Update Latency

Predictable, periodic (e.g., 1 block)

Variable, request-dependent

Configurable based on trigger

Data Freshness Guarantee

Yes, via scheduled updates

No, depends on request

Conditional, based on model

Infrastructure Cost Model

Subscription or protocol-funded

Pay-per-query

Mixed (base + usage)

Example Protocols

Chainlink Data Feeds, Pyth

Chainlink Any API, API3 dAPIs

Supra Oracles, DIA

Trust Assumption

Relies on oracle network liveness

Relies on user to trigger updates

Depends on implementation

ecosystem-usage
PUSH-BASED ORACLE

Ecosystem Usage

Push-based oracles, where data is proactively sent to smart contracts, are deployed in applications requiring high-frequency, low-latency data updates. This section details their primary use cases and the protocols that implement them.

06

Dynamic NFTs & Gaming

Push-based oracles enable reactive NFTs and game assets that change based on external events. An oracle can push data like real-world weather, sports scores, or in-game leaderboard updates to a smart contract, which then updates the NFT's metadata or attributes on-chain.

  • Key Function: Providing real-time data to mutate NFT state.
  • Use Case: An NFT that changes its appearance based on the holder's local temperature or a game item that gains power based on real-time esports results.
security-considerations
PUSH-BASED ORACLE

Security Considerations

While push-based oracles offer automation, they introduce unique security vectors centered on data delivery, transaction execution, and the oracle's operational integrity.

01

Transaction Execution Risk

The oracle's transaction to push data on-chain can fail due to gas price spikes, network congestion, or insufficient gas limits. This creates a single point of failure for the data feed, potentially causing cascading liquidations or protocol malfunctions in dependent smart contracts. Mitigations include using gas price oracles and setting aggressive gas limits.

02

Centralized Relayer Vulnerability

The relayer (the entity broadcasting the transaction) is a critical centralized component. If compromised or malicious, it can:

  • Censor data by refusing to submit updates.
  • Front-run its own transactions for profit.
  • Be taken offline by a DDoS attack. Decentralizing the relayer function or using a permissioned set of relayers with slashing mechanisms can reduce this risk.
03

Data Authenticity & Source Integrity

Security depends on the initial data source. Key threats include:

  • Compromised API keys or endpoints.
  • Manipulation of the underlying data source (e.g., fake trading volume on a CEX).
  • Sybil attacks on decentralized data aggregation layers. Oracles must implement robust cryptographic attestations (like TLSNotary proofs) and source redundancy to verify data provenance before pushing.
04

Update Frequency & Staleness

Infrequent updates create stale price scenarios, allowing arbitrageurs to exploit the lag. However, overly frequent updates increase operational costs and attack surface. A malicious actor could flood the network with updates to drain the oracle's funding wallet. Protocols must balance update frequency with cost and liveness guarantees.

05

Funding & Economic Security

The oracle requires a continuously funded wallet to pay for gas fees. If depleted, the data stream halts. This creates an economic attack vector: an attacker could artificially inflate gas prices to drain the wallet faster. Solutions involve automated replenishment mechanisms and circuit breakers that trigger if balances fall below a threshold.

06

Smart Contract Integration Risks

The receiving contract must securely handle the pushed data. Risks include:

  • Lack of access controls, allowing any address to call the update function.
  • Improper validation of the oracle's signature or caller address.
  • Reentrancy vulnerabilities triggered by the update callback. Contracts should use commit-reveal schemes or time-locks for critical updates to prevent flash loan manipulation.
PUSH-BASED ORACLE

Frequently Asked Questions (FAQ)

Common questions about the architecture, security, and use cases of push-based oracles, which actively deliver off-chain data to on-chain smart contracts.

A push-based oracle is a data feed system that actively initiates and delivers off-chain data to a blockchain smart contract. It works by having a network of node operators or a single provider monitor external data sources, and upon a predefined condition (like a time interval or price deviation), they push a signed data transaction directly onto the blockchain, updating the contract's state. This contrasts with a pull-based oracle, where the smart contract must request the data. Key components include an off-chain data aggregator, a signing mechanism for data integrity, and an on-chain contract (like an Aggregator or Feed) that stores the verified value for others to read.

ENQUIRY

Get In Touch
today.

Our experts will offer a free quote and a 30min call to discuss your project.

NDA Protected
24h Response
Directly to Engineering Team
10+
Protocols Shipped
$20M+
TVL Overall
NDA Protected Directly to Engineering Team