API JSON gratuita de índices e correção monetária

Limites

• 30 requisições por minuto por IP, sem chave.
• Chave gratuita eleva para 120 por minuto — envie em X-API-Key ou ?chave=.
• Volume maior (ERP com muitos cálculos por minuto): fale com a gente.

Endpoints

{
  "atualizadoEm": "2026-07",
  "indices": [
    {
      "slug": "ipca",
      "sigla": "IPCA",
      "fonte": "IBGE",
      "ultimoMes": "2026-07",
      "variacaoMes": 0.07,
      "acumulado12": 4.44
    }
  ]
}

{
  "slug": "ipca",
  "sigla": "IPCA",
  "serieSgs": 433,
  "inicio": "1980-01",
  "fim": "2026-07",
  "acumulado12": 4.44,
  "valores": {
    "2026-06": 0.16,
    "2026-07": 0.07
  }
}

{
  "valorOriginal": 1000,
  "indice": "ipca",
  "de": "2020-01",
  "ate": "2026-07",
  "fator": 1.4363,
  "percentualIndice": 43.63,
  "valorCorrigido": 1436.34,
  "total": 1436.34
}

{
  "indice": "igp-m",
  "meses": 12,
  "de": "2025-08",
  "ate": "2026-07",
  "percentual": 2.77,
  "fator": 1.0277
}

{
  "indice": "igp-m",
  "aniversario": "2026-09",
  "percentual": 2.77,
  "valorOriginal": 2000,
  "valorNovo": 2055.4,
  "janela": {
    "de": "2025-08",
    "ate": "2026-07"
  }
}

{
  "valor": 1000,
  "resultados": [
    {
      "indice": "selic",
      "percentual": 96.1,
      "valorCorrigido": 1961
    }
  ]
}

Exemplo de uso

const r = await fetch('https://www.corrigirvalor.com.br/api/corrigir?valor=5000&indice=ipca&de=2021-03&ate=2026-07&juros=1&multa=2');
const c = await r.json();
console.log(c.valorCorrigido, c.total);

Parâmetros de /api/corrigir: valor, indice, de, ate, mi (1 inclui o mês inicial), juros, jurosbase (mes|ano), jurostipo (simples|composto), multa, hon, modo=legal (IPCA + taxa legal da Lei 14.905/2024) e detalhe=1 para receber a memória mês a mês.

Fonte e atualização

Todas as séries vêm do SGS — Sistema Gerenciador de Séries Temporais do Banco Central, que publica os índices calculados pelo IBGE (IPCA e INPC), pela FGV (IGP-M, IGP-DI, INCC-M e INCC-DI) e pelo próprio BC (TR, Selic e poupança), além do CDI da B3. A base é atualizada automaticamente todo dia; a última leitura fechou em julho de 2026.

Pedimos apenas que, ao exibir os dados publicamente, você cite a fonte com link para www.corrigirvalor.com.br.

Códigos de resposta e erros

Todas as respostas são JSON em UTF-8, com Access-Control-Allow-Origin: *. Os códigos seguem o padrão HTTP: 200 para sucesso, 400 para parâmetro inválido (com o campo erro explicando o que faltou), 404 para índice ou endpoint inexistente e 429 quando o limite de requisições por minuto é atingido.

Em caso de 429, a resposta traz o limite e a janela aplicados. A recomendação é usar backoff simples: aguardar alguns segundos e repetir. Para uso intenso e previsível, peça uma chave gratuita pela página de contato — ela quadruplica o limite.

Os cabeçalhos de cache indicam por quanto tempo a resposta pode ser reaproveitada. Séries históricas mudam apenas uma vez por mês, quando o índice novo é divulgado; cálculos dependem só dos parâmetros. Respeitar o cache reduz a sua latência e a carga do serviço.

Boas práticas de integração

Guarde a série localmente se o seu sistema faz muitos cálculos: baixe /api/indice/:slug uma vez por dia e calcule internamente. É mais rápido e elimina dependência de rede no caminho crítico da sua aplicação.

Use o endpoint de correção quando quiser garantir que a conta siga exatamente a mesma convenção do site — mês inicial excluído por padrão, produto de fatores, arredondamento apenas no fim. Isso evita a divergência clássica entre o número do sistema e o número apresentado ao cliente.

Registre o fator e o período junto do valor calculado. Em auditoria ou em disputa, poder reproduzir a conta meses depois vale mais do que o resultado isolado — e é o que a memória de cálculo exige.

Trate meses ainda não divulgados. O campo faltando indica meses do intervalo sem dado publicado. Em vez de estimar, mostre ao usuário até que mês a conta foi feita — é o que a lei espera de qualquer demonstrativo.

Casos de uso comuns

ERP e financeiro: atualização automática de títulos vencidos, com juros e multa conforme o contrato, na emissão de segunda via de boleto. O endpoint de correção devolve principal corrigido, juros, multa e total separados, o que permite exibir a composição para o cliente.

Sistema de gestão imobiliária: cálculo do reajuste anual na data de aniversário de cada contrato, com o acumulado da janela correta. O endpoint de reajuste já aplica a defasagem de um mês e aceita teto percentual, para contratos com cláusula de limite.

Escritório de advocacia: atualização de créditos em execução, com memória mês a mês para anexar à petição. O parâmetro detalhe=1 devolve cada fator, e o modo legal aplica a regra da Lei 14.905/2024 — IPCA mais taxa legal.

Planilhas e BI: importação da série completa em CSV, com ?formato=csv, para montar painéis internos de inflação, custo de construção ou rendimento de aplicações.

Perguntas frequentes