Leaderboards

Access leaderboard data programmatically for your applications

import { CoderspaE } from '@coderspae/sdk';

const client = new CoderspaE({
  apiKey: process.env.CODERSPAE_API_KEY
});

// Get global leaderboard
const globalTop = await client.leaderboards.getGlobal({
  limit: 100,
  offset: 0
});

// Get tournament standings
const tournament = await client.leaderboards.getTournament({
  tournamentId: 'weekly-sprint-2024-42',
  live: true
});

// Get team rankings
const teamRankings = await client.leaderboards.getTeams({
  region: 'global',
  season: 'current'
});

// Get category specialists
const specialists = await client.leaderboards.getByCategory({
  category: 'dynamic-programming',
  timeframe: 'monthly'
});

// Get user ranking info
const userRank = await client.leaderboards.getUserRank({
  userId: 'current',
  includeStats: true
});

console.log('Your current rank:', userRank.globalRank);
console.log('Rating:', userRank.rating);
console.log('Percentile:', userRank.percentile);