A verified pool's fee history

get/dex/pools/{poolNft}/fees/history

GET /dex/fees/history for any verified pool. Collected for verified pools only, each other than ERG:LIT from the height it joined the verified list, stats.collectedFrom.

Path parameters

poolNftstringrequired
The pool's NFT id, 64 hex characters

Query parameters

frominteger · int32
First height
tointeger · int32
Last height
bucketinteger · int32
Bucket size in blocks, default 720

Responses

200Fee seriesLDFeeHistory▶

▶
historyLDFeeHistoryPoint[]required
- heightinteger · int32required
  Block height at the end of this bucket
- timestampinteger · int64
  Unix milliseconds at the end of this bucket. Absent if unresolved.
- periodXstringrequired
  nanoERG fees taken during this bucket. Decimal string.
- periodYstringrequired
- cumulativeXstringrequired
  nanoERG fees taken from the start of the range to here. Decimal string.
- cumulativeYstringrequired
partialbooleanrequired
True when the history scan could not cover the requested window or the snapshot is stale. Values are derived from accumulator differences with integer rounding, not payment receipts.
▶
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.
- collectedFrominteger · int32
  The height a verified pool other than ERG:LIT joined the verified list. Nothing before it is collected, so a graph covering earlier heights shows that range as not collected. Absent for ERG:LIT, whose whole life is collected.

400Heights outside the collected window, or too many points.ApiError▶

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

404Not a verified pool, so nothing is collected for it.ApiError▶

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

503No snapshot yet, or the pool index is still building. 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.
- collectedFrominteger · int32
  The height a verified pool other than ERG:LIT joined the verified list. Nothing before it is collected, so a graph covering earlier heights shows that range as not collected. Absent for ERG:LIT, whose whole life is collected.

defaultErrorApiError▶

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

← PreviousA verified pool's price history Next →A verified pool's recent activity