DataBolsa docs
Referência da APIDados de mercadoMacro

Expectativas Focus (consenso por indicador)

Consenso do Boletim Focus (BCB) para ipca, selic, pib ou cambio. Informe `reference` (ano) para uma série limpa; sem ele, mistura todos os anos de referência. As pesquisas vêm em `data` (o campo `surveys` da raiz não existe mais); indicador, referência e realizado em `meta`. **Ordem DECRESCENTE** — a pesquisa mais recente primeiro, declarado em `meta.order`. É o sentido OPOSTO ao de `getSeries`; conferir antes de calcular variação entre linhas. **Peça `latest=N`.** Sem ele a resposta é o histórico completo do indicador.

GET
/v1/macro/expectations
AuthorizationBearer <token>

In: header

Query Parameters

indicatorstring
Value in"ipca" | "selic" | "pib" | "cambio"
reference?string

Ano de referência do consenso, ex.: '2026'. Omitir retorna TODAS as referências (mistura anos); informe um ano para uma série limpa.

from?string
Match^\d{4}-\d{2}-\d{2}$
to?string
Match^\d{4}-\d{2}-\d{2}$
latest?integer

As N pesquisas MAIS RECENTES. Use quase sempre. Sem isto a resposta é o histórico Focus inteiro do indicador, que já estourou o teto de tokens de uma tool. Combine com reference para uma série limpa de um ano só.

Range1 <= value <= 5000

Response Body

curl -X GET "https://api.databolsa.com/v1/macro/expectations?indicator=ipca&reference=string&from=string&to=string&latest=1"
{
  "data": [
    {
      "survey_date": "string",
      "reference": "string",
      "median": 0,
      "mean": 0,
      "std_dev": 0,
      "respondents": 0,
      "base": 0
    }
  ],
  "meta": {
    "next_cursor": "string",
    "count": 0,
    "total": 0,
    "subject": {
      "property1": "string",
      "property2": "string"
    },
    "indicator": "string",
    "reference": "string",
    "realized": 0,
    "unit": "string",
    "dimension": "rate",
    "period": "annual",
    "frequency": "weekly",
    "order": "desc",
    "truncated": true
  }
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "details": {
    "property1": null,
    "property2": null
  }
}