bcb_focus_referencias
Discover which indicator names and reference formats Focus publishes per scope to avoid empty query results, enabling exact matches for expectations and Selic Copom lookups.
Instructions
Lista, POR ESCOPO, os indicadores e as referências que o Focus efetivamente publica, para você usar o texto EXATO em bcb_focus_expectativas e em bcb_focus_selic. Escopo = os cinco horizontes de bcb_focus_expectativas mais 'selic', que não é horizonte: o eixo dela é a reunião do Copom, e quem a consome é bcb_focus_selic. Cada bloco diz em tool quem o consome. Quando usar: antes da primeira consulta ao Focus, ou quando uma consulta volta vazia — a causa mais comum não é o dado faltar, é o indicador não existir NAQUELE escopo (a fonte publica 9 indicadores no mensal e 26 no anual: 'PIB Total', por exemplo, não existe no mensal) ou a referência estar num formato diferente do publicado. Quando NÃO usar: para os valores das expectativas em si. Sem escopo, consulta os seis e devolve tudo; com escopo, consulta só aquele. Retorna: escopos (para cada um: tool que o consome, formatoReferencia, exigeReferencia, temTop5, indicadores, referencias, urlConsulta e disponivel), mais indicadores e referencias como união de todos, janela, totalRegistros e consultadoEm. Se algum escopo não responder, os demais voltam mesmo assim, com falhas preenchido. Fonte: Expectativas de Mercado (Focus) do Banco Central do Brasil, via Olinda OData. O Focus é vintage por construção: coletadoEm é a data da coleta e referencia é o alvo da expectativa — a mesma referência aparece em muitas coletas, e é isso que permite ver a expectativa mudar no tempo. A contagem é feita do nosso lado porque a fonte ignora $count; e o filtro é obrigatório por construção porque consulta sem filtro não completa na origem. Microdados por instituição NÃO são expostos: a fonte desativou esse recurso por risco de quebra de confidencialidade.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| escopo | No | Restringe a descoberta a um escopo (opcional). 'selic' descobre as reuniões do Copom para bcb_focus_selic; os demais são os horizontes de bcb_focus_expectativas. | |
| indicador | No | Filtrar por um indicador específico, para ver em quais escopos ele existe (opcional) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| falhas | No | Escopos que não responderam nesta consulta | |
| filtro | No | Filtro pedido; nulo onde o parâmetro não foi informado | |
| janela | Yes | Janela de coleta observada para montar as listas | |
| escopos | Yes | Um bloco por escopo: regras do contrato mais o que a fonte publica nele | |
| observacao | No | ||
| provenance | Yes | Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença | |
| attribution | Yes | URLs canônicas das fontes desta resposta (lista de atribuição) | |
| indicadores | Yes | União dos indicadores de todos os escopos consultados | |
| referencias | Yes | União das referências de todos os escopos consultados | |
| consultadoEm | Yes | ||
| totalRegistros | Yes | ||
| observacaoFalhas | No |