Price Oracles

Leverage real-time market price data in your Clarity smart contract

Smart contracts written in Clarity run in a deterministic sandbox: they can read data in the Stacks and Bitcoin chainstate, but nothing else. Whenever your dApp needs the latest BTC/USD, STX/BTC, or any other market price, you’ll rely on an oracle to bring that data on‑chain in a verifiable way.

This page explains why price‑feed oracles matter on Stacks and links to the specific oracle provider docs with instructions on how to integrate them.

---

Why you need a price‑feed oracle

For DeFi smart contracts, it’s crucial to leverage trusted sources for asset pricing, which has profound implications for investor returns and trading strategies.

Here are some possible scenarios where you might need an oracle.

On‑chain need	Typical Stacks use case	What the oracle supplies
Liquidations & collateral ratios	Lending / borrowing protocols, margin trading	Signed price updated every N blocks
Stablecoin peg maintenance	BTC‑backed or exogenous‑collateral stablecoins	Reference BTC/USD (or other) price
AMM curve calculations	DEXs that tune fees or rebalance pools	Time‑weighted average price (TWAP)
Derivatives settlement	Options, futures, or perpetual swaps	Final settlement price at expiry

Rule of thumb: if your contract’s math depends on a real‑time market price, you need a price‑feed oracle.

Oracle Providers for Stacks

Here are the currently available oracle providers that Stacks builders commonly use for price data.

Pyth

Pyth is a pull-based oracle. Stacks Labs currently maintains the Pyth bridge.

Learn how to use Pyth.

DIA

DIA is another oracle provider used by Stacks builders. See DIA's guide for how to use DIA oracles with Stacks. Check out the video tutorial to learn more on how DIA works for Clarity smart contracts: