v20

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-07-2176162684.2 KB

Indicadores

Obter Dados de Inflação (IPCA)

Retorna dados históricos do IPCA (Índice Nacional de Preços ao Consumidor Amplo), o índice oficial de inflação do Brasil, medido pelo IBGE.

Funcionalidades

Dados Mensais: Variação percentual mensal do IPCA
Histórico Completo: Dados desde janeiro/2000 até o mês atual
Filtros de Período: Use start e end para definir período específico (formato DD/MM/YYYY)
Ordenação: Ordene por data ou valor, crescente ou decrescente

Autenticação

Bearer token ou query param token. Requer plano Startup.

Exemplos de Uso

# Padrão (últimos 12 meses)
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/inflation"

# Histórico completo
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/inflation?historical=true"

# Período específico
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/inflation?start=01/01/2023&end=31/12/2023"

# Ordenado por valor (decrescente)
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/inflation?historical=true&sortBy=value&sortOrder=desc"

Parâmetros de Ordenação

sortBy: date (padrão) ou value
sortOrder: desc (padrão) ou asc

Campos da Resposta

date — Data no formato DD/MM/YYYY
value — Variação percentual do IPCA no mês
epochDate — Data em timestamp Unix (milissegundos)

Sobre o IPCA

O IPCA é o índice oficial de inflação do Brasil, calculado mensalmente pelo IBGE. Ele mede a variação de preços de uma cesta de produtos e serviços consumidos pelas famílias brasileiras.

Fonte dos Dados

Banco Central do Brasil (BCB) — indicador IPCA publicado como série temporal oficial

Plano Mínimo: Startup | Autenticação: Necessária

get/api/v2/inflation

Query parameters

historicalstring

Incluir dados históricos (true/false)

Example:false

startstring

Data de início (DD/MM/YYYY)

Example:01/01/2023

endstring

Data de fim (DD/MM/YYYY)

Example:31/12/2023

sortBystring

Campo para ordenação (date ou value)

Example:date

sortOrderstring

Ordem de classificação (asc ou desc)

Example:desc

Response

Dados históricos de inflação (IPCA) retornados com sucesso conforme os filtros aplicados. Array contém variações percentuais mensais ordenadas conforme solicitado.

requestedAtstring date-time required

Data e hora da requisição em formato ISO 8601

tookinteger required

Tempo de processamento em milissegundos

Example response

{
  "inflation": [
    {
      "date": "01/12/2025",
      "value": "4.26",
      "epochDate": 1764558000000
    },
    {
      "date": "01/11/2025",
      "value": "4.46",
      "epochDate": 1761966000000
    },
    {
      "date": "01/10/2025",
      "value": "4.68",
      "epochDate": 1759287600000
    }
  ],
  "requestedAt": "2026-02-08T16:26:26.123Z",
  "took": 138
}