Current oracle state and recent confirmed history

get/oracles/{feedId}

The confirmed pool NFT box, its exact R4 raw rate and R5 epoch, converted price, age and recent history. USD v2 stores nanoERG per USD; USD per ERG is 1000000000 / rawValue. The displayed price is rounded to 18 decimal places; priceNumerator / priceDenominator preserves the exact rational conversion. Current and history boxes must match the configured NFT, guard hash and register types. History is newest first, including the current point on the first page, and defaults to the latest 100 confirmed pool updates. Set limit=0 for current state only. Offsets count NFT boxes, including governance transitions and the initial zero-price bootstrap box, which is omitted from price points. Follow nextOffset and pass the returned blockId as atBlockId to keep pagination on the same tip. stale uses creation-height age and the configured maxAgeBlocks, not wall-clock market freshness. Timestamps are confirmed block timestamps when available; missing ones are omitted and reported by timestampsComplete=false. A lagging index or unavailable/unsupported pool is 503; a tip change is 409.

Path parameters

feedIdstringrequired

Query parameters

offsetintegerdefault 0
limitintegerdefault 100
atBlockIdstring
Optional tip id returned by the preceding page; a changed tip requires pagination to restart.

Responses

200Confirmed node snapshot; a stale published price is returned with `stale=true`.OracleState▶

▶
feedOracleFeedrequired
- idstringrequired
- namestringrequired
- networkstringrequired
  one ofMAINNETTESTNET
- protocolstringrequired
- poolNftstringrequired
- ergoTreeHashstringrequired
  Configured full ErgoTree blake2b256. Governance changes require review of this pin.
- baseAssetstringrequired
- quoteAssetstringrequired
- rawUnitstringrequired
- priceUnitstringrequired
- baseDecimalsintegerrequired
- maxAgeBlocksintegerrequired
heightintegerrequired
blockIdstringrequired
indexedHeightintegerrequired
▶
currentOraclePointrequired
- boxIdstringrequired
- transactionIdstringrequired
- creationHeightintegerrequired
  Height committed by the pool box; used to compute ageBlocks.
- inclusionHeightintegerrequired
- epochintegerrequired
- rawValuestringrequired
  Exact positive R4 Long in the feed's rawUnit.
- pricestringrequired
  Converted quote units per base unit, rounded to 18 decimal places.
- priceNumeratorstringrequired
- priceDenominatorstringrequired
- ergoTreeHashstringrequired
- timestampinteger · int64
  Inclusion block timestamp in milliseconds, omitted if unavailable.
ageBlocksintegerrequired
stalebooleanrequired
ageBlocks exceeds the configured maxAgeBlocks; no wall-clock freshness is implied.
▶
historyOraclePoint[]required
- boxIdstringrequired
- transactionIdstringrequired
- creationHeightintegerrequired
  Height committed by the pool box; used to compute ageBlocks.
- inclusionHeightintegerrequired
- epochintegerrequired
- rawValuestringrequired
  Exact positive R4 Long in the feed's rawUnit.
- pricestringrequired
  Converted quote units per base unit, rounded to 18 decimal places.
- priceNumeratorstringrequired
- priceDenominatorstringrequired
- ergoTreeHashstringrequired
- timestampinteger · int64
  Inclusion block timestamp in milliseconds, omitted if unavailable.
offsetintegerrequired
limitintegerrequired
totalinteger
Indexed NFT box count, including the bootstrap box; omitted with limit=0.
nextOffsetinteger
Next NFT-box offset, absent at the end or when history is omitted.
timestampsCompletebooleanrequired

400Invalid paging or block id.ApiError▶

errorintegerrequired
Error code
reasonstringrequired
Error message explaining the reason of the error
detailstringrequirednullable
Detailed error description

404No configured feed with this id on the node's network.ApiError▶

errorintegerrequired
Error code
reasonstringrequired
Error message explaining the reason of the error
detailstringrequirednullable
Detailed error description

409Chain tip changed; retry the snapshot or restart pagination.ApiError▶

errorintegerrequired
Error code
reasonstringrequired
Error message explaining the reason of the error
detailstringrequirednullable
Detailed error description

503Node, index, oracle identity or supported pool state unavailable.ApiError▶

errorintegerrequired
Error code
reasonstringrequired
Error message explaining the reason of the error
detailstringrequirednullable
Detailed error description

← PreviousList configured oracle feeds Next →Wallet balances

{ "feed": { "id": "erg-usd", "name": "USD v2", "network": "MAINNET", "protocol": "oracle-pool-v2", "poolNft": "string", "ergoTreeHash": "string", "baseAsset": "ERG", "quoteAsset": "USD", "rawUnit": "nanoERG/USD", "priceUnit": "USD/ERG", "baseDecimals": 9, "maxAgeBlocks": 30 }, "height": 0, "blockId": "string", "indexedHeight": 0, "current": { "boxId": "string", "transactionId": "string", "creationHeight": 0, "inclusionHeight": 0, "epoch": 0, "rawValue": "string", "price": "string", "priceNumerator": "string", "priceDenominator": "string", "ergoTreeHash": "string", "timestamp": 0 }, "ageBlocks": 0, "stale": true, "history": [ { "boxId": "string", "transactionId": "string", "creationHeight": 0, "inclusionHeight": 0, "epoch": 0, "rawValue": "string", "price": "string", "priceNumerator": "string", "priceDenominator": "string", "ergoTreeHash": "string", "timestamp": 0 } ], "offset": 0, "limit": 0, "total": 0, "nextOffset": 0, "timestampsComplete": true }