---
title: "Perfil do Investidor — Suitability"
method: POST
path: "/api/v1/calc/perfil-investidor-suitability"
tags: ["calc", "financas"]
---

# Perfil do Investidor — Suitability

`POST /api/v1/calc/perfil-investidor-suitability`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/perfil-investidor-suitability`
- Auth: HTTP bearer

Descubra seu perfil de investidor (conservador, moderado ou arrojado) respondendo 6 perguntas. Receba a alocação sugerida por classe de ativo e exemplos de produtos alinhados ao seu perfil.

## Request body

- object
  - `horizonte` 'curto' | 'medio' | 'longo', required: Horizonte de tempo do investimento. "curto" = menos de 2 anos (reserva de emergência, viagem, compra próxima). "medio" = 2 a 10 anos (troca de carro, entrada de imóvel, faculdade dos filhos). "longo" = mais de 10 anos (aposentadoria, independência financeira, patrimônio).
  - `objetivo` 'preservar_capital' | 'renda_regular' | 'crescimento_moderado' | 'crescimento_agressivo', required: Principal objetivo com os investimentos. "preservar_capital" = não perder poder de compra, bater inflação. "renda_regular" = gerar renda mensal (dividendos, aluguéis de FII). "crescimento_moderado" = crescer acima do CDI com volatilidade controlada. "crescimento_agressivo" = maximizar retorno de longo prazo aceitando oscilações fortes.
  - `toleranciaPerda` 'zero' | 'ate5pct' | 'ate20pct' | 'mais20pct', required: Quanto você aceita perder temporariamente sem vender em pânico. "zero" = não aceito perdas, prefiro rentabilidade menor garantida. "ate5pct" = aceito ver até 5% negativo sem me preocupar muito. "ate20pct" = aceito quedas de até 20%, sei que mercados oscilam. "mais20pct" = aceito mais de 20% de queda temporária por retornos maiores no longo prazo.
  - `experiencia` 'nenhuma' | 'basica' | 'intermediaria' | 'avancada', required: Nível de experiência com investimentos. "nenhuma" = nunca investi além da poupança. "basica" = conheço CDB, Tesouro Direto, fundos simples. "intermediaria" = já invisto em ações, FIIs, fundos multimercado. "avancada" = opero derivativos, BDRs, investimentos no exterior, análise fundamentalista.
  - `situacaoReserva` 'sem_reserva' | 'ate3meses' | 'ate6meses' | 'acima6meses', required: Situação da sua reserva de emergência (dinheiro em liquidez diária para emergências). "sem_reserva" = não tenho reserva de emergência. "ate3meses" = tenho menos de 3 meses de despesas mensais guardadas. "ate6meses" = tenho de 3 a 6 meses de despesas mensais guardadas. "acima6meses" = tenho mais de 6 meses de despesas mensais guardadas.
  - `dependenciaRenda` 'total' | 'parcial' | 'nenhuma', required: Quanto você depende dos seus investimentos para pagar despesas mensais. "total" = minha renda principal vem dos investimentos (aposentado, rentista). "parcial" = complemento minha renda com os rendimentos dos investimentos. "nenhuma" = tenho renda de salário/empresa independente dos investimentos.
  - `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)