Sistema Gerenciador de Séries Temporais — SGS (BCData)

Nível 2 — Ingestão com engenharia

Prontidão para IA

Forma de acesso

API REST JSON/CSV: api.bcb.gov.br/dados/serie/bcdata.sgs.{código}/dados?formato=json; interface SOAP/WSDL também publicada.

Autenticação

Nenhuma

Licença / termo†

ODbL — Open Data Commons Open Database License, declarada na página oficial do conjunto (verificada em 27/08/2026). Atenção às obrigações da ODbL: atribuição e compartilhamento de bases derivadas pela mesma licença.

Granularidade

Série temporal; varia por série (SGS 11 — Selic: diária). Chave principal: código SGS + data.

Cadência†

Por série; contínua — o teste funcional retornou valor de D-1.

Restrição legal

Nenhuma identificada; aplicam-se os termos da ODbL.

Limite técnico†

Desde 26/03/2025, filtros de data obrigatórios e janela máxima de 10 anos por requisição em JSON/CSV de séries diárias (erro acima disso); "ultimos/{N}" limitado a 20 valores. Código anterior a 26/03/2025 que puxe séries diárias extensas numa chamada falha hoje.

† Campo volátil: muda sem aviso e sem quebrar o link. Nenhum verificador de URL detecta. Confira na fonte oficial antes de depender dele.

O que esta fonte permite fazer

Fonte de baixo custo para contexto econômico-financeiro temporal. Em vez de replicar tabelas, guarda-se o código SGS e recupera-se apenas o intervalo necessário.

Cuidados para uso por IA

"Selic" não é chave semântica suficiente — existem séries distintas relacionadas, com unidades e conceitos diferentes. O pipeline trabalha com código SGS explícito e metadados da série, e fraciona automaticamente consultas históricas acima da janela permitida.

Perguntas que esta base responde

• Valor de uma série em uma data? — Alta
• Evolução de uma variável num período? — Alta
• Contexto macroeconômico para análise administrativa/fiscal? — Alta
• Comparar duas séries no tempo? — Alta, após harmonizar periodicidade e unidade
• Baixar décadas de dados diários numa chamada? — Não — vigora o limite documentado

Apontadores

Verificação — 27/08/2026

Teste funcional real — GET na série 11 retornou JSON válido com último dado de 26/08/2026; página oficial do conjunto aberta e conferida: licença ODbL, regra dos 10 anos, início da série em 04/06/1986 e recursos JSON/CSV/WSDL confirmados.