A API de Índices de Correção Monetária do Cálculo Jurídico permite o acesso programático a diversos índices econômicos e financeiros utilizados no Brasil. Ideal para escritórios de advocacia, departamentos jurídicos, sistemas de cálculos e aplicações financeiras que necessitam de dados precisos e atualizados.
Nossa API fornece acesso a diversos índices, incluindo:
Todas as requisições exigem uma chave de API válida enviada no header X-CJ-API-KEY.
curl https://indices.calculojuridico.com.br/v1/list \
-H"X-CJ-API-KEY: SUA_CHAVE"
GET/POST /v1/list
Parâmetros:
show_last_available_competence (opcional): Define se exibe a última competência disponível (“true”/”false”)Exemplo de Requisição:
curl https://indices.calculojuridico.com.br/v1/list \
-X POST \
-H"Content-Type: application/json"\
-H"X-CJ-API-KEY: SUA_CHAVE"\
-d'{"show_last_available_competence": "true"}'
Exemplo de Resposta:
[
{
"chave":"ipca",
"nome":"IPCA",
"descricao":"Índice Nacional de Preços ao Consumidor Amplo",
"last_available_competence":"05/2024"
},
{
"chave":"inpc",
"nome":"INPC",
"descricao":"Índice Nacional de Preços ao Consumidor",
"last_available_competence":"05/2024"
},
{
"chave":"igpm",
"nome":"IGP-M",
"descricao":"Índice Geral de Preços do Mercado",
"last_available_competence":"05/2024"
},
{
"chave":"tr",
"nome":"TR",
"descricao":"Taxa Referencial",
"last_available_competence":"06/2024"
}
]
GET/POST /v1/index
Parâmetros:
index_kind (obrigatório): Tipo de índice (ex: “ipca”, “inpc”, “igpm”, “tr”)start_date (opcional): Data inicial (formato “DD/MM/AAAA”)end_date (opcional): Data final (formato “DD/MM/AAAA”, padrão: data atual)fill_incomplete_months (opcional): Preenche meses sem dados com variação zero (“true”/”false”, padrão: “true”)sum_variations (opcional): Retorna a soma das variações percentuais (“true”/”false”, padrão: “true”)Exemplo de Requisição:
curl https://indices.calculojuridico.com.br/v1/index \
-X POST \
-H"Content-Type: application/json"\
-H"X-CJ-API-KEY: SUA_CHAVE"\
-d'{
"index_kind": "ipca",
"start_date": "01/01/2023",
"end_date": "01/06/2024",
"fill_incomplete_months": "true"
}'
Exemplo de Resposta:
{
"name":"IPCA",
"sandbox_mode":false,
"key":"ipca",
"last_available_competence":"05/2024",
"fill_incomplete_months":true,
"warning":"Última competência disponível (05/2024) inferior à data final solicitada (06/2024). Competências incompletas preenchidas automaticamente (opção fill_incomplete_months)",
"indices":[
{
"year":2023,
"month":1,
"factor":"1.0053",
"variation_percentage":"0.53",
"cumulative_value":7384.3001
},
{
"year":2023,
"month":2,
"factor":"1.0076",
"variation_percentage":"0.76",
"cumulative_value":7440.3998
},
//...outrosmeses
{
"year":2024,
"month":5,
"factor":"1.0049",
"variation_percentage":"0.49",
"cumulative_value":7863.4592
},
{
"year":2024,
"month":6,
"factor":"1.0000",
"variation_percentage":"0.00",
"cumulative_value":7863.4592,
"filled_automatically":true,
"message":"Competência adicionada automaticamente com variação de 0%."
}
],
"variation_sum":8.32,
"resulting_factor":1.0832
}
GET/POST /v1/daily_values
Parâmetros:
index_kind (opcional): Tipo de índice (ex: “dolar”, “euro”, “selic”, “cdi”)start_date (opcional): Data inicial (formato “DD/MM/AAAA”)end_date (opcional): Data final (formato “DD/MM/AAAA”, padrão: data atual)Exemplo de Requisição:
curl https://indices.calculojuridico.com.br/v1/daily_values \
-X POST \
-H"Content-Type: application/json"\
-H"X-CJ-API-KEY: SUA_CHAVE"\
-d'{
"index_kind": "dolar",
"start_date": "01/01/2024",
"end_date": "10/01/2024"
}'
Exemplo de Resposta:
{
"name":"Dólar Comercial",
"sandbox_mode":false,
"values":[
{
"date":"2024-01-01",
"value":4.8536
},
{
"date":"2024-01-02",
"value":4.9099
},
//...outrosdias
{
"date":"2024-01-10",
"value":4.9295
}
]
}
Ao consultar a API pelo endpoint /v1/index, a resposta inclui dois campos calculados importantes:
variation_sumRepresenta a soma aritmética das variações percentuais de todos os períodos solicitados. Por exemplo, se você consultar o IPCA de Jan/2023 a Jun/2024 e as variações mensais forem 0.53%, 0.76%, 0.49%, etc., o variation_sum será a soma desses valores (por exemplo, 8.32%).
resulting_factorRepresenta o fator acumulado para o período completo consultado. É o resultado da multiplicação dos fatores individuais mensais, arredondado para 12 casas decimais. Este valor pode ser usado diretamente como multiplicador para obter o valor corrigido de um montante.
Exemplo de uso:
Valor a ser corrigido: R$ 1.000,00
Período: Jan/2023 a Jun/2024
Resulting factor: 1.0832
Valor corrigido: R$ 1.000,00 × 1.0832 = R$ 1.083,20
curl https://indices.calculojuridico.com.br/v1/index \
-X POST \
-H"Content-Type: application/json"\
-H"X-CJ-API-KEY: SUA_CHAVE"\
-d'{
"index_kind": "ipca",
"start_date": "01/01/2022",
"end_date": "01/01/2024"
}'
curl https://indices.calculojuridico.com.br/v1/index \
-X POST \
-H"Content-Type: application/json"\
-H"X-CJ-API-KEY: SUA_CHAVE"\
-d'{
"index_kind": "selic",
"start_date": "01/01/2023",
"end_date": "01/01/2024"
}'
curl https://indices.calculojuridico.com.br/v1/daily_values \
-X POST \
-H"Content-Type: application/json"\
-H"X-CJ-API-KEY: SUA_CHAVE"\
-d'{
"index_kind": "dolar",
"start_date": "01/01/2024",
"end_date": "01/06/2024"
}'
As chaves de API podem ter o modo sandbox ativado, limitando os dados aos últimos 5 anos. Quando o modo sandbox está ativo:
"sandbox_mode": trueO modo sandbox é ideal para testes e desenvolvimento sem consumir sua franquia completa de requisições.
Todas as requisições devem utilizar o content-type application/json.
http://localhost:8080/correction_index_apihttps://indices.calculojuridico.com.brDependendo do seu plano, há limites diários ou mensais de requisições. Consulte seu painel administrativo para verificar seu limite atual.
{
"errors":"Chave inválida"
}
{
"errors":"Chave revogada"
}
{
"errors":"Índice inválido"
}
{
"errors":"Parâmetro 'start_date' com formato inválido"
}
{
"errors":"Not found"
}
{
"errors":"Limite de requisições excedido",
"quota":{
"limit":1000,
"used":1000,
"reset_at":"2024-07-01T00:00:00Z"
}
}
Para obter uma chave de API e integrar o serviço de índices ao seu sistema:
Para dúvidas técnicas sobre a integração ou uso da API, entre em contato com nossa equipe de suporte técnico pelo e-mail suporte@calculojuridico.com.br.