GET
/
api
/
waitlist
/
v2
/
leaderboard
GET /api/waitlist/v2/leaderboard?timeframe=weekly&limit=10
Authorization: Bearer <token>
{
  "success": true,
  "data": {
    "leaderboard": [
      {
        "rank": 1,
        "user": {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "handle": "cryptoking",
          "tier": "platinum"
        },
        "score": 15420,
        "referrals": 45
      },
      {
        "rank": 2,
        "user": {
          "id": "660e8400-e29b-41d4-a716-446655440001",
          "handle": "moonwalker",
          "tier": "gold"
        },
        "score": 12350,
        "referrals": 32
      }
    ],
    "userRank": 15
  }
}

Query Parameters

timeframe
string
default:"all_time"
Leaderboard timeframe: all_time, monthly, or weekly
limit
number
default:"20"
Number of entries to return (max 100)

Response

leaderboard
array
Array of leaderboard entries
userRank
number
Current user’s rank (if authenticated)
GET /api/waitlist/v2/leaderboard?timeframe=weekly&limit=10
Authorization: Bearer <token>
{
  "success": true,
  "data": {
    "leaderboard": [
      {
        "rank": 1,
        "user": {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "handle": "cryptoking",
          "tier": "platinum"
        },
        "score": 15420,
        "referrals": 45
      },
      {
        "rank": 2,
        "user": {
          "id": "660e8400-e29b-41d4-a716-446655440001",
          "handle": "moonwalker",
          "tier": "gold"
        },
        "score": 12350,
        "referrals": 32
      }
    ],
    "userRank": 15
  }
}

Authorizations

Authorization
string
header
required

Dynamic authentication JWT token

Query Parameters

timeframe
enum<string>
default:all_time
Available options:
all_time,
monthly,
weekly
limit
integer
default:20
Required range: 1 <= x <= 100

Response

200 - application/json

Leaderboard data

The response is of type object.