A provision's fee history on a verified pool
/dex/pools/{poolNft}/provisions/{boxId}/fees/historyThe fees one provision earned over the collected window, from its size and entry as they stand now. Collected for verified pools only.
Path parameters
poolNftstringrequiredThe pool's NFT id, 64 hex characters
boxIdstringrequiredThe provision box
Query parameters
frominteger · int32First height
tointeger · int32Last height
bucketinteger · int32Bucket size in blocks, default 720
Responses
200The provision's fee seriesLDProvisionFeeHistory▶
boxIdstringrequired▶
historyLDFeeHistoryPoint[]requiredheightinteger · int32requiredBlock height at the end of this bucket
timestampinteger · int64Unix milliseconds at the end of this bucket. Absent if unresolved.
periodXstringrequirednanoERG fees taken during this bucket. Decimal string.
periodYstringrequiredcumulativeXstringrequirednanoERG fees taken from the start of the range to here. Decimal string.
cumulativeYstringrequired
partialbooleanrequiredTrue when the series does not reach back to the pool's start.
404Not a verified pool, or no live provision of the pool with that id.ApiError▶
errorintegerrequiredError code
reasonstringrequiredError message explaining the reason of the error
detailstringrequirednullableDetailed error description
503No snapshot yet, or the pool index is still building. Retry-After is 5 seconds.DexStatsUnavailable▶
errorintegerrequiredError code
reasonstringrequiredError message explaining the reason of the error
detailstringrequirednullableDetailed error description
▶
statsDexStatsViewrequiredstatusstringrequiredFreshness only. Coverage is a separate question — read
historyCompleteand a graph'spartial.one ofdisabledloadingreadystaleunavailableupdatedAtinteger · int64When the last successful refresh began, in Unix milliseconds, before it read the node.
sourceHeightinteger · int32sourceBlockIdstringThe chain tip checked before and after the read. Current price and activity can also include the mempool.
windowStartHeightinteger · int32Earliest height you can ask for, max(0,
sourceHeight- 21600).coverageStartHeightinteger · int32Oldest retained pool snapshot, including a predecessor where one exists.
historyCompletebooleanWhether the history read reached the start of the index, or a predecessor, before the requested window.
refreshingbooleanrequiredrestoredbooleanrequiredLoaded from disk. Stale until a node read succeeds, and never overwrites newer live data.
errorstringShort refresh failure message. Details stay in the client log.
collectedFrominteger · int32The 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▶
errorintegerrequiredError code
reasonstringrequiredError message explaining the reason of the error
detailstringrequirednullableDetailed error description