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

Request

  • Base URL
    https://explorer.lichess.org
  • URL
    https://explorer.lichess.org/masters
  • Auth
    OAuth 2
    Authorization code: https://lichess.org/oauth
    Token URL: https://lichess.org/api/token

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

Changes

No recorded changes to this operation across all 16 revisions of this API.