Points API

The leaderboard is public. Account points and referral changes require a signed-in session.

Point units

The API returns point totals as pointMillis decimal strings. Divide by 1,000 to display points.

displayed points = pointMillis / 1,000

GET /api/points/leaderboard

{
  "entries": [
    {
      "account": "0xWICKPLAY_ACCOUNT",
      "pointMillis": "1250000",
      "rank": 1
    }
  ],
  "season": "Season 0"
}

The response contains up to 100 accounts, ordered by points.

GET /api/points/account
Cookie: wickplay_session=...

The response includes:

Field	Meaning
`account`	Signed-in WickPlay account
`pointMillis`	Total points in thousandths
`rank`	Current leaderboard rank
`season`	Current points season
`tokenIds`	WickPass token IDs held by the account
`wickPassBoostBasisPoints`	Combined WickPass boost, capped at 50,000
`activeMultiplierBasisPoints`	Total multiplier, from 10,000 to 60,000
`referral.code`	Referral code owned by this account
`referral.joined`	Qualified referrals
`referral.pending`	Referrals that have not qualified
`referral.earnedPointMillis`	Points earned by the referrer in thousandths

For multipliers, 10,000 basis points equals 1.00x and 60,000 equals 6.00x.

POST /api/points/referrals
Content-Type: application/json
Origin: https://wickplay.com
Cookie: wickplay_session=...

{
  "code": "WICK-XXXXXXXX"
}

A new referral returns 201:

{
  "accepted": true,
  "status": "pending"
}

An account cannot refer itself or replace an existing referral. The referral qualifies under the points rules.