Pool price history

get/dex/price/history

Reserve-ratio price over a range from a background snapshot. The series ends at the live pool price observed during the refresh, which may differ from a later /dex/pool request and may include mempool state. Ranges use two-minute target block times. Check partial and stats for coverage and freshness. Stale data remains available with partial: true; requests never perform node reads.

Query parameters

rangestringdefault "24H"1H | 24H | 7D | 30D
How far back to go
bucketinteger · int32
Positive bucket size in blocks. Defaults to about 60 buckets; at most 500 points including range boundaries.

Responses

200Price series for the requested rangeLDPriceHistory▶

rangestringrequired
The range served, echoed back
changePctnumber · doublerequired
Signed fraction across the range; 0.018 is +1.8%
partialbooleanrequired
True when the series does not span the whole range or the snapshot is stale.
▶
historyLDPricePoint[]required
- heightinteger · int32required
- timestampinteger · int64
  Unix milliseconds. Absent if unresolved.
- pricenumber · doublerequired
  Token per ERG with the token's decimals applied. A display value — recompute from the reserves if you need it exact.
- reservesXstringrequired
  nanoERG the AMM traded with at this point. Decimal string.
- reservesYstringrequired
  Raw token units the AMM traded with at this point. Decimal string.
▶
statsDexStatsView
- statusstringrequired
  Freshness only. Coverage is a separate question — read historyComplete and a graph's partial.
  one ofdisabledloadingreadystaleunavailable
- updatedAtinteger · int64
  When the last successful refresh began, in Unix milliseconds, before it read the node.
- sourceHeightinteger · int32
- sourceBlockIdstring
  The chain tip checked before and after the read. Current price and activity can also include the mempool.
- windowStartHeightinteger · int32
  Earliest height you can ask for, max(0, sourceHeight - 21600).
- coverageStartHeightinteger · int32
  Oldest retained pool snapshot, including a predecessor where one exists.
- historyCompleteboolean
  Whether the history read reached the start of the index, or a predecessor, before the requested window.
- refreshingbooleanrequired
- restoredbooleanrequired
  Loaded from disk. Stale until a node read succeeds, and never overwrites newer live data.
- errorstring
  Short refresh failure message. Details stay in the client log.

400Unknown `range`, or a `bucket` that would return too many points.ApiError▶

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

503No cached snapshot; statistics are loading, unavailable, or disabled. Retry-After is 5 seconds.DexStatsUnavailable▶

errorintegerrequired
Error code
reasonstringrequired
Error message explaining the reason of the error
detailstringrequirednullable
Detailed error description
▶
statsDexStatsViewrequired
- statusstringrequired
  Freshness only. Coverage is a separate question — read historyComplete and a graph's partial.
  one ofdisabledloadingreadystaleunavailable
- updatedAtinteger · int64
  When the last successful refresh began, in Unix milliseconds, before it read the node.
- sourceHeightinteger · int32
- sourceBlockIdstring
  The chain tip checked before and after the read. Current price and activity can also include the mempool.
- windowStartHeightinteger · int32
  Earliest height you can ask for, max(0, sourceHeight - 21600).
- coverageStartHeightinteger · int32
  Oldest retained pool snapshot, including a predecessor where one exists.
- historyCompleteboolean
  Whether the history read reached the start of the index, or a predecessor, before the requested window.
- refreshingbooleanrequired
- restoredbooleanrequired
  Loaded from disk. Stale until a node read succeeds, and never overwrites newer live data.
- errorstring
  Short refresh failure message. Details stay in the client log.

defaultErrorApiError▶

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

← PreviousPool-wide fee history Next →Recent pool activity