v3

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

Masters database

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

Example: curl https://explorer.lichess.org/masters?play=d2d4,d7d5,c2c4,c7c6,c4d5

get/masters

Query parameters

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.

sinceinteger

Include only games from this year or later

untilinteger

Include only games from this year or earlier

movesinteger

Number of most common moves to display

topGamesinteger

Number of top games to display

Response

Opening statistics and game references for the position.

whiteinteger required
drawsinteger required
blackinteger required