---
title: "Reserva de Oportunidade — quanto deixar para crash, imóvel ou negócio"
method: POST
path: "/api/v1/calc/reserva-oportunidade"
tags: ["calc", "financas"]
---

# Reserva de Oportunidade — quanto deixar para crash, imóvel ou negócio

`POST /api/v1/calc/reserva-oportunidade`

## Request

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

Reserva tática separada da emergência: 5–20% do patrimônio em alta liquidez para aproveitar oportunidades de mercado. Ajustada por objetivo e horizonte.

## Request body

- object
  - `patrimonioLiquidoCents` integer: Patrimônio financeiro total disponível para investimento (excluindo imóveis e bens não financeiros) em centavos. Ex: R$ 500.000 → 50000000. Padrão: R$ 500.000
  - `reservaEmergenciaJaCobertaCents` integer: Valor que você já possui na reserva de emergência em centavos. A reserva de emergência deve ser prioridade antes da reserva de oportunidade. Ex: R$ 30.000 → 3000000. Padrão: 0
  - `objetivoOportunidade` 'acoes_crash' | 'imovel_descontado' | 'negocio_proprio' | 'crypto_dca' | 'geral': Tipo de oportunidade para a qual está reservando capital: "acoes_crash" (comprar ações em queda de mercado — 10%), "imovel_descontado" (imóvel abaixo do mercado — 15%), "negocio_proprio" (abrir ou expandir negócio — 20%), "crypto_dca" (aportes em criptoativos — 5%), "geral" (oportunidade genérica — 10%). Padrão: "geral"
  - `horizonteMeses` integer: Prazo estimado em meses até você precisar usar a reserva (6 a 120). Ex: 24 = 2 anos. Padrão: 24 meses
  - `aceitaRiscoMercado` boolean: Se verdadeiro (true), aceita incluir multimercado de baixa volatilidade na composição (maior rentabilidade, liquidez D+30+). Se falso (false), mantém composição 100% líquida. Padrão: false
  - `valorJaAlocadoOportunidadeCents` integer: Valor que você já tem alocado como reserva de oportunidade em centavos. Ex: R$ 10.000 → 1000000. Padrão: 0
  - `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)