Get a random chess puzzle. Filter by variant, difficulty or theme. Not every variant puzzle carries themes; use chess_list_puzzle_types to see what the pool holds.

Chess variant play slug (e.g. almost-chess, benedict, fischer-random, king-of-the-hill, standard); a manifest key such as chess960 is also accepted. Returns only puzzles for this variant.

Puzzle difficulty by rating: easy under 1200, medium 1200-1799, hard 1800 and above

Puzzle theme (fork, pin, skewer, mateIn2, etc). Not every variant puzzle carries themes.