Skip to content
EnabledTier AIdentity & Oracles

PriceOracle XLS-47

Price oracles publish external asset-pair data directly in the ledger. PriceOracle is enabled on the XRP Ledger. xrpscan reports Nov 2, 2024 (UTC) as its activation date and rippled 2.2.0 as its first version.

Sources reviewed Oct 5, 2026 · English page updated Oct 5, 2026 · Phil · CryptoTuts founder

Status
Enabled
XLS
XLS-47
Enabled
Nov 2, 2024 (UTC)

What does this amendment change?

Why does this amendment exist?

On-ledger applications need standardized publications of external asset-pair data instead of integrating every price source in its own format.

How does the mechanism work?

OracleSet creates or updates up to ten timestamped asset pairs from a provider in an Oracle ledger object. AssetPrice is interpreted as an integer with Scale. OracleDelete removes the object, while get_aggregate_price can combine multiple published sources using a time window and optional trimming.

What changes compared with the predecessor?

BeforeAfter
Applications obtained external prices through their own off-ledger interfaces and formats.Price providers can publish standardized series in the ledger that multiple applications and aggregation queries can read together.

Who is this change relevant to?

XRP holders and users

An on-ledger price is a signed publication by its provider, not an assurance of an accurate or executable market price.

Wallets and app developers

Apps must check the provider, LastUpdateTime, asset pair, Scale, and any missing AssetPrice values and protect against outliers using multiple sources.

Exchanges and issuers

Data providers can publish up to ten pairs per object and explicitly mark old values as no longer current.

Node operators

Nodes store and aggregate compact price series but do not assess market accuracy or provider trustworthiness.

What limitations and risks remain?

  • The ledger confirms only the origin and state of the publication, not its economic accuracy.
  • An Oracle ledger object contains at most ten PriceData entries.
  • Provider and URI are not validated for content. URI is limited to 256 bytes and AssetClass to 16 ASCII characters.
  • A missing AssetPrice for a pair marks a stale value. Consumers need to check older objects or other sources.
  • Applications remain responsible for source selection, freshness limits, and outlier handling.

What fee and performance figures does the specification provide?

  • More than five PriceData entries in an Oracle ledger object require two owner reserves.
  • When a current price is missing, get_aggregate_price checks at most three earlier Oracle objects per source.
Technical details: transactions, fields, codes and invariants

Transactions

  • OracleSet
  • OracleDelete

Ledger objects

  • Oracle

Fields and flags

  • OracleDocumentID
  • Owner / Provider
  • LastUpdateTime
  • PriceDataSeries (at most 10)
  • BaseAsset / QuoteAsset
  • AssetPrice / Scale
  • AssetClass
  • URI

API methods

  • ledger_entry
  • get_aggregate_price

How does this amendment relate to others?

Every direct relationship has a type, an explanation and a primary source.

What happens next for this amendment?

PriceOracle is enabled on the XRP Ledger. xrpscan reports Nov 2, 2024 (UTC) as its activation date and rippled 2.2.0 as its first version.

These rules are already part of Mainnet. Server operators need a compatible xrpld (formerly rippled) version; ordinary wallet users do not need to enable anything manually.

Where does it sit within its amendment family?

Escrow and Payment Channels: protocol progression

  1. PayChanEnabled · from rippled 0.33.0
  2. CryptoConditionsEnabled · from rippled 0.50.0
  3. EscrowEnabled · from rippled 0.60.0
  4. fix1512Enabled · from rippled 0.80.0
  5. fix1523Enabled · from rippled 0.80.0
  6. fix1571Enabled · from rippled 1.0.0
  7. fixPayChanRecipientOwnerDirEnabled · from rippled 1.4.0
  8. PriceOracleEnabled · from rippled 2.2.0
  9. TokenEscrowEnabled · from rippled 2.5.0
  10. fixPayChanCancelAfterEnabled · from rippled 2.5.0
  11. fixIncludeKeyletFieldsEnabled · from rippled 3.0.0
  12. fixPriceOracleOrderEnabled · from rippled 3.0.0
  13. SmartEscrowIn development

Which primary sources support this information?

← All XRPL amendments and XLS specifications