name: spire-codex-api description: Look up Slay the Spire 2 game data and community stats through the Spire Codex REST API. metadata: version: "1.0.1"

Spire Codex API

Spire Codex serves Slay the Spire 2 game data (cards, relics, potions, monsters, events, powers) and community run statistics over a public REST API.

Usage

• Base URL: https://spire-codex.com/api
• OpenAPI schema: https://spire-codex.com/openapi.json
• Docs: https://spire-codex.com/developers
• No key needed to browse. Send an X-API-Key header for higher rate limits (see /auth.md).

Common calls

• GET /api/cards?lang=eng - every card; also /api/relics, /api/potions, /api/monsters, /api/events, /api/powers
• GET /api/cards/{id} - one entity by id
• GET /api/runs/scores/{cards|relics|potions} - Codex Scores and Elo per entity
• GET /api/runs/metrics/{cards|relics|potions}?bracket=a10 - win/pick rates by bracket
• GET /api/runs/community-stats - event decisions, deadliest encounters, records
• GET /api/search?q=: search every entity, reference entry, mechanics page and guide at once
• GET /api/exports/runs: bulk run export as gzipped JSONL (/api/exports/runs/manifest for the daily dump)
• 15 languages via ?lang= (eng, deu, jpn, zhs, zht, ...)