Expectativas (Focus)

Expectativas por coleta

As estatísticas de cada coleta do Focus: mediana, média, desvio, mínimo, máximo e número de respondentes.

GEThttps://api.fintay.com.br/v1/focus/expectations

Autorização

X-API-Keystringheaderobrigatório

Chave de API criada em API Keys. Veja Chaves e limites.

Parâmetros de consulta

indicatorstring

Indicador (ex.: IPCA, Selic, PIB Total, Câmbio).

frequencystring

Frequência do período de referência.

reference_periodstring

Período de referência (ex.: 2026).

observation_datestring · date

Data da coleta.

calculation_baseintegermín. -1

Base de cálculo das estatísticas.

latestbooleanpadrão: true

Só a coleta mais recente.

limitintegerpadrão: 200mín. 1 · máx. 2000

Máximo de linhas.

Resposta

Envelope { success, data, meta }. Campos de data.items[]:

endpointstring

Exemplo: annual

observation_datestring

Exemplo: 2026-09-18

reference_periodstring

Exemplo: 2026

indicatorstring

Exemplo: IPCA

indicator_detailstring

frequencystring

Exemplo: annual

calculation_baseinteger

Exemplo: 0

calculation_typestring

smoothingstring

meannumber

Exemplo: 4.9356

mediannumber

Exemplo: 4.9205

standard_deviationnumber

Exemplo: 0.2347

minimumnumber

Exemplo: 4.047

maximumnumber

Exemplo: 5.8963

respondent_countinteger

Exemplo: 146

calculation_base_labelstring

Exemplo: data de consulta

calculation_type_labelnull

GETExpectativas por coleta

curl "https://api.fintay.com.br/v1/focus/expectations?indicator=IPCA&reference_period=2026&limit=3" \
  -H "X-API-Key: SUA_CHAVE"

Resposta

{
  "success": true,
  "data": {
    "items": [
      {
        "endpoint": "annual",
        "observation_date": "2026-09-18",
        "reference_period": "2026",
        "indicator": "IPCA",
        "indicator_detail": "",
        "frequency": "annual",
        "calculation_base": 0,
        "calculation_type": "",
        "smoothing": "",
        "mean": 4.9356,
        "median": 4.9205,
        "standard_deviation": 0.2347,
        "minimum": 4.047,
        "maximum": 5.8963,
        "respondent_count": 146,
        "calculation_base_label": "data de consulta",
        "calculation_type_label": null
      },
      {
        "endpoint": "annual",
        "observation_date": "2026-09-18",
        "reference_period": "2026",
        "indicator": "IPCA",
        "indicator_detail": "",
        "frequency": "annual",
        "calculation_base": 1,
        "calculation_type": "",
        "smoothing": "",
        "mean": 4.9719,
        "median": 4.9741,
        "standard_deviation": 0.2532,
        "minimum": 4.047,
        "maximum": 5.8963,
        "respondent_count": 91,
        "calculation_base_label": "cinco dias úteis antes",
        "calculation_type_label": null
      },
      {
        "endpoint": "top5_annual",
        "observation_date": "2026-09-18",
        "reference_period": "2026",
        "indicator": "IPCA",
        "indicator_detail": "",
        "frequency": "top5_annual",
        "calculation_base": -1,
        "calculation_type": "C",
        "smoothing": "",
        "mean": 4.8989,
        "median": 4.8489,
        "standard_deviation": 0.2325,
        "minimum": 4.6083,
        "maximum": 5.1829,
        "respondent_count": null,
        "calculation_base_label": "não publicado",
        "calculation_type_label": "Top 5 - curto prazo"
      }
    ],
    "latest": true,
    "note": "baseCalculo: 0=data de consulta; 1=cinco dias úteis antes. tipoCalculo C/M: Top 5 curto/médio prazo."
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}