LIlichess
Tablebase

Tablebase lookup for Atomic chess

Endpoint: https://tablebase.lichess.org

get/atomic

Request

  • Base URL
    https://tablebase.lichess.org
  • URL
    https://tablebase.lichess.org/atomic
  • Auth
    none required

Query parameters

fenstring required

X-FEN of the position. Underscores allowed.

Response

The tablebase information for the position in atomic chess.

category'win' | 'unknown' | 'syzygy-win' | 'maybe-win' | 'cursed-win' | 'draw' | 'blessed-loss' | 'maybe-loss' | 'syzygy-loss' | 'loss' required

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 nullable

DTZ50'' with rounding in plies (for Standard chess positions with not more than 7 pieces and variant positions not more than 6 pieces)

precise_dtzinteger nullable

DTZ50'' in plies, only if guaranteed to not be rounded, or absent if unknown

dtcinteger nullable

Depth to Conversion: Moves to next capture, promotion, or checkmate. Available for:

  • Standard chess positions with 8 pieces, more than one pawn of material value for each side, and at least one pair of opposing pawns, short op1, if query parameter dtc is auxiliary or always.
  • Some standard chess positions with up to 7 pieces, if query parameter dtc is always. Work in progress.
dtminteger nullable

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

dtwinteger nullable

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

checkmateboolean
stalemateboolean
variant_winboolean

Only in chess variants

variant_lossboolean

Only in chess variants

insufficient_materialboolean

Changes

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