bcb_serie_metadados
Retrieve descriptive metadata (name, unit, frequency, source, category) for a Brazilian Central Bank time series to verify its meaning and unit before fetching values.
Instructions
Obtém os metadados descritivos de UMA série do BCB (nome, unidade de medida, periodicidade, fonte, categoria), sem trazer a série de valores. Quando usar: para confirmar o que uma série representa e em que unidade antes de consultar os dados. Quando NÃO usar: para os valores em si use bcb_serie_valores ou bcb_serie_ultimos. Retorna: codigo, nome, unidade, periodicidade, fonte, categoria, especial e URLs diretas da API (urlConsulta, urlUltimos10). Se o endpoint de metadados do BCB não responder, faz fallback para o catálogo interno ou para o último valor disponível, sinalizando a origem em observacao. Comportamento: consome a API pública SGS do Banco Central do Brasil — sem autenticação, chave de API ou cadastro, e sem limite de requisições divulgado (uso é best-effort). Em falha transitória ou timeout a chamada é repetida automaticamente (até 3 tentativas, backoff exponencial); persistindo o erro, retorna isError: true com mensagem em português (HTTP 404 = série inexistente ou sem dados no período solicitado). O resultado vem como JSON tanto em texto quanto em structuredContent (conforme o outputSchema); datas no formato dd/MM/yyyy e valores numéricos (ponto decimal).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| codigo | Yes | Código da série no SGS/BCB |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| codigo | Yes | Código da série no SGS/BCB | |
| nome | Yes | Nome da série | |
| unidade | No | Unidade de medida | |
| periodicidade | No | Periodicidade da série | |
| fonte | Yes | Fonte dos dados | |
| categoria | No | Categoria econômica | |
| especial | No | Indica se é uma série especial | |
| ultimoValor | No | Última observação disponível (fallback) | |
| urlConsulta | No | URL da API do BCB para consulta completa | |
| urlUltimos10 | No | URL da API do BCB para os últimos 10 valores | |
| observacao | No | Observação sobre a origem dos metadados |