Skip to main content
GET
Get one level of your referral tree

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

parent
string
pageSize
integer<uint32>
default:50

Nodes per page (max 200)

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

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

Response

OK

parent
string | null

Wallet address whose referees nodes lists — the caller's own wallet when the request omitted parent.

parentLevel
integer<int32> | null

Depth of parent below the caller: 0 for the caller, 1 or 2 for a referee being expanded. Every node is one level deeper.

Required range: x <= 2
nodes
object[] | null

The wallets parent referred, newest first. A wallet that signed up under several referrers (one per app) appears only under the referrer the reward engine pays.

nextPageToken
string | null

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