Sign in

v3

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

Lichess games

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

Aggregated rated games from all Lichess players.

Example: curl https://explorer.lichess.org/lichess?variant=standard&speeds=blitz,rapid,classical&ratings=2200,2500&fen=rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR%20w%20KQkq%20-%200%201

get/lichess

Query parameters

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

Variant

fenstring

X-FEN or EPD 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 filter by

ratingsinteger[]

Comma separated list of ratings groups to filter by. Each group ranges from its value to the next higher group in the enum (0 from 0 to 999, 1000 from 1000 to 1199, ..., 2500 from 2500 to any rating above).

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

topGamesinteger

Maximum number of top games to display.

Due to the way banned users are handled internally, the response may contain fewer games than expected.

recentGamesinteger

Maximum number of recent games to display.

Due to the way banned users are handled internally, the response may contain fewer games than expected.

historyboolean

Optionally retrieve history

Response

Opening statistics and game references for the position.

whiteinteger required
drawsinteger required
blackinteger required