Loterias
Caixa.

Motivação

A Caixa publica os resultados em uma API sem documentação pública nem garantia de estabilidade. O PIRANOT guarda cada concurso uma única vez, serve com chave e SLA, e calcula estatísticas sem repetir a chamada à fonte.

Composição

Modalidades

Mega-Sena, Quina, Lotofácil, Lotomania, Dupla Sena, Timemania, Dia de Sorte, Super Sete, +Milionária, Loteria Federal e Loteca.

Campos do concurso

concurso, data, dezenas (ordem crescente e ordem de sorteio), segundo sorteio, trevos, time do coração/mês de sorte, acumulado, valor acumulado e estimado do próximo, arrecadação, próximo concurso e data, local do sorteio, rateio por faixa, ganhadores por UF/município, coletado_em.

Estatísticas

Frequência de cada dezena, mais e menos sorteadas, concursos seguidos sem ganhador na faixa principal, ganhadores por UF, sobre os concursos já coletados.

Cobertura: Histórico em carga: em 27/10/2026, 300 concursos da Mega-Sena, 157 da Quina e os últimos 50 das demais; a carga histórica continua de madrugada até cobrir todo o histórico de cada modalidade. Cada gráfico e cada resposta dizem quantos concursos foram analisados.

Como é coletado

Fonte oficial

API pública da Caixa Econômica Federal: servicebus2.caixa.gov.br/portaldeloterias/api/{modalidade}/{concurso}.

Método

Coletor próprio (lib/loterias-fetch.ts) identificado no User-Agent como "PIRANOT-DataX/1.0 (+https://www.piranot.com.br/datax/; contato [email protected])". Pede só o que falta: concursos já gravados são pulados (incremental). Gravação atômica de um JSON por concurso e um índice por modalidade.

Cadência

Depois dos sorteios: todos os dias às 21h40, 23h10 e 09h30 (Brasília), pedindo os últimos 3 concursos de cada modalidade. Carga histórica: das 01h às 06h, devagar, retomável.

Orçamento de requisições

No máximo 1 requisição por segundo (4 segundos entre requisições na carga histórica); timeout de 30 s; até 5 tentativas com espera exponencial (2, 4, 8, 16 s) e respeito ao Retry-After em 429 e 5xx. Rotina diária: 11 modalidades × 3 concursos × 3 horários = no máximo 99 requisições/dia. Carga histórica: no máximo 4.500 requisições por noite (5 h a 4 s).

Túnel

Não há: a coleta usa o proxy próprio do PIRANOT no Cloudflare, que repassa a API pública da Caixa no mesmo formato (o mesmo caminho do plugin de loterias do portal), com volume mínimo.

Pré-processamento e limpeza

• Datas convertidas de dd/mm/aaaa para ISO (aaaa-mm-dd); dezenas normalizadas com dois dígitos (Super Sete com um).
• Valores monetários preservados como a Caixa publica (reais, sem arredondar).
• Concurso inexistente (404 na fonte) é registrado como "sem dado", não como erro.

Checks de qualidade aplicados

• Esquema (checarConcurso): número do concurso inteiro ≥ 1, data válida, listas de dezenas e de rateio presentes.
• Faixa: toda dezena dentro do universo da modalidade (ex.: Mega-Sena 1–60, Lotofácil 1–25, Lotomania 0–99); sem dezena repetida (exceto Super Sete, que sorteia um dígito por coluna); quantidade de dezenas igual à da modalidade (Mega 6, Quina 5, Lotofácil 15, Lotomania 20, Dupla Sena 6, Timemania 7, Dia de Sorte 7, Super Sete 7, +Milionária 6).
• Continuidade: data do sorteio não pode ser futura (tolerância de 1 dia) nem anterior à do concurso imediatamente anterior.
• Totais: ganhadores por UF não podem exceder o total de ganhadores do rateio.
• Verificação antes de publicar: o concurso passa pelos checks antes de ir ao ar; qualquer falha o retém e a API continua servindo a última versão boa. Estatísticas recalculadas só quando entra concurso aprovado. Toda resposta informa o resumo qualidade.
• Segunda fonte: no recheque, o concurso é conferido também contra o banco do site do PIRANOT (que coleta a Caixa por caminho próprio).
• Status público: atraso acima de 30 h após a última coleta marca o dataset como "atrasado" em /status e /status.json. Recheque noturno por amostra: todo dia às 02h, 5 registros por dataset pedidos de novo à fonte oficial (orçamento de até 15 requisições ao BCB e 50 à Caixa por noite, com pelo menos 5 s entre elas); divergência vira correção com errata.

Licença e usos

Licença

Dado público divulgado pela Caixa Econômica Federal; processamento PIRANOT. A Caixa não publica termos de licença da API.

Usos

Aplicativos e sites de resultado, estatísticas educativas, alertas. Não serve para prever sorteios: frequência passada não altera a probabilidade.

Limitações conhecidas

• Histórico parcial enquanto a carga noturna não termina (o número de concursos analisados aparece em toda estatística).
• Loteria Federal e Loteca não sorteiam dezenas: sem frequência nem acumulado por dezena.
• Rateio e ganhadores por UF são os da Caixa no momento da coleta; a Caixa pode retificar depois.
• Dependência de API não documentada: mudança de formato na fonte interrompe a coleta até ajuste do parser (o dado já gravado continua servido).

Distribuição

Metadados (DCAT / schema.org Dataset)

dct:identifier

loterias-caixa

dct:publisher

PIRANOT

dct:source

Caixa Econômica Federal

dct:license

dado público; processamento PIRANOT

dct:temporal

do primeiro concurso coletado ao último

dct:spatial

Brasil

dct:accrualPeriodicity

após cada sorteio (3 coletas/dia)

dcat:distribution

JSON via API v1

Histórico de versões

Reportar erro

POST /api/v1/qualidade/reportar com dataset, chave_registro, valor_visto, valor_esperado e fonte_esperada (detalhes em /docs/qualidade). Correções confirmadas aparecem em /erratas. Sem chave, escreva para [email protected].

Aviso. O DataX PIRANOT organiza dados de fontes oficiais e pode conter erros ou atrasos. Confira na fonte oficial, indicada em cada dado, antes de qualquer decisão importante. Respostas geradas por IA podem errar.DataX PIRANOT organises data from official sources and may contain errors or delays. Check the official source, linked with each dataset, before any important decision. AI-generated answers can be wrong.