Skip to main content
GET
Get user movements

Authorizations

X-Monaco-Signature
string
header
required

Ed25519 session-key request signing. Every authenticated request carries three headers: X-Monaco-PublicKey (64-char lowercase-hex session public key), X-Monaco-Timestamp (Unix milliseconds, within 30s of server time), and X-Monaco-Signature (hex ed25519 signature). The signature is over METHOD\npath?query\ntimestamp_ms\nSHA256_hex(body), where the body hash is the SHA-256 of the empty byte string when there is no body. Obtain the session keypair from POST /api/v1/auth/challenge followed by POST /api/v1/auth/verify.

Query Parameters

pageSize
integer<uint32>
default:20

Items per page (max 1000)

Required range: 1 <= x <= 1000
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
orderBy
enum<string>
default:DESC

Sort direction for createdAt

Available options:
ASC,
DESC
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 row (or the oldest, when orderBy is ASC).
  • Non-empty: an opaque cursor from a previous response's nextPageToken; results resume immediately after that position.

Every walk covers the ledger and funding arms merged. total and totalPages are populated — bounded by the server count ceiling, see totalCapped. Filters and orderBy must match the request that produced the token, or the request is rejected 400.

Response

OK

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

Number of movements matching the filter, bounded by the server ceiling — a lower bound when totalCapped is true.

Example:

150

pageSize
integer<uint32> | null

Items per page

Example:

20

totalPages
integer<uint32> | null

Number of pages at this pageSize, bounded by the server ceiling — a lower bound when totalCapped is true.

Example:

8

nextPageToken
string | null

Cursor for the next page, minted from the last row of an over-fetched page. Each arm of the union is cut at the same over-fetched depth and the outer query orders the merged rows, so a page shorter than pageSize means both arms are exhausted and this is empty — a non-empty token always has at least one further row behind it.

totalCapped
boolean | null

True when more than the server ceiling of movements matched, so the count stopped at the ceiling and total/totalPages are a lower bound. False when total is exact, including exactly the ceiling.

Example:

false