Arcus points program API. Weekly points are uploaded by an administrator;
everything else is public and read-only. Addresses on the leaderboard are
anonymized (0xd99…6c4).
| Endpoint | Description |
|---|---|
GET /v1/leaderboard?window=season|all&limit=&offset= |
Ranked, anonymized leaderboard: rank, masked address, points, tier. |
GET /v1/points/{address} |
Season & all-time points, season rank, tier, weekly distribution history, next drop time. |
GET /v1/meta |
Active season, tier definitions, latest distributed week, next drop time (Sundays 12:00 UTC). |
GET /healthz | Liveness (checks the database). |
POST /admin/weeks |
Admin only (bearer token): upload one week of points, JSON or CSV. Re-uploading a week replaces it. |
Percentile-based over season rank:
| Tier | Share | Cutoff |
|---|---|---|
| Diamond | 3% | top 3% |
| Platinum | 7% | top 10% |
| Gold | 15% | top 25% |
| Silver | 25% | top 50% |
| Bronze | 50% | top 100% |
curl /v1/points/0xd993dcb195be82e2357a7b4222cfc9d89d89e6c4
{
"season": "Season 0", "season_points": 10024, "season_rank": 1,
"tier": "Diamond", "total_points": 10024,
"weekly": [{ "week_start": "2026-09-13", "points": 10024, ... }],
"next_drop_at": "2026-09-27T12:00:00.000Z"
}