Expectativas (Focus)

Histórico das expectativas

Evolução da mediana de um indicador ao longo das coletas, por ano de referência ou por horizonte.

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

Autorização

X-API-Keystringheaderobrigatório

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

Parâmetros de consulta

indicatorstringobrigatório

Indicador.

frequencystringpadrão: annual

Frequência.

reference_periodsstring

Anos de referência separados por vírgula.

horizonsstring

Anos à frente da coleta, ex.: 0,1,2 (só anual).

startstring · date

Primeira coleta.

endstring · date

Última coleta.

stepstringpadrão: week

Amostragem: semanal ou diária.

Resposta

Envelope { success, data, meta }. Campos de data:

as_ofstring

Exemplo: 2026-09-18

indicatorstring

Exemplo: Selic

labelstring

Exemplo: Selic

unitstring

Exemplo: % a.a. no fim do ano

kindstring

Exemplo: pct

digitsinteger

Exemplo: 2

frequencystring

Exemplo: annual

modestring

Exemplo: reference

seriesobject[]

GETHistórico das expectativas

curl "https://api.fintay.com.br/v1/focus/history?indicator=Selic&reference_periods=2026&start=2026-08-01" \
  -H "X-API-Key: SUA_CHAVE"

Resposta

{
  "success": true,
  "data": {
    "as_of": "2026-09-18",
    "indicator": "Selic",
    "label": "Selic",
    "unit": "% a.a. no fim do ano",
    "kind": "pct",
    "digits": 2,
    "frequency": "annual",
    "mode": "reference",
    "series": [
      {
        "key": "2026",
        "horizon": null,
        "points": [
          {
            "date": "2026-08-07",
            "reference_period": "2026",
            "median": 13.75,
            "mean": 13.7566,
            "min": 12.25,
            "max": 14.25,
            "std": 0.3151,
            "respondents": 151
          },
          {
            "date": "2026-08-14",
            "reference_period": "2026",
            "median": 13.75,
            "mean": 13.7078,
            "min": 12.75,
            "max": 14.25,
            "std": 0.2717,
            "respondents": 148
          },
          {
            "date": "2026-08-21",
            "reference_period": "2026",
            "median": 13.75,
            "mean": 13.6871,
            "min": 12.75,
            "max": 14.25,
            "std": 0.2651,
            "respondents": 145
          }
        ]
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}