Compute an Elo rating change for a single game

Pure arithmetic. Returns the new rating, point change, and expected score.

get/elo-calculator

Request

Base URL
https://www.chessigma.com/public-api/v1
Auth
none required
TypeScript
https://skmtc.dev/chessigma/apis/chessigma-public-api/docs/elo-calculator/get.ts
A function with typed inputs. Its response is checked against the schema.

yourRatinginteger required

Your rating before the game.

opponentRatinginteger required

Your opponent's rating before the game.

result'win' | 'draw' | 'loss' required

The game's result for you.

system'fide' | 'chesscom' | 'lichess'

The rating system whose default K-factor applies.

kFactorinteger

Override the default K-factor for the chosen system.

Computed rating change

yourRatinginteger

opponentRatinginteger

result'win' | 'draw' | 'loss'

system'fide' | 'chesscom' | 'lichess'

kFactorinteger

The K-factor used: kFactor if you passed one, otherwise the system's default.

expectedScorenumber

Probability of scoring, from 0 to 1.

newRatinginteger

Your rating after the game.

changeinteger

newRating minus yourRating.

No recorded changes to this operation across all 1 revision of this API.