Skip to main content
Chaos price oracles deliver high-precision price data, integrated with a risk engine powered by Chaos Labs’ advanced outlier and anomaly detection models. It provides real-time price feeds for a wide range of crypto assets through a robust multi-layered architecture that ensures reliability and accuracy.

How Pull Oracles Work

Chaos pull oracles follow a secure, verifiable workflow to deliver on-demand price data:
1

Request price data

Your application sends a request to the Chaos API endpoint whenever price data is needed.
2

Receive signed API response

The API responds with a signed message and the associated response data, including the asset price, timestamp, and cryptographic signature.
3

Verify signature on-chain

To ensure data integrity, your on-chain program verifies the signature against a pre-approved set of trusted signers before accepting the price update.
4

Process verified price data

Once verification succeeds, the price data is processed and made available to your application.
This design prioritizes simplicity and security while minimizing infrastructure requirements. This oracle is particularly well-suited for applications that require reliable price data with high-frequency updates.

When to Use Pull Oracles

Pull oracles are designed for applications that require real-time price data with maximum flexibility and minimal on-chain overhead. They’re particularly well-suited for scenarios where you need on-demand price updates rather than continuous on-chain updates. They are most commonly used by perpetual exchanges and DeFi protocols that require low-latency price feeds for ultra-fast updates, they can also be used by analytics platforms that process price data off-chain.

Why Use Pull Oracle

Chaos pull oracle achieves remarkable efficiency through the compact payload structure. Each price update message contains just the essential data. This is notably smaller than many other oracle solutions because: There’s no extra metadata, flags, or padding—just the core data needed for secure price verification. When this payload is submitted on-chain, its compact size directly translates to lower gas costs for users of the oracle.

Requesting Price Data

For details on available functions, parameters, and example responses, refer to the API reference. This ensures a single source of truth for all oracle interaction methods.
To explore a full list of available feeds, visit the feeds dashboard.

Signature Verification

After receiving the price data response, you must verify the cryptographic signature to ensure data integrity and authenticity. The signature verification process validates that the price data comes from a trusted Chaos oracle and hasn’t been tampered with. For detailed implementation guidance on signature verification, refer to our EVM and SVM integration guide.
I