Skip to main content
GET
Get your referral position

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.

Response

OK

referrer
string | null

Public wallet address of the caller's direct (L1) referrer — who referred them. Empty when the caller was not referred. Never exposes L2/L3 upline or any internal id.

Example:

"0x0000000000000000000000000000000000000002"

totalEarned
string | null

Total reward amount the caller has earned, summed across every level and token, in RAW atomic units.

Example:

"1400000"

referrerDisplay
string | null

Human-facing name for the referrer: their custom TraderCode handle when they have claimed one, otherwise the wallet address (same as referrer). Empty when the caller was not referred. Render this instead of raw hex.

Example:

"cooltrader123"

rewards
object[] | null

The caller's most recent reward rows, newest first. Bounded server-side — not the full history.