Skip to main content
GET
Get My Referral Stats
Money and volume fields are raw USDC with 6 decimals, returned as strings — divide by 1e6 for the dollar amount.
Your current tier is not returned directly. Resolve it client-side as the highest 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

lmts-api-key
string
header
required

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

tiers
object[]
required

The active tier ladder, ascending. Render tier progress from this instead of hardcoding thresholds.

totalBasisRaw
string
required

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.

Example:

"31500000000"

totalEarnedRaw
string
required

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.

Example:

"184250000"

customTier
string

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.

Example:

"Gold"