Skip to main content
POST/read
Also available through POST /info.

Request Body

string
required
Must be "userNonFundingLedgerUpdates".
string
required
User wallet address.
string[]
Optional subset of deposit, withdrawal, transfer, rewards, split, merge, redemption. Omit for the entire category; an empty array returns no entries. Other categories are rejected.
string
Optional canonical lowercase, nonzero 32-byte outcome operation or redemption ID. Looks up that wallet’s matching operation without scanning its history.
integer
Inclusive lower bound in Unix milliseconds. Omit to select the latest page.
integer
Inclusive upper bound in Unix milliseconds. Omit for no upper bound.
string
Exclusive row id lower bound at startTime, in code-unit order. Requires startTime; later timestamps are unaffected.
integer
Maximum entries: 1 to 100,000. Default: 2,000.
Rows are returned oldest first within the selected page. With startTime, the page contains the earliest matching entries at or after that time. To traverse retained history, set startTime to 0 (or your desired lower bound) and keep one fixed endTime for every request. After a full page, set startTime to the last row’s timestamp and afterId to that same row’s id. Keep limit fixed and stop when a page contains fewer entries. Deduplicate any overlapping rows by id. Pages are separate reads; endTime is a time filter, not a fixed snapshot. When overlapping requests, fail if a previously returned row in the requested overlap disappears or changes timestamp. Report failed or inconsistent reads as incomplete instead of returning a partial export.

Response

Response Fields

string
Stable row ID for deduplication.
number
Entry time in Unix milliseconds. Polygon member withdrawals use their committed event time because stored completedAt is zero. A terminal withdrawal can change time while retaining its row ID.
string
Entry identifier; bridge rows use the transfer ID, and rewards can use a synthetic ID. Actual transaction hashes are in transfer.txHash or the protocolTransfer receipt fields.
object
string
Optional pending, complete, or failed status.
object
Split, merge, or redemption details; present for outcome activity.
object
Deposit or withdrawal locations and recorded transfer details.
object
Bridge/conversion history from canonical transfer state, including transfers submitted on other devices and rows retained in snapshots. One row per transfer, with hash equal to the transfer ID and time equal to its request time. Internal liquidation debt recovery is excluded.