CR Clash Royale API Agent Reference

Rather than a thin endpoint list, this reference is written for LLM agents, coding agents, and API clients that need to know how the API really behaves: endpoint-by-endpoint notes on parameters, pagination, caching, and errors; field-level models drawn from live responses; endpoints that are broken, disabled, or removed; and the game modes beyond Trophy Road, so an agent does not treat one ladder as the whole game. Machine-readable files cover the mode taxonomy, card roles, and deck names.

It began inside Elixir Bot as cr-api-docs; in March 2026 Codex used it to suggest a feature tracking ladder and Path of Legend momentum. It then became a standalone public repository. Copies kept inside other projects drifted, so they were removed, and Elixir and Elixir Drop now treat this one repository as their Clash Royale API truth.

Its agent guide asks any agent the live API surprises to write the finding down here, after checking the claim with a live probe tool. Observed enum values are guarded by the docs build, so a later rewrite cannot quietly drop them. It is an unofficial fan reference under Supercell’s Fan Content Policy.