Get My Referral Stats
Your own referral standing: cumulative CLOB trading volume (the tier basis), total USDC earned from the referral program, and the active tier ladder. The current tier is not sent - resolve it as the highest ladder entry whose minBasisRaw your totalBasisRaw clears.
1e6 for the dollar amount.tiers entry whose minBasisRaw your totalBasisRaw clears. When a customTier pin is present it acts as a floor: the effective tier is the higher of the pin and the volume-derived tier.
totalEarnedRaw is your accrued referral earnings. Earnings become payable once the underlying markets resolve and are then included in the daily payout — see the Referral Program guide.Authorizations
Scoped API token with HMAC-SHA256 signing. Requires three headers: lmts-api-key (token ID), lmts-timestamp (ISO-8601), lmts-signature (Base64-encoded HMAC). See Authentication docs for details.
Response
Referral stats for the authenticated user
The active tier ladder, ascending. Render tier progress from this instead of hardcoding thresholds.
Your own CLOB trading volume (maker + taker fills) accrued since the program start - the tier basis. Raw USDC with 6 decimals, returned as a string. Divide by 1e6 for the dollar amount.
"31500000000"
Total USDC earned from the referral program across your referred users' eligible fills. Raw USDC with 6 decimals, returned as a string. Divide by 1e6 for the dollar amount.
"184250000"
Pinned minimum tier name. Present only when a manual tier pin exists (for example a partner arrangement). The pin is a floor: the effective tier is the higher of this and the volume-derived tier.
"Gold"