---
title: "Tablebase lookup for Atomic chess"
method: GET
path: "/atomic"
tags: ["Tablebase"]
---

# Tablebase lookup for Atomic chess

`GET /atomic`

**Endpoint: <https://tablebase.lichess.org>**

## Query parameters

- `fen` string, required

## Response `200`

The tablebase information for the position in atomic chess.

- TablebaseJson
  - `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](https://syzygy-tables.info/metrics#dtz), 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.
  - `dtz` integer, nullable — [DTZ50'' with rounding](https://syzygy-tables.info/metrics#dtz) in plies (for Standard chess positions with not more than 7 pieces and variant positions not more than 6 pieces)
  - `precise_dtz` integer, nullable — DTZ50'' in plies, only if guaranteed to not be rounded, or absent if unknown
  - `dtc` integer, 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.
  - `dtm` integer, nullable — Depth To Mate: Plies to mate (available only for Standard positions with not more than 6 pieces)
  - `dtw` integer, nullable — Depth To Win: Plies to win (available only for Antichess positions with not more than 4 pieces)
  - `checkmate` boolean
  - `stalemate` boolean
  - `variant_win` boolean — Only in chess variants
  - `variant_loss` boolean — Only in chess variants
  - `insufficient_material` boolean
  - `moves` TablebaseMove[], required — Information about legal moves, best first
    - `uci` string, required
    - `san` string, required
    - `category` 'loss' | 'unknown' | 'syzygy-loss' | 'maybe-loss' | 'blessed-loss' | 'draw' | 'cursed-win' | 'maybe-win' | 'syzygy-win' | 'win', required
    - `dtz` integer, nullable
    - `precise_dtz` integer, nullable
    - `dtc` integer, nullable
    - `dtm` integer, nullable
    - `dtw` integer, nullable
    - `zeroing` boolean
    - `conversion` boolean
    - `checkmate` boolean
    - `stalemate` boolean
    - `variant_win` boolean
    - `variant_loss` boolean
    - `insufficient_material` boolean

---

[API](https://skmtc.net/lichess/apis/lichess-org-api-reference.md) · [All operations](https://skmtc.net/lichess/apis/lichess-org-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lichess/lichess-org-api-reference/versions/1425db81eb3b/schema)