Docs · Datasheet
Indicadores
e câmbio (Selic, IPCA, dólar PTAX).
Séries do Banco Central: meta Selic (diária), IPCA mensal e dólar PTAX de venda (dias úteis), com metadados da fonte e leitura descritiva.
Motivação
Três séries que a redação, as IAs e os profissionais pedem todo dia. O DataX guarda a série, marca a data de referência e a de coleta, e serve com a origem.
Composição
- Séries
- Selic meta (SGS 432, % a.a., diária), IPCA (SGS 433, % no mês, mensal) e PTAX venda USD (SGS 1, R$ por US$ 1, dias úteis).
- Campos
- id, title, unit, points[] (date, value), source (id, name, provider, url, frequency, fetchedAt, referencePeriod, status, notes) e reading (leitura baseada em regras, sem projeção).
Cobertura: Selic: 366 observações (1 ano); PTAX: 251 observações (1 ano de dias úteis); IPCA: 12 observações. Última referência: 27/10/2026 (Selic e PTAX) e setembro/2026 (IPCA).
Como é coletado
- Fonte oficial
- Banco Central do Brasil, Sistema Gerenciador de Séries Temporais (api.bcb.gov.br/dados/serie/bcdata.sgs.{código}/dados).
- Método
- Requisição HTTPS só para api.bcb.gov.br (qualquer outro host é rejeitado), timeout de 25 s, deduplicação de chamadas simultâneas, cache em arquivo com "último bom" por série.
- Cadência
- Rotina diária às 06h10 (Brasília). Série que não muda no dia (IPCA) mantém o corte anterior com status "fresh" enquanto a competência for a corrente.
- Orçamento de requisições
- 3 requisições ao BCB por dia (uma por série).
- Túnel
- Não há.
Pré-processamento e limpeza
- Datas em dd/mm/aaaa convertidas para ISO; valores decimais com vírgula convertidos com parseDecimal; observações com data futura são rejeitadas.
- Nenhum dia sem publicação é interpolado: a linha do gráfico liga só observações publicadas.
Checks de qualidade aplicados
- Esquema (checarSerie): série não vazia, datas válidas, valores numéricos; ponto inválido é descartado e contado.
- Faixa: Selic entre 0 e 50 % a.a.; dólar PTAX entre 0,5 e 20 BRL/USD; IPCA entre −2 e 5 % a.m.
- Continuidade: sem buraco entre observações consecutivas (mês a mês no IPCA).
- Salto: valor novo com z-score acima de 4 contra o histórico da série fica retido para conferência.
- Verificação antes de publicar: os dados passam pelos checks antes de ir ao ar; se algum falhar, o último corte bom continua no ar com status "stale"; nunca zero no lugar de dado ausente.
- Status público: atraso acima de 36 h 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
- Open Database License (ODbL 1.0), como no Portal de Dados Abertos do BCB. A base derivada do DataX também é ODbL: atribuição "Fonte: Banco Central do Brasil (SGS), processamento PIRANOT" e mesma licença ao redistribuir; cópia aberta, sem chave, em /datax/api/indicadores/{selic,ipca,dolar} (JSON ou ?format=csv).
- Usos
- Número do dia, gráficos com faixa mínima/máxima e marcos, correção monetária, ferramentas de renda. A PTAX é a taxa de referência do BCB, não cotação de balcão.
Limitações conhecidas
- PTAX só em dias úteis; Selic meta muda só nas reuniões do Copom (a série mostra degraus).
- IPCA do BCB pode ficar um ciclo atrás do IBGE no dia da divulgação.
- Janela de 1 ano no corte atual.
Distribuição
| Endpoint | Descrição |
|---|---|
GET /api/v1/indicadores | As três séries com metadados. |
GET /api/indicadores/{id}?format=csv | CSV por série (selic, ipca, dolar). |
Metadados (DCAT / schema.org Dataset)
- dct:identifier
- indicadores-cambio
- dct:publisher
- PIRANOT
- dct:source
- Banco Central do Brasil (SGS)
- dct:license
- ODbL 1.0
- dct:temporal
- últimos 12 meses
- dct:spatial
- Brasil
- dct:accrualPeriodicity
- diária
- dcat:distribution
- JSON e CSV via API
Histórico de versões
| Versão | Mudança |
|---|---|
| 1.0 (20/10/2026) | Selic, IPCA e PTAX com metadados e leitura descritiva. |
| 1.1 (27/10/2026) | Faixa mín/máx, marcos de Copom e eleição nos gráficos; número do dia na home. |
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.