Season Standings

Season Standings

Examples for fetching and analyzing season standings and championship data.

Driver Standings

Get Current Standings

import { IRacingDataClient } from 'iracing-data-client';

const iracing = new IRacingDataClient({
  auth: {
    type: 'password-limited',
    clientId: process.env.IRACING_CLIENT_ID!,
    clientSecret: process.env.IRACING_CLIENT_SECRET!,
    username: process.env.IRACING_USERNAME!,
    password: process.env.IRACING_PASSWORD!,
  },
});

async function getDriverStandings(seasonId: number, carClassId: number) {
  const standings = await iracing.stats.seasonDriverStandings({
    seasonId,
    carClassId,
    raceWeekNum: -1  // -1 for overall standings
  });

  // Top 10 drivers
  standings.driverStandings.slice(0, 10).forEach(driver => {
    console.log(`${driver.position}. ${driver.displayName}`);
    console.log(`   Points: ${driver.points}`);
    console.log(`   Wins: ${driver.wins}`);
    console.log(`   Weeks Counted: ${driver.weeksCountedChampPoints}`);
  });

  return standings;
}

Track Your Position

async function trackMyStanding(seasonId: number, carClassId: number) {
  const myInfo = await iracing.member.info();
  const standings = await iracing.stats.seasonDriverStandings({
    seasonId,
    carClassId
  });

  const myStanding = standings.driverStandings.find(
    d => d.custId === myInfo.custId
  );

  if (myStanding) {
    console.log(`Your position: ${myStanding.position}`);
    console.log(`Points: ${myStanding.points}`);
    console.log(`Gap to leader: ${standings.driverStandings[0].points - myStanding.points}`);

    // Find next position
    const nextDriver = standings.driverStandings[myStanding.position - 2];
    if (nextDriver) {
      console.log(`Points to next position: ${nextDriver.points - myStanding.points}`);
    }
  }

  return myStanding;
}

Team Championships

Get Team Standings

async function getTeamStandings(seasonId: number, carClassId: number) {
  const standings = await iracing.stats.seasonTeamStandings({
    seasonId,
    carClassId
  });

  return standings.teamStandings.map(team => ({
    position: team.position,
    teamName: team.teamName,
    points: team.points,
    wins: team.wins,
    droppedPoints: team.droppedPoints
  }));
}

See Also

• Stats Service - Full API reference for stats
• Race Results - Race results examples
• Member Data - Member profile examples