A verified pool's recent activity

get/dex/pools/{poolNft}/activity/recent

GET /dex/activity/recent for any verified pool. On a token/token pool ergIn means X was sold. Collected for verified pools only.

Path parameters

poolNftstringrequired
The pool's NFT id, 64 hex characters

Query parameters

limitinteger · int32
Most entries

Responses

200Recent pool transitions, newest firstLDRecentActivity▶

▶
activityLDActivityEntry[]required
- txIdstringrequired
- typestringrequired
  SWAP trades against the reserves. DEPOSIT opens a provision and REDEEM closes one. RESIZE changes a provision's size and flushes. FLUSH moves pending fees to the vault.
  one ofSWAPDEPOSITREDEEMRESIZEFLUSH
- viastringrequired
  ORDER when the transaction fills a LithosDex order, DIRECT otherwise. RESIZE and FLUSH are always DIRECT.
  one ofORDERDIRECT
- orderBoxIdstring
  The order this transaction filled. Present when via is ORDER.
- statusstringrequired
  MEMPOOL entries are unconfirmed and can still be dropped or replaced. They are listed ahead of every confirmed entry.
  one ofMEMPOOLCONFIRMED
- heightinteger · int32
  Block height. Present when CONFIRMED.
- timestampinteger · int64
  Unix milliseconds. Present when CONFIRMED and resolved.
- ergInboolean
  SWAP only. True when ERG was sold for the token.
- amountInstring
  SWAP only. Raw units handed to the pool, pool fees included. Decimal string.
- amountOutstring
  SWAP only. Raw units received. Decimal string.
- amountXstring
  Not present for SWAP. nanoERG added to the reserves by a DEPOSIT or a growing RESIZE, returned from them by a REDEEM or a shrinking RESIZE, or moved to the vault by a FLUSH. Decimal string.
- amountYstring
  Not present for SWAP. Token side of amountX. Decimal string.
- sharesstring
  DEPOSIT, REDEEM and RESIZE only. Shares issued or closed; for RESIZE, the signed change. 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.
- 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.
partialboolean
Present and true for stale snapshots; inspect stats.historyComplete for history coverage.

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 fee history Next →A provision's fee history on a verified pool

{ "activity": [ { "txId": "9f3c1ab7d2e45806c91f7b3ad4e2091856cbf740e3a92d5178cc0b46e21f5d38", "type": "SWAP", "via": "ORDER", "orderBoxId": "5035b2e112b4f5b873dd3444c01df1e7e697807fd84fe96790eacb128e46428d", "status": "CONFIRMED", "height": 484719, "timestamp": 1765432100000, "ergIn": true, "amountIn": "12400000000", "amountOut": "441820000", "amountX": "5000000000", "amountY": "151058823", "shares": "1176470" } ], "stats": { "status": "disabled", "updatedAt": 0, "sourceHeight": 0, "sourceBlockId": "string", "windowStartHeight": 0, "coverageStartHeight": 0, "historyComplete": true, "refreshing": true, "restored": true, "error": "string", "collectedFrom": 0 }, "partial": true }