bcb_serie_ultimos
Retrieve the most recent N values from a Brazilian Central Bank time series. Use to get the current data points without specifying dates.
Instructions
Obtém as últimas N observações de UMA série temporal do BCB (mais recentes primeiro a partir do fim da série). Quando usar: para ver os dados mais recentes sem precisar calcular datas (ex.: últimos 12 meses do IPCA). Quantidade entre 1 e 1000 (padrão 10). Quando NÃO usar: para um intervalo de datas ou o histórico completo use bcb_serie_valores. Retorna: objeto serie, totalRegistros e dados (array de {data, valor}); sem dados, totalRegistros = 0 com 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 | |
| quantidade | No | Quantidade de valores a retornar (1-1000, padrão: 10) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| serie | Yes | ||
| totalRegistros | Yes | Quantidade de observações retornadas | |
| dados | Yes | Observações mais recentes | |
| observacao | No | Mensagem informativa (ex.: quando não há dados) |