Skip to main content
GET
Get your referral downline and earnings (deprecated PitPass path)

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:100

earningsBySource rows per page (max 500)

Required range: 1 <= x <= 500
pageToken
string

Opaque cursor from a previous response's nextPageToken; omit or send an empty string for the first page.

Response

OK

earningsBySource
object[] | null

One page of rows, one per (source account, level, token) the caller earns from, across every reward level, ordered by each source account's own total, largest first. A wallet that traded through several applications has one account per application: its rows within a page are merged into one row at the position of its first (largest) part, so a merged row can sit below a smaller one, and the wallet can appear again on a later page. Paged by pageSize / pageToken; follow nextPageToken for the rest. Comes from the caller's maintained reward totals — no tree walk.

directReferees
object[] | null

The caller's direct (L1) referees, newest first, including referees who have not traded yet (0 earned). Bounded to the most recent 500 EFFECTIVE referees (after per-wallet dedupe and the winning-edge filter). The summary counts every level and source and earnings_by_source pages through every row, so a caller past the roster cap still sees their full earnings; only this roster listing is capped.

summary
object | null

Total earned broken down by level. Covers every level and source regardless of the earnings_by_source page.

nextPageToken
string | null

Cursor for the next earningsBySource page; empty when there are no more rows.