Slay the Spire 2 (STS2) Desenvolvedores

Crie ferramentas, bots e conteúdo com os dados do Spire Codex. Tudo é gratuito e aberto.

Widget de tooltip

Adicione tooltips ao passar o mouse no estilo Wowhead para cartas, relíquias e poções em qualquer site. Uma tag script, zero dependências.

Instalação

<script src="https://spire-codex.com/widget/spire-codex-tooltip.js"></script>

Sintaxe

[[Strike]]Tooltip de carta (tipo padrão)

[[card:Bash]]Carta (explícito)

[[relic:Burning Blood]]Relíquia

[[potion:Fire Potion]]Poção

[[character:Ironclad]]Personagem

[[monster:Jaw Worm]]Monstro

[[power:Strength]]Poder

[[event:Neow]]Evento

[[encounter:Lagavulin]]Encontro

[[enchantment:Sharp]]Encantamento

[[keyword:Exhaust]]Palavra-chave

[[orb:Lightning]]Orbe

[[affliction:Bound]]Aflição

[[achievement:Minimalist]]Conquista

API JavaScript

SpireCodex.scan()Verifica a página novamente em busca de novos padrões [[...]] (para SPAs)

SpireCodex.scan(element)Verifica um elemento DOM específico

Widget de changelog

Incorpore um visualizador de changelog compacto e interativo mostrando o histórico de atualizações do Spire Codex com troca de versão.

Instalação

<div id="scx-changelog"></div>
<script src="https://spire-codex.com/widget/spire-codex-changelog.js"></script>

data-version="1.0.4"Mostra uma versão específica (padrão: mais recente)

API REST

Banco de dados completo do jogo acessível por uma API REST pública. Sem autenticação: a cota do site por IP cobre navegação e chamadas casuais, e o uso da API sem chave recebe a taxa base abaixo. Para scripts e ferramentas, crie uma chave de API e envie-a no cabeçalho X-API-Key. Uma chave agrupa suas requisições por identidade em vez de IP (estável entre redes, nunca compartilhada com outros usuários atrás do mesmo NAT) e oferece acompanhamento de uso; o limite do nível se aplica por endpoint. As respostas trazem X-RateLimit-Remaining / X-RateLimit-Reset para você dosar as requisições.

Limites de requisições

Tráfego do site	300/minute	por IP
Sem chave de API	15/minute
Usuário registrado	60/minute	crie uma no seu perfil
Acadêmico	100/minute	concedido sob solicitação
Pago	120/minute	apoiadores

Todos os limites contam por endpoint: a tabela é a sua cota em cada rota, não um pool global. Alguns endpoints pesados têm orçamentos próprios que valem para todo chamador, com ou sem chave (veja a exportação de partidas abaixo; o ZIP de idioma é 10/hora). Observe X-RateLimit-Remaining e recue ao receber 429 (Retry-After é definido).

Exportação em massa de partidas

Sprite de carta em miniatura

Reproduza a miniatura de carta do jogo (usada nas telas de Histórico de partidas / Fim de jogo) em qualquer projeto web. Seis camadas PNG compostas com mask-image do CSS, sem canvas, sem WebGL, só sprites coloridos. As cores vêm direto do código descompilado do jogo: NTinyCard, CardPoolModel.DeckEntryCardColor.

Prévia

Ironclad / Attack / Common

Exportações de dados

Baixe todos os dados do jogo em um único arquivo ZIP. Cada arquivo contém JSONs para cada tipo de entidade (cartas, relíquias, monstros, poderes e mais).

Baixar dados em inglês (ZIP)

15 idiomas disponíveis. Exemplos de download: Japonês, Coreano, Chinês, Francês, Alemão

Documentação interativa da API

Documentação completa Swagger/OpenAPI com função de teste.

Abrir documentação da API →

Código aberto

O Spire Codex é de código aberto. O pipeline de extração de dados, a API e o frontend estão todos disponíveis no GitHub.

Ver no GitHub →

GET /api/runs/export?limit=1000&start=2026-06-01T00:00:00Z

Transmite as partidas oficiais como JSONL, uma partida por linha.

limit Limita a página; uma página cheia retorna um cursor para a próxima.

start / end Restringem a uma janela semiaberta de data de envio. Mantenha-os constantes ao paginar; o cursor não os inclui.

Este endpoint tem orçamento próprio de 120 créditos por hora, compartilhado por chamadores com e sem chave: uma requisição paginada custa 1 crédito, uma busca sem limite custa 60. Sincronização contínua funciona melhor com buscas paginadas espaçadas ~30 s; em 429, respeite o Retry-After e retome com o mesmo cursor.

URL base

https://spire-codex.com

Canal beta (conteúdo não lançado do ramo beta da Steam): adicione isto a qualquer endpoint de entidade: ?channel=beta. Versão beta atual: /api/beta/version. Diferença completa em relação ao main: /api/beta/diff.

Endpoints

Documentação interativa completa (gerada automaticamente do backend, sempre atual): /docs

Entidades

GET/api/cardsTodas as cartas (filtros: color, type, rarity, keyword, tag, spawns, search)

GET/api/cards/{id}Uma carta

GET/api/charactersTodos os personagens

GET/api/characters/{id}Um personagem

GET/api/relicsTodas as relíquias (filtros: rarity, pool, ancient, search)

GET/api/relics/{id}Uma relíquia

GET/api/potionsTodas as poções (filtros: rarity, pool, search)

GET/api/potions/{id}Uma poção

GET/api/monstersTodos os monstros (filtros: type, search)

GET/api/monsters/{id}Um monstro

GET/api/powersTodos os poderes (filtros: type, stack_type, search)

GET/api/powers/{id}Um poder

GET/api/eventsTodos os eventos (filtros: type, act, search)

GET/api/events/{id}Um evento

GET/api/encountersTodos os encontros (filtros: room_type, act, search)

GET/api/encounters/{id}Um encontro

GET/api/enchantmentsTodos os encantamentos

GET/api/enchantments/{id}Um encantamento

GET/api/keywordsPalavras-chave de cartas

GET/api/keywords/{id}Uma palavra-chave

GET/api/intentsTodos os tipos de intenção

GET/api/intents/{id}Uma intenção

GET/api/orbsTodos os tipos de orbe

GET/api/orbs/{id}Um orbe

GET/api/afflictionsTipos de aflição

GET/api/afflictions/{id}Uma aflição

GET/api/modifiersModificadores do modo personalizado

GET/api/modifiers/{id}Um modificador

GET/api/achievementsTodas as conquistas

GET/api/achievements/{id}Uma conquista

GET/api/badgesTodos os emblemas

GET/api/badges/{id}Um emblema

GET/api/epochsTodas as épocas

GET/api/epochs/{id}Uma época

GET/api/storiesTodas as histórias

GET/api/stories/{id}Uma história

GET/api/actsTodos os atos

GET/api/acts/{id}Um ato

GET/api/ascensionsTodos os níveis de ascensão

GET/api/ascensions/{id}Uma ascensão

GET/api/glossaryTodos os termos do glossário

GET/api/glossary/{id}Um termo

Agregações e consultas

GET/api/statsContagem de entidades

GET/api/ancient-poolsTodos os conjuntos de relíquias dos ancestrais com condições

GET/api/ancient-pools/{id}Conjuntos de um ancestral

GET/api/unlocksEntidades desbloqueáveis agrupadas por tipo com contexto de época

GET/api/history/{entity_type}/{entity_id}Histórico de versões por entidade a partir dos changelogs

GET/api/update-history/{entity_type}/{entity_id}Histórico de atualizações por patch do jogo para cada entidade

GET/api/names/{entity_type}/{entity_id}Consulta do nome de uma entidade em todos os idiomas

GET/api/searchBusca unificada do site em entidades, entradas de referência, mecânicas, guias e notícias (q, lang)

GET/api/changelogs

Comunidade e envios

GET/api/guidesTodos os guias (filtros: category, difficulty, tag, search)

GET/api/guides/{slug}Um guia com o markdown renderizado

POST/api/guidesEnviar um guia (webhook do Discord, com limite de requisições)

POST/api/runsEnviar uma partida para as estatísticas da comunidade e os rankings

POST/api/runs/claimAssociar um nome de usuário a partidas já enviadas pelo hash

GET/api/runs/listNavegar pelas partidas enviadas com filtros e paginação (incl. ascension_min/ascension_max e winrate_min/winrate_max pela taxa de vitória do remetente, as faixas de conteúdo)

GET/api/runs/leaderboardRankings de partidas (fastest, highest_ascension); filtrar por character, players, game_mode, ascension_min, winrate_min (as faixas de conteúdo)

GET/api/runs/shared/{run_hash}Uma partida enviada pelo hash (com limite de requisições)

GET

Downloads em massa

GET/api/runs/exportStream JSONL de partidas oficiais (paginação limit/start/end/cursor; orçamento próprio de 120 créditos por hora, veja Exportação em massa acima)

GET/api/exports/{lang}ZIP com todo o JSON de entidades de um idioma (10/hora)

GET/api/imagesCategorias da galeria de imagens

GET/api/images/searchBuscar imagens por nome de arquivo

GET/api/images/game/{version}/{category}/browseNavegação paginada pelas pastas de um dump completo de assets (path, offset, limit)

GET/api/images/game/{version}/{category}/downloadZIP com os arquivos de uma pasta do dump (path; limitado a 2000 arquivos)

Vários idiomas

Adicione este parâmetro de consulta a qualquer endpoint: ?lang=jpn. 15 idiomas suportados:

eng, deu, esp, fra, ita, jpn, kor, pol, ptb, rus, spa, tha, tur, zhs, zht

Início rápido

cURL

curl https://spire-codex.com/api/cards?color=ironclad&rarity=Rare

Python

import requests
cards = requests.get("https://spire-codex.com/api/cards", params={"color": "ironclad"}).json()
for card in cards:
    print(f"{card['name']} - {card['type']} ({card['rarity']})")

JavaScript

const res = await fetch("https://spire-codex.com/api/relics?pool=ironclad");
const relics = await res.json();
console.log(relics.map(r => r.name));

Silent / Skill / Uncommon

Defect / Power / Rare

Necrobinder / Skill / Rare

Regent / Attack / Uncommon

Recursos de sprite

Todos os 10 PNGs são servidos com CORS habilitado, basta colocar a URL base antes de cada nome de arquivo. Cada sprite tem 128×128, RGBA, branco sobre transparente (feito para ser colorido via CSS).

https://spire-codex.com/static/images/ui/run_history_card/
  card_back.png           ← tinted by pool
  desc_box.png            ← dark description area (render at 25% opacity)
  attack_portrait.png     ← portrait per card type
  attack_portrait_shadow.png
  skill_portrait.png
  skill_portrait_shadow.png
  power_portrait.png
  power_portrait_shadow.png
  banner_shadow.png       ← render at 60% opacity
  banner.png              ← tinted by rarity

Cores do conjunto (verso da carta)

Fonte: CardPoolModel.DeckEntryCardColor. Compare com o campo color retornado por /api/cards.

ironclad#D62000

silent#5EBD00

defect#3EB3ED

necrobinder#CD4EED

regent#E36600

colorless#A3A3A3

event#A3A3A3

curse#585B61

quest#24476A

status#FFFFFF

token#FFFFFF

Cores de raridade (faixa)

Fonte: NTinyCard.GetBannerColor. Compare com o campo rarity.

Basic#9C9C9C

Starter#9C9C9C

Common#9C9C9C

Uncommon#64FFFF

Rare#FFDA36

Curse#E669FF

Event#13BE1A

Ancient#13BE1A

Quest#F46836

Status#9C9C9C

Token#9C9C9C

Receita mínima de HTML + CSS

Nome do arquivo do retrato: attack = Cartas de Ataque, power = Cartas de Poder, skill = todo o resto (Habilidade, Status, Maldição, …)

<div class="tiny-card" style="
  --back: #D62000;   /* pool color, Ironclad */
  --banner: #FFDA36; /* rarity color, Rare */
  position: relative;
  width: 64px;
  height: 64px;
">
  <!-- 1. card back, tinted by pool -->
  <div class="layer" style="
    background-color: var(--back);
    mask: url(https://spire-codex.com/static/images/ui/run_history_card/card_back.png) center/contain no-repeat;
    -webkit-mask: url(https://spire-codex.com/static/images/ui/run_history_card/card_back.png) center/contain no-repeat;
  "></div>

  <!-- 2. description box -->
  <img class="layer" src="https://spire-codex.com/static/images/ui/run_history_card/desc_box.png" style="opacity:.25">

  <!-- 3. portrait shadow + portrait (attack/skill/power) -->
  <img class="layer" src="https://spire-codex.com/static/images/ui/run_history_card/attack_portrait_shadow.png">
  <img class="layer" src="https://spire-codex.com/static/images/ui/run_history_card/attack_portrait.png"
       style="filter: brightness(.95) sepia(.15)">

  <!-- 4. banner shadow + banner tinted by rarity -->
  <img class="layer" src="https://spire-codex.com/static/images/ui/run_history_card/banner_shadow.png" style="opacity:.6">
  <div class="layer" style="
    background-color: var(--banner);
    mask: url(https://spire-codex.com/static/images/ui/run_history_card/banner.png) center/contain no-repeat;
    -webkit-mask: url(https://spire-codex.com/static/images/ui/run_history_card/banner.png) center/contain no-repeat;
  "></div>
</div>

<style>
  .tiny-card .layer {
    position: absolute; inset: 0;
    width: 100%; height: 100%;
    object-fit: contain;
  }
</style>

Componente React

Versão React pronta para uso. Fonte: TinyCard.tsx

import TinyCard from "./TinyCard";

// Feed in the three fields from /api/cards:
<TinyCard color="ironclad" type="Attack" rarity="Rare" className="w-16 h-16" />

Imagens completas de cartas

Cada carta de /api/cards inclui duas URLs prontas para uso da carta completa renderizada pelo jogo (moldura, arte, faixa e texto, exatamente como no jogo). Cartas dos ancestrais são webps animados.

image_url_card — A carta base. null para a única carta sem render (mad_science); use image_url (a arte do retrato) como alternativa nesse caso.
image_url_card_upg — A carta aprimorada. null quando a carta não tem aprimoramento.

// e.g. /api/cards/bash
{
  "id": "BASH",
  "image_url":          "/static/images/cards/bash.webp",  // portrait art
  "image_url_card":     "https://cdn.spire-codex.com/cards-full/stable/bash.webp",
  "image_url_card_upg": "https://cdn.spire-codex.com/cards-full/stable/bash_upg.webp"
}

Renders localizados ficam em uma subpasta de idioma, por exemplo: cards-full/stable/jpn/bash.webp. Todos os 15 idiomas estão disponíveis.

Renders de cartas encantadas

Cada carta também é renderizada com cada encantamento que pode receber legalmente, exatamente como a prévia de encantamento do jogo a desenha (emblema, valor e texto adicionado). As URLs seguem um único padrão:

https://cdn.spire-codex.com/cards-full/stable/ench/{enchantment}/{card}.webp        // English, base
https://cdn.spire-codex.com/cards-full/stable/ench/{enchantment}/{card}_upg.webp    // English, upgraded
https://cdn.spire-codex.com/cards-full/stable/{lang}/ench/{enchantment}/{card}.webp // localized

// e.g. Anger with Corrupted, in Japanese:
https://cdn.spire-codex.com/cards-full/stable/jpn/ench/corrupted/anger.webp

{enchantment} / {card}: ids em minúsculas de /api/enchantments e /api/cards (ex.: sharp, corrupted, sown).
Só existem combinações válidas de carta e encantamento (a exportação usa as regras de aplicabilidade do próprio jogo), então uma combinação inválida retorna 404. Os campos card_type / applicable_to em /api/enchantments descrevem quais cartas se qualificam.
Existem variantes base e aprimorada para cada combinação, em todos os 14 idiomas, com o texto do encantamento totalmente localizado.

GET/api/changelogs/recent-additionsEntidades mais recentes exibidas na faixa da página inicial

GET/api/changelogs/{tag}Um changelog por tag (ex.: v1.0.20)

GET/api/newsAnúncios da Steam (espelhados localmente para permanência)

GET/api/news/{gid}Uma notícia com o corpo sanitizado

GET/api/versionsVersões de dados beta disponíveis para o seletor de versão

Estatísticas agregadas da comunidade (filtrar por character, ascension, username)

GET/api/runs/community-statsConjuntos de dados divertidos da comunidade: decisões em eventos, encontros mais letais, taxas de vitória por ascensão/personagem, recordes

GET/api/charts/metaRegistro de gráficos para o explorador /charts: gráficos disponíveis, filtros, divisões e estatísticas de partidas

GET/api/charts/{chart}Um gráfico pré-agregado (filtros: players, ascension, game_mode, username, split, bracket=a10|wr30|wr50|wr75 nos gráficos de frame, mais parâmetros por gráfico)

GET/api/beta/diffO que a beta atual adiciona, altera e remove por tipo de entidade; alimenta cada rótulo BETA

GET/api/beta/versionA versão beta atual

GET/api/runs/scores/{type}Codex Score + Codex Elo por entidade (cards/relics/potions); ?bracket=a10|wr30|wr50|wr75 classifica dentro de uma faixa de conteúdo (o mod do jogo envia o mesmo via ?stat_filter=a10|a10_wr30|a10_wr50|a10_wr75); relíquias aceitam ?act=1|2|3 para ranquear por ato de obtenção; ?character= muda para o recorte desse personagem (as entradas ganham um campo scope)

GET/api/runs/leaderboard/seed-rankSemente + posição global para uma semente (?seed=&steam_id=); os campos de rank são null sem uma partida vencida

POST/api/auth/steam/ticketTrocar um ticket de autenticação web da Steamworks pelo JWT do site (login silencioso no jogo); 503 até o servidor ter uma chave Steam

GET/api/runs/metrics/{type}Tabela densa de métricas: Codex Score, Codex Elo, taxa de vitória, taxa de escolha, divisões por ato; ?bracket=all|solo|2p|3p|4p|a10|daily|custom|wr30|wr50|wr75 (as faixas de conteúdo)

GET/api/runs/versionsIDs de build do jogo distintos com partidas enviadas

POST/api/feedbackEnviar feedback (webhook do Discord)