Sign in

v3

OpenAPI 3.1.0AGPL-3.0-or-later2026-07-311871891.1 MB
Opening Explorer

Player games

Endpoint: https://explorer.lichess.org/player

Games of a Lichess player.

Responds with a stream of newline delimited JSON. Will start indexing on demand, immediately respond with the current results, and stream more updates until indexing is complete. The stream is throttled and deduplicated. Empty lines may be sent to avoid timeouts.

Will index new games at most once per minute, and revisit previously ongoing games at most once every day.

Example: curl https://explorer.lichess.org/player?player=revoof&color=white&play=d2d4,d7d5&recentGames=1

get/player

Query parameters

playerstring required

Username or ID of the player

color'white' | 'black' required

Look for games with player on the given side

variant'standard' | 'chess960' | 'crazyhouse' | 'antichess' | 'atomic' | 'horde' | 'kingOfTheHill' | 'racingKings' | 'threeCheck' | 'fromPosition'
Example:standard

Variant

fenstring

X-FEN of the root position

playstring

Comma separated sequence of legal moves in UCI notation. Play additional moves starting from fen. Required to find an opening name, if fen is not an exact match for a named position.

speedsSpeed[]

Comma separated list of game speeds to look for

modesstring[]

Comma separated list of modes

sincestring

Include only games from this month or later

untilstring

Include only games from this month or earlier

movesinteger

Number of most common moves to display

recentGamesinteger

Number of recent games to display

Response

Opening statistics and game references for the position.