bcb_comparar
Compare 2 to 5 Brazilian economic time series over the same period, sorting them by percent change to highlight best and worst performers.
Instructions
Compara de 2 a 5 séries temporais no MESMO período (dataInicial e dataFinal obrigatórias), calculando a variação percentual de cada uma e ordenando-as num ranking (maior para menor variação). Quando usar: para comparar/correlacionar a evolução de vários indicadores lado a lado. Quando NÃO usar: para uma única série use bcb_variacao. Retorna: periodo, totalSeries, seriesComDados, seriesComErro, ranking (cada item com posicao, codigo, nome, valorInicial, valorFinal, variacaoPercentual, maximo, minimo, media) e erros. Resiliente: séries sem dados no período são isoladas em erros sem invalidar a comparação. 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 |
|---|---|---|---|
| codigos | Yes | Array com 2 a 5 códigos de séries para comparar | |
| dataInicial | Yes | Data inicial (yyyy-MM-dd ou dd/MM/yyyy) | |
| dataFinal | Yes | Data final (yyyy-MM-dd ou dd/MM/yyyy) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| periodo | Yes | Janela temporal comparada | |
| totalSeries | Yes | Quantidade de séries solicitadas | |
| seriesComDados | Yes | Quantidade de séries com dados no período | |
| seriesComErro | Yes | Quantidade de séries sem dados ou com erro | |
| ranking | Yes | Séries ordenadas pela variação percentual (maior para menor) | |
| erros | Yes | Séries que não retornaram dados, com o motivo |