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. currentRate (optional) is the live materialized referral rate from your open tier-state row; it already reflects any pin or rate floor and any promotion past it, and is absent until a tier state has been materialized. customTierRate (optional, exclusive with customTier) is an ops rate floor: when it is higher than your volume tier’s ladder rate, your current tier is a custom tier at this rate, and volume can still promote you past it. 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"