Skip to main content
GET
Get your referral position (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.

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. The same wallet as the first upline entry whenever upline is not empty; never an 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.

upline
object[] | null

The caller's referral chain upward, nearest first: L1 (who referred the caller), then L2 (who referred them), and so on: the levels the caller's trades on this client application pay (at most 10). Shorter when the chain ends; empty when the caller was not referred or this client application pays no referral levels. These are the wallets the caller's own trades on this client application pay referral rewards to.