Tablebase lookup

GET

https://lichess.org/standard

GET

/standard

curl -G https://lichess.org/standard \
     -d fen=fen

200Retrieved

{
  "category": "win",
  "dtz": 1,
  "precise_dtz": 1,
  "dtc": {},
  "dtm": 17,
  "dtw": {},
  "checkmate": false,
  "stalemate": false,
  "variant_win": false,
  "variant_loss": false,
  "insufficient_material": false,
  "moves": [
    {
      "uci": "h7h8q",
      "san": "h8=Q+",
      "category": "loss",
      "dtz": -2,
      "precise_dtz": -2,
      "dtc": {},
      "dtm": -16,
      "dtw": {},
      "zeroing": true,
      "checkmate": false,
      "stalemate": false,
      "variant_win": false,
      "variant_loss": false,
      "insufficient_material": false
    },
    {
      "uci": "h7h8r",
      "san": "h8=R+",
      "category": "loss",
      "dtz": -2,
      "precise_dtz": -2,
      "dtc": {},
      "dtm": -26,
      "dtw": {},
      "zeroing": true,
      "checkmate": false,
      "stalemate": false,
      "variant_win": false,
      "variant_loss": false,
      "insufficient_material": false
    },
    {
      "uci": "g7g8",
      "san": "Kg8",
      "category": "draw",
      "dtz": 0,
      "precise_dtz": 0,
      "dtc": {},
      "dtm": 0,
      "dtw": {},
      "zeroing": false,
      "checkmate": false,
      "stalemate": false,
      "variant_win": false,
      "variant_loss": false,
      "insufficient_material": false
    },
    {
      "uci": "g7f6",
      "san": "Kf6",
      "category": "win",
      "dtz": 1,
      "precise_dtz": 1,
      "dtc": {},
      "dtm": 19,
      "dtw": {},
      "zeroing": false,
      "checkmate": false,
      "stalemate": false,
      "variant_win": false,
      "variant_loss": false,
      "insufficient_material": false
    },
    {
      "uci": "g7g6",
      "san": "Kg6",
      "category": "win",
      "dtz": 1,
      "precise_dtz": 1,
      "dtc": {},
      "dtm": 19,
      "dtw": {},
      "zeroing": false,
      "checkmate": false,
      "stalemate": false,
      "variant_win": false,
      "variant_loss": false,
      "insufficient_material": false
    },
    {
      "uci": "g7h6",
      "san": "Kh6",
      "category": "win",
      "dtz": 1,
      "precise_dtz": 1,
      "dtc": {},
      "dtm": 19,
      "dtw": {},
      "zeroing": false,
      "checkmate": false,
      "stalemate": false,
      "variant_win": false,
      "variant_loss": false,
      "insufficient_material": false
    },
    {
      "uci": "g7h8",
      "san": "Kh8",
      "category": "win",
      "dtz": 1,
      "precise_dtz": 1,
      "dtc": {},
      "dtm": 19,
      "dtw": {},
      "zeroing": false,
      "checkmate": false,
      "stalemate": false,
      "variant_win": false,
      "variant_loss": false,
      "insufficient_material": false
    },
    {
      "uci": "h7h8n",
      "san": "h8=N",
      "category": "win",
      "dtz": 1,
      "precise_dtz": 1,
      "dtc": {},
      "dtm": 19,
      "dtw": {},
      "zeroing": true,
      "checkmate": false,
      "stalemate": false,
      "variant_win": false,
      "variant_loss": false,
      "insufficient_material": false
    },
    {
      "uci": "h7h8b",
      "san": "h8=B",
      "category": "win",
      "dtz": 1,
      "precise_dtz": 1,
      "dtc": {},
      "dtm": 15,
      "dtw": {},
      "zeroing": true,
      "checkmate": false,
      "stalemate": false,
      "variant_win": false,
      "variant_loss": false,
      "insufficient_material": false
    }
  ]
}

Endpoint: <https://tablebase.lichess.ovh> Example: curl http://tablebase.lichess.ovh/standard?fen=4k3/6KP/8/8/8/8/7p/8_w_-_-_0_1

Query parameters

fenstringRequired

FEN of the position. Underscores allowed.

op1enumOptional

When to query the op1 tablebase. The current default is never. It is eventually going to be auxiliary, i.e., only when the position is not covered by one of the other tablebases.

Allowed values:

Response

The tablebase information for the position in standard chess.

categoryenumOptional

cursed-win and blessed-loss means the 50-move rule prevents the decisive result.

syzygy-win and syzygy-loss means exact result is unknown due to DTZ rounding, i.e., the win or loss could also be prevented by the 50-move rule if the user has deviated from the tablebase recommendation since the last pawn move or capture.

maybe-win and maybe-loss means the result with regard to the 50-move rule is unknown, because DTZ is unknown and the DTC tablebase does not guarantee to reach a zeroing move as soon as possible.

dtzinteger or nullOptional

DTZ50” with rounding or null if unknown

precise_dtzinteger or nullOptional

DTZ50” (only if guaranteed to be not rounded) or null if unknown

dtcinteger or nullOptional

Depth to Conversion: Moves to next capture or promotion (available only for Standard op1 positions with 8 pieces, i.e., positions where there is at least one pair of opposing pawns)

dtminteger or nullOptional

Depth To Mate: Plies to mate (available only for Standard positions with not more than 5 pieces)

dtwinteger or nullOptional

Depth To Win: Plies to win (available only for Antichess positions with not more than 4 pieces)

checkmatebooleanOptional

stalematebooleanOptional

variant_winbooleanOptional

Only in chess variants

variant_lossbooleanOptional

Only in chess variants

insufficient_materialbooleanOptional

moveslist of objectsOptional

Information about legal moves, best first