Chessigma Rust client
A typed client for the free Chessigma public API. Fetch the daily chess puzzle, calculate Elo changes, submit PGN games and retrieve completed analysis.
No API key or signup is needed. The API has a global limit of 30 requests/minute across callers. Clients make one request per method call and do not retry automatically. Respect Retry-After when present.
Game submission does not run the chess engine. Open the returned game URL in a browser and trigger analysis there. get_game / GetGame returns 404 while analysis is unavailable. Only public-API-submitted games are readable.
Puzzle solutions use UCI notation; the first move sets up the puzzle, and the following moves are the solution. A dated puzzle must be a past YYYY-MM-DD; future dates are rejected by the API.
Install
Use
use ;
submit_game(pgn) returns game_id and url; get_game(game_id) retrieves completed analysis. Analysis.extra retains analysis statistics beyond the documented schema, and Game.extra retains additional game metadata.
This is a synchronous client with a default 30-second timeout. In an async app, use a blocking worker. Client::with_http_client accepts a configured reqwest::blocking::Client for custom timeouts and proxies; Client::with_base_url supports local servers.
match client.daily_puzzle
Development
Protocol tests use local HTTP servers; tests and examples do not run live game submissions.
Chessigma · API documentation · OpenAPI schema · Report a bug
The original client code is MIT licensed. Use of the hosted API is subject to Chessigma's terms. The license does not cover the hosted service or third-party puzzle data.