Skip to main content
GET
List application movements

Query Parameters

pageSize
integer<uint32>
default:20

Items per page (max 1000)

Required range: 1 <= x <= 1000
userId
string<uuid>

User identifier (UUID)

Minimum string length: 1
transactionType
enum<string>

Transaction type

Available options:
DEPOSIT,
WITHDRAWAL,
TRADE,
FEE,
FUNDING,
LIQUIDATION,
INTEREST,
REWARD,
CHAIN_SYNC
Minimum string length: 1
entryType
enum<string>

Ledger entry type

Available options:
CREDIT,
DEBIT,
LOCK,
UNLOCK,
FEE
Minimum string length: 1
assetId
string<uuid>

Asset identifier (UUID)

Minimum string length: 1
pageToken
string

Pagination cursor with two states:

  • Omitted or empty string (""): start a cursor walk with no prior position, from the newest movement.
  • Non-empty: an opaque cursor from a previous response's nextPageToken; results resume immediately after that position.

The response carries no item count: user_ledger is too large to count behind a filter. A movement with no recorded timestamp is not listed — the column is nullable, and a NULL has no position in the sort key.

Filters must match the request that produced the token, or the request is rejected 400.

clientId
string
required

Application client ID

Minimum string length: 1

Response

OK

movements
object[] | null
pageSize
integer<uint32> | null

Items per page

Example:

20

nextPageToken
string | null

Cursor for the next page, minted from the last row of an over-fetched page: this listing is one ordered read, so a page shorter than pageSize proves the walk is exhausted and this is empty.