Global Leaderboards

Leaderboards rank players globally by score. Create multiple boards (seasonal, weekly, daily) and moderate fraudulent entries.

Creating a Leaderboard

1. Go to Players > Leaderboards
2. Click New Board and define:
   • Name: weekly_boss_speedrun
   • Type: Highscore (higher is better) or Lowscore (lower is better)
   • Period: Weekly, Monthly, or All-Time
   • Reset Schedule: Auto-reset date (optional)
3. Click Save

Submitting Scores

Use the dedicated SDK function for score submission:

# Submit a score with optional metadata
QuestData.submit_score("weekly_boss_speedrun", 1250, {
    "difficulty": "hard",
    "time_seconds": 180,
    "items_used": 2
}, "PlayerName")

# Fetch rankings
QuestData.get_leaderboard("weekly_boss_speedrun", 10, func(entries: Array):
    for entry in entries:
        print("#%d %s - %d" % [entry["rank"], entry["player_name"], entry["score"]])
)

See the SDK Leaderboards guide for full API details including throttling and buffering.

Score Updates

Scores update instantly with 5-second throttling to prevent spam:

• First entry: Immediately visible
• Improvement within 5s: Queued, sent in batch
• Same or lower score: Rejected (no entry created)

Leaderboard Views

Tab	Shows
Top 100	Your top 100 players
Your Rank	Where you stand globally
Friends	Friends near your score
Score History	Your submission history

Moderation Tools

Suspicious scores marked with ⚠️ (likely cheaters):

1. Click a suspicious entry
2. Review the metadata (time, difficulty)
3. Ban (remove and block future entries) or Approve

Seasonal Reset

Leaderboards automatically reset based on schedule:

Period	Reset Frequency
Daily	00:00 UTC
Weekly	Monday 00:00 UTC
Monthly	1st of month
All-Time	Never

Previous period scores are archived.

API Reference

# Submit score
curl -X POST "https://api.questdata.io/v1/leaderboards/weekly_boss_speedrun/entries" \
  -H "x-game-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "player_id": "player123",
    "score": 1250,
    "metadata": {"difficulty": "hard"}
  }'

# Get top 10
curl "https://api.questdata.io/v1/leaderboards/weekly_boss_speedrun?limit=10" \
  -H "x-game-api-key: YOUR_API_KEY"

Response:

{
  "leaderboard": "weekly_boss_speedrun",
  "entries": [
    { "rank": 1, "player_id": "player456", "score": 2500, "date": "2026-04-06T10:30:00Z" },
    { "rank": 2, "player_id": "player123", "score": 1250, "date": "2026-04-05T15:00:00Z" }
  ]
}