---
title: "Calculadora de Calorias e Macros (Proteína / Carbo / Gordura)"
method: POST
path: "/api/v1/calc/calorias-macros"
tags: ["calc", "saude"]
---

# Calculadora de Calorias e Macros (Proteína / Carbo / Gordura)

`POST /api/v1/calc/calorias-macros`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/calorias-macros`
- Auth: HTTP bearer

Distribui calorias diárias em macronutrientes conforme objetivo e estilo de dieta. Retorna gramas de proteína, carboidrato e gordura.

## Request body

- object
  - `caloriasDiariasAlvo` integer, required: Meta calórica diária em kcal (quilocalorias), de 800 a 6000 kcal. Ex: 2000. Normalmente obtida calculando a TMB multiplicada pelo fator de atividade
  - `objetivo` 'perda_peso' | 'manutencao' | 'ganho_massa': Objetivo nutricional: "perda_peso" (maior proporção de proteína para preservar massa magra), "manutencao" (manter o peso atual) ou "ganho_massa" (maior proporção de carboidrato para energia nos treinos). Padrão: "manutencao"
  - `pesoKg` number, required: Peso corporal em quilogramas (kg), de 30 a 300 kg. Usado para calcular a necessidade de proteína em g/kg. Ex: 75.5
  - `estiloDieta` 'equilibrada' | 'low_carb' | 'high_protein' | 'cetogenica': Estilo de distribuição dos macronutrientes: "equilibrada" (30P/40C/30G), "low_carb" (35P/25C/40G), "high_protein" (40P/35C/25G) ou "cetogenica" (30P/5C/65G, muito baixo carbo). Padrão: "equilibrada"
  - `currentDate` string, date-time: ISO-8601 com offset. Default: tempo do servidor. Use pra reprodutibilidade / cache semantico.

## Response `200`

OK

- object
  - `ok` true, required
  - `data` object, required: Resultado dependente da calc — ver schema individual
  - `meta` object

## Other responses

- `422`: Input invalido (Zod parse falhou)
- `500`: Engine error

---

[API](https://skmtc.dev/calculas/apis/contai-api.md) · [All operations](https://skmtc.dev/calculas/apis/contai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/calculas/apis/contai-api/revisions/26a00749292b?raw)