# API do Meu Dinheiro


- **Comece aqui**
- [Introdução](/): Integre ERPs, automações e assistentes de IA a um workspace do Meu Dinheiro.
- [Primeira chamada](/primeira-chamada): Da credencial até a primeira resposta, em quatro passos.

- **Conceitos**
- [Autenticação](/autenticacao): Credencial, access token e refresh token.
- [Papéis](/papeis): O que cada credencial pode ler e escrever.
- [Listas e paginação](/paginacao): Paginação por cursor em toda listagem.
- [Limite de requisições](/limites): Cota por minuto e os cabeçalhos que a informam.
- [Erros](/erros): Formato único de erro e o que cada código significa.

- **Recursos**
- [Relatórios](/relatorios): Sinal dos valores, projetado e confirmado, período e permissões.
- [Cartões e faturas](/cartoes): Sinal dos valores, mês da fatura, status e o que é projetado.
- [Investimentos](/investimentos): Posição, rentabilidade por cotização, benchmarks, indicadores e análise mensal da carteira.

- **Assistentes de IA (MCP)**
- [Conectar um assistente](/mcp): Converse com o Claude, o ChatGPT ou o Gemini sobre as finanças do seu workspace, pelo servidor MCP do Meu Dinheiro.
- [Claude](/mcp/claude): Adicione o Meu Dinheiro como conector personalizado no Claude (web, Desktop e celular).
- [ChatGPT](/mcp/chatgpt): Crie o conector do Meu Dinheiro no ChatGPT, pelo modo desenvolvedor.
- [Gemini](/mcp/gemini): Adicione o Meu Dinheiro como conector personalizado no app do Gemini ou no Gemini Enterprise.
- [Claude Code](/mcp/claude-code): Adicione o Meu Dinheiro ao Claude Code com um comando e faça o login pelo navegador.
- [Ferramentas](/mcp/ferramentas): Todas as ferramentas do servidor MCP, por grupo, e o acesso que cada uma exige.
- [Casos de uso](/mcp/casos-de-uso): Perguntas prontas e roteiros de vários passos para usar o Meu Dinheiro com um assistente de IA.
- [Perguntas frequentes](/mcp/perguntas-frequentes): Custo, limites, permissões, segurança e como desconectar um assistente.

- **Referência**
- [Referência](/referencia): Todas as rotas da API pública, geradas do OpenAPI.
- Autenticação: Troca da credencial por tokens e renovação.
  - [Troca a credencial por um par de tokens](/referencia/autenticacao/issue-token)
  - [Renova o par de tokens pelo refresh token](/referencia/autenticacao/refresh-token): O par usado deixa de valer, inclusive o access token dele.
- Credencial: Quem é a credencial que está chamando.
  - [O workspace e a credencial ou a conexão do token](/referencia/credencial/me): A primeira chamada de quem integra, para conferir o token. Token de credencial (Key +
Secret) traz `credential`; token de uma conexão MCP aprovada por um usuário traz `connection`.
- Contas: Todas as contas do workspace, inclusive cartões de crédito, investimentos e as contas do balanço. Criar, alterar e excluir; a escrita de cartão de crédito fica em Cartões.
  - [Lista as contas](/referencia/contas/list-contas): Todas as contas do workspace: correntes, dinheiro, cartões de crédito, investimentos,
poupança, imóveis, empréstimos e as demais contas do balanço. Inclui as inativas e as
encerradas; filtre com `status=active` para só as que estão em uso. Não traz saldo.

Conta **oculta** para a credencial não aparece (e responde 404 na consulta por id); conta
**somente leitura** aparece normalmente.
  - [Cria uma conta](/referencia/contas/create-conta): Cria uma conta do workspace, com o saldo inicial lançado na data informada. Exige o papel
**Editor** ou um papel com permissão de editar Contas.

Cartão de crédito se cria em `POST /cartoes`, e esta versão não cria `aplicacao_financeira`;
os dois tipos aqui respondem 400. Em
`contas_a_pagar` a `finalidade` é obrigatória (nos outros tipos, 400), e o tipo só existe em
workspace de pessoa jurídica: em pessoa física responde 422, como o app, que não o oferece.
Em conta de passivo e de patrimônio líquido (`emprestimo_contratado`, `outros_passivos`,
`capital_social`, `contas_a_pagar`) o saldo inicial é gravado negativo, como no app. Poupança
só existe em BRL.

A resposta é a conta criada, no mesmo formato do `GET /contas/{id}`. Campo fora da lista
responde 400.
  - [Uma conta](/referencia/contas/get-conta): Conta de outro workspace, inexistente ou oculta para a credencial responde 404.
  - [Altera uma conta (só os campos enviados)](/referencia/contas/update-conta): Altera só os campos enviados; os demais ficam como estão. Nulo limpa `banco`, `agencia` e
`numero_conta`. As regras são as do `PUT`. Para tirar a conta de uso sem perder o histórico,
mude o `status` para `closed` (encerrada) ou `inactive`.
  - [Exclui uma conta](/referencia/contas/delete-conta): Exclui a conta e o saldo inicial dela. Exige o papel **Editor** ou um papel com permissão
de excluir Contas. A exclusão é definitiva.

Conta com lançamentos, com operações de investimento ou que paga um cartão de crédito não é
excluída, nem a última conta do workspace: a resposta é 422, e a saída que guarda o
histórico é encerrar a conta (`PATCH` com `status: closed`). Os tipos que a API não cria
respondem 422.
  - [Altera uma conta (todos os campos)](/referencia/contas/replace-conta): Troca todos os campos graváveis da conta; para alterar só alguns, use `PATCH`. Exige o papel
**Editor** ou um papel com permissão de editar Contas. O `tipo` não muda depois de criada:
`tipo` e `id` no corpo respondem 400.

Nesta versão a API altera só os tipos que ela cria; `cartao_credito` (que se altera em
`/cartoes`) e `aplicacao_financeira` respondem 422. Em `contas_a_pagar` a `finalidade` também é exigida. Em conta de passivo e
de patrimônio líquido o saldo inicial é gravado negativo, como na criação.
- Cartões: Cartões de crédito, com os plásticos, e as faturas, com os números da tela da fatura. Criar, alterar e excluir. Sinal dos valores, mês da fatura e permissões no guia Cartões e faturas.
  - [Lista os cartões de crédito](/referencia/cartoes/list-cartoes): Os cartões do workspace com limite, vencimento, fechamento, a conta que paga a fatura e os
plásticos. Inclui os inativos e os encerrados; filtre com `status=active` para só os que estão
em uso. Cartão **oculto** para a credencial não aparece.
  - [Cria um cartão](/referencia/cartoes/create-cartao): Cria um cartão de crédito com os plásticos (um titular e os adicionais) e a fatura do mês
anterior ao vencimento, já fechada com o `valor_fatura_anterior`. Exige o papel **Editor** ou
um papel com permissão de editar Contas (o mesmo do app). A conta de pagamento precisa estar na
moeda do cartão e ser conta corrente, dinheiro, poupança ou conta do balanço.

A resposta é o cartão criado, no formato do `GET /cartoes/{id}`. O cartão também aparece em
`/contas`, com `tipo` `cartao_credito`, mas só se escreve aqui.
  - [A fatura de todos os cartões num mês](/referencia/cartoes/list-faturas-do-mes): O resumo da fatura de cada cartão em uso que vence no mês, numa chamada só: "quanto vou
pagar de cartão este mês". Sem `mes`, a fatura aberta de cada cartão. Os números são os de
`GET /cartoes/{id}/faturas/{mes}`, sem os lançamentos; cartão cuja fatura do mês passa do
horizonte de faturas futuras fica de fora.
  - [As parcelas futuras de todos os cartões](/referencia/cartoes/list-parcelas-futuras-de-todos): As parcelas futuras de cada cartão em uso, numa chamada só, um bloco por cartão no formato de `GET /cartoes/{id}/parcelas-futuras`.
  - [Um cartão](/referencia/cartoes/get-cartao): Cartão de outro workspace, inexistente, oculto para a credencial ou conta que não é cartão responde 404.
  - [Altera um cartão (só os campos enviados)](/referencia/cartoes/update-cartao): Altera só os campos enviados; as regras são as do `PUT`. Para tirar o cartão de uso sem perder
o histórico, mude o `status` para `closed`.
  - [Exclui um cartão](/referencia/cartoes/delete-cartao): Exclui o cartão, os plásticos e as faturas. Exige o papel **Editor** ou um papel com
permissão de excluir Contas. A exclusão é definitiva. Cartão com lançamentos não é
excluído (422): a saída que guarda o histórico é encerrá-lo (`PATCH` com `status: closed`).
  - [Altera um cartão (todos os campos)](/referencia/cartoes/replace-cartao): Troca todos os campos do cartão (menos `valor_fatura_anterior`, opcional); para alterar só
alguns, use `PATCH`. Exige o papel **Editor** ou um papel com permissão de editar Contas.

Plásticos: com `id`, o existente (nome e status; o titular não se inativa); sem `id`, um novo.
Plástico fora da lista fica como está, e adicional inativado sem lançamentos é excluído, como
no app. Trocar o `proximo_vencimento` desloca as faturas abertas: no máximo um mês adiante, e
para trás só se aquele mês não tem fatura fechada; adiante, com fatura fechada antiga, a fatura
aberta é fechada.
  - [As faturas do cartão, mês a mês](/referencia/cartoes/list-faturas): Um resumo por fatura, de `inicio` a `fim`: vencimento, situação, valor e pagamentos. Os meses
antes da fatura aberta só aparecem quando a fatura existe; da aberta em diante, todos — a futura
traz o que já foi lançado nela, inclusive parcelas e recorrências.
  - [Uma fatura com os lançamentos](/referencia/cartoes/get-fatura): A fatura que vence em `mes`, com o resumo da tela e todos os lançamentos (sem paginação). Mês
sem fatura — antes do cartão, a primeira (que só guarda o saldo anterior ao cadastro) ou anterior
à aberta que não existe — responde 404.
  - [As parcelas que ainda vão cair](/referencia/cartoes/list-parcelas-futuras): As parcelas de compras parceladas nas faturas depois da aberta, como na tela Parcelas futuras.
- Categorias: As categorias de receita e despesa e as subcategorias. Criar, alterar e excluir, levando os lançamentos para outra categoria.
  - [Lista as categorias](/referencia/categorias/list-categorias): Categorias de receita, despesa e transferência, com as subcategorias na mesma lista
(`categoria_pai_id` aponta para a categoria de cima). Inclui as inativas, que lançamentos
antigos ainda usam; filtre com `status=active` para ficar só com as ativas.
  - [Cria uma categoria](/referencia/categorias/create-categoria): Cria uma categoria ativa de receita ou despesa; com `categoria_pai_id`, uma subcategoria
(um nível só, do mesmo tipo da de cima, que deve estar ativa). Transferência é do Meu
Dinheiro e não se cria. As linhas do DRE e do DFC não fazem parte da API: a categoria
nasce sem elas, e quem usa os demonstrativos as liga pelo app. Exige o papel
**Editor** ou um papel com permissão de editar Categorias. A resposta tem o mesmo
formato do `GET /categorias/{id}`.
  - [Uma categoria](/referencia/categorias/get-categoria)
  - [Altera uma categoria (só os campos enviados)](/referencia/categorias/update-categoria): Altera somente os campos enviados; `categoria_pai_id` nulo leva a categoria ao primeiro
nível. Inativar a que tem subcategoria ativa, ou pôr sob outra a que tem subcategorias, é
422. Exige o papel **Editor** ou um papel com permissão de editar Categorias.
  - [Exclui uma categoria](/referencia/categorias/delete-categoria): Exclui a categoria e leva para `destino_id`, **obrigatório**, os lançamentos, agendas e
regras que a usavam: lançamento não fica sem categoria. O destino deve ser outra categoria
do mesmo workspace e do mesmo tipo (inativa ou subcategoria também serve). As metas de
orçamento da categoria são apagadas. Categoria de sistema e categoria com subcategorias não
se excluem. Exige o papel **Editor** ou um papel com permissão de excluir Categorias. A
exclusão é definitiva.
  - [Altera uma categoria (todos os campos)](/referencia/categorias/replace-categoria): Troca nome, categoria de cima e status; `tipo` não muda (400). Categoria de sistema não se
altera (422). Para alterar só alguns campos, use `PATCH`. Exige o papel **Editor** ou um
papel com permissão de editar Categorias.
- Centros de custo: Os centros de custo do workspace. Criar, alterar e excluir.
  - [Lista os centros de custo](/referencia/centros-de-custo/list-centros): Os centros de custo do workspace, que classificam lançamentos por área, setor ou
atividade. Inclui os inativos; `status` filtra.
  - [Cria um centro de custo](/referencia/centros-de-custo/create-centro): Cria um centro de custo ativo. Exige o papel **Editor** ou um papel com permissão de
editar Centros. A resposta tem o mesmo formato do `GET /centros/{id}`.
  - [Um centro de custo](/referencia/centros-de-custo/get-centro): Centro de outro workspace, ou inexistente, responde 404.
  - [Altera um centro de custo (só os campos enviados)](/referencia/centros-de-custo/update-centro): Altera somente `nome` e/ou `status`; os campos ausentes ficam como estão. Exige o papel
**Editor** ou um papel com permissão de editar Centros.
  - [Exclui um centro de custo](/referencia/centros-de-custo/delete-centro): Exclui o centro. `destino_id` leva para outro centro os lançamentos, agendas e regras
que o usavam; sem destino, eles ficam sem centro. O destino deve pertencer ao mesmo
workspace e ser diferente do excluído. Exige o papel **Editor** ou um papel com permissão
de excluir Centros. A exclusão é definitiva.
  - [Altera um centro de custo (todos os campos)](/referencia/centros-de-custo/replace-centro): Troca `nome` e `status`; para alterar só um deles, use `PATCH`. Exige o papel **Editor**
ou um papel com permissão de editar Centros.
- Tags: Os marcadores livres dos lançamentos. Criar, alterar e excluir.
  - [Lista as tags](/referencia/tags/list-tags): As tags do workspace, marcadores livres dos lançamentos. Inclui as inativas;
`status` filtra.
  - [Cria uma tag](/referencia/tags/create-tag): Cria uma tag ativa. Exige o papel **Editor** ou um papel com permissão de editar Tags.
A resposta tem o mesmo formato do `GET /tags/{id}`.
  - [Uma tag](/referencia/tags/get-tag): Tag de outro workspace, ou inexistente, responde 404.
  - [Altera uma tag (só os campos enviados)](/referencia/tags/update-tag): Altera somente `nome`, `cor` e/ou `status`; os campos ausentes ficam como estão. Exige o
papel **Editor** ou um papel com permissão de editar Tags.
  - [Exclui uma tag](/referencia/tags/delete-tag): Exclui a tag e a tira dos lançamentos, das agendas e das regras que a usavam. Exige o papel
**Editor** ou um papel com permissão de excluir Tags. A exclusão é definitiva.
  - [Altera uma tag (todos os campos)](/referencia/tags/replace-tag): Troca `nome`, `cor` e `status`; para alterar só alguns deles, use `PATCH`. Exige o papel
**Editor** ou um papel com permissão de editar Tags.
- Formas de pagamento: As formas de pagamento do workspace. Criar, alterar e excluir.
  - [Lista as formas de pagamento](/referencia/formas-de-pagamento/list-formas-pagamento): As formas de pagamento do workspace. Inclui as inativas; `tipo` e `status` filtram.
  - [Cria uma forma de pagamento](/referencia/formas-de-pagamento/create-forma-pagamento): Cria uma forma ativa do tipo `normal`; no workspace que ainda não tem formas, cria antes as
formas padrão. A de `cartao_credito` é criada pelo Meu Dinheiro e não se cria pela API.
Exige o papel **Editor** ou um papel com permissão de editar Formas de pagamento.
  - [Uma forma de pagamento](/referencia/formas-de-pagamento/get-forma-pagamento): Forma de outro workspace, ou inexistente, responde 404.
  - [Altera uma forma de pagamento (só os campos enviados)](/referencia/formas-de-pagamento/update-forma-pagamento): Altera `nome` e/ou `status`; o `tipo` não muda e os campos ausentes ficam como estão. Exige
o papel **Editor** ou um papel com permissão de editar Formas de pagamento.
  - [Exclui uma forma de pagamento](/referencia/formas-de-pagamento/delete-forma-pagamento): Exclui a forma e a tira dos lançamentos, das agendas e das regras que a usavam. A de cartão
de crédito não pode ser excluída. Exige o papel **Editor** ou um papel com permissão de
excluir Formas de pagamento. A exclusão é definitiva.
  - [Altera uma forma de pagamento (todos os campos)](/referencia/formas-de-pagamento/replace-forma-pagamento): Troca `nome` e `status`; o `tipo` não muda. Para alterar só um campo, use `PATCH`. Exige o
papel **Editor** ou um papel com permissão de editar Formas de pagamento.
- Projetos: Os projetos, com período e metas. Criar, alterar e excluir.
  - [Lista os projetos](/referencia/projetos/list-projetos): Os projetos do workspace, que agrupam lançamentos de uma obra, evento ou cliente, com
o período e as metas do projeto inteiro. Inclui os inativos; `status` filtra.
  - [Cria um projeto](/referencia/projetos/create-projeto): Cria um projeto ativo. Exige o papel **Editor** ou um papel com permissão de
editar Projetos. A resposta tem o mesmo formato do `GET /projetos/{id}`.
  - [Um projeto](/referencia/projetos/get-projeto): Projeto de outro workspace, ou inexistente, responde 404.
  - [Altera um projeto (só os campos enviados)](/referencia/projetos/update-projeto): Altera somente os campos enviados; os ausentes ficam como estão, e nulo em `inicio`, `fim`
ou nas metas remove o valor. Exige o papel **Editor** ou um papel com permissão de editar
Projetos.
  - [Exclui um projeto](/referencia/projetos/delete-projeto): Exclui o projeto. `destino_id` leva para outro projeto os lançamentos, agendas e regras
que o usavam; sem destino, eles ficam sem projeto. As metas por categoria do projeto são
apagadas nos dois casos. O destino deve pertencer ao mesmo workspace e ser diferente do
excluído. Exige o papel **Editor** ou um papel com permissão de excluir Projetos. A
exclusão é definitiva.
  - [Altera um projeto (todos os campos)](/referencia/projetos/replace-projeto): Troca todos os campos; `inicio`, `fim` e as metas aceitam nulo. Para alterar só alguns, use
`PATCH`. Exige o papel **Editor** ou um papel com permissão de editar Projetos.
- Contatos: Os clientes e fornecedores do workspace. Criar, alterar e excluir.
  - [Lista os contatos](/referencia/contatos/list-contatos): Os clientes e fornecedores do workspace, com documento, e-mail, telefones e
endereço. Inclui os inativos. `tipo_contato=cliente` traz também quem é cliente **e**
fornecedor (`ambos`); o mesmo vale para `fornecedor`.
  - [Cria um contato](/referencia/contatos/create-contato): Cria um contato ativo. `nome`, `tipo_pessoa` e `tipo_contato` são obrigatórios; o
`documento` é validado (CPF na pessoa física, CNPJ, inclusive alfanumérico, na jurídica) e
gravado sem pontuação. RG, nascimento, inscrições, observação, campos personalizados e
anexos ficam fora do contrato. Exige o papel **Editor** ou um papel com permissão de
editar Contatos. A resposta tem o mesmo formato do `GET /contatos/{id}`.
  - [Um contato](/referencia/contatos/get-contato): Contato de outro workspace, ou inexistente, responde 404.
  - [Altera um contato (só os campos enviados)](/referencia/contatos/update-contato): Altera somente os campos enviados; os ausentes ficam como estão. Trocar `tipo_pessoa`
confere o documento gravado contra o tipo novo. Exige o papel **Editor** ou um papel com
permissão de editar Contatos.
  - [Exclui um contato](/referencia/contatos/delete-contato): Exclui o contato. `destino_id` leva para outro contato os lançamentos, agendas e regras
que o usavam; sem destino, eles ficam sem contato. Contato com proposta comercial não é
excluído (422). O destino deve pertencer ao mesmo workspace e ser diferente do excluído.
Exige o papel **Editor** ou um papel com permissão de excluir Contatos. A exclusão é
definitiva.
  - [Altera um contato (todos os campos)](/referencia/contatos/replace-contato): Troca todos os campos do contrato; nulo limpa. O que está fora do contrato (RG, nascimento,
inscrições, observação, campos personalizados, anexos) fica como está. Para alterar só
alguns, use `PATCH`. Exige o papel **Editor** ou um papel com permissão de editar
Contatos.
- Relatórios: Os relatórios de lançamentos do app, com os mesmos números da tela: totais por cadastro, resultado, saldos, fluxo de caixa, metas, DRE e DFC. Sinal dos valores, período e permissões no guia Relatórios.
  - [Totais por categoria](/referencia/relatorios/relatorio-totais-categorias): Soma por categoria, com a categoria de cima em `categoria_pai`. É a tela Totais por categoria; com `intervalo`, a Evolução por categoria. Sem `tipo`, receita e despesa.

Exige a permissão de ver Totais por categoria, Evolução por categoria, Despesas/Receitas por categoria da visão geral ou Lançamentos por categoria.
  - [Totais por centro de custo](/referencia/relatorios/relatorio-totais-centros): Soma por centro de custo e tipo. É a tela Totais por centro; com `intervalo`, a Evolução por centro. Sem `tipo`, receita e despesa.

Exige a permissão de ver Totais por centro, Evolução por centro, Despesas/Receitas/Resultados por centro da visão geral ou Lançamentos por centro.
  - [Totais por contato](/referencia/relatorios/relatorio-totais-contatos): Soma por contato (cliente ou fornecedor) e tipo. Sem `tipo`, receita e despesa.

Exige a permissão de ver Totais por contato, Evolução por contato, Resultados por contato ou Lançamentos por contato.
  - [Totais por projeto](/referencia/relatorios/relatorio-totais-projetos): Soma por projeto e tipo. Sem `tipo`, receita e despesa.

Exige a permissão de ver Totais por projeto, Resultados por projeto ou Lançamentos por projeto.
  - [Totais por tag](/referencia/relatorios/relatorio-totais-tags): Soma por tag e tipo. Lançamento sem tag não entra; com duas tags, entra nas duas. Sem `tipo`, receita e despesa.

Exige a permissão de ver Totais por categoria.
  - [Totais por conta](/referencia/relatorios/relatorio-totais-contas): Movimento do período por conta e tipo, na apuração de resultado (sem saldo inicial). Para o saldo, use `/relatorios/saldos`. Sem `tipo`, receita e despesa.

Exige a permissão de ver Lançamentos de caixa, Extrato de contas, Saldos de caixa ou Resultados de caixa.
  - [Receitas × despesas](/referencia/relatorios/relatorio-resultado): Receitas, despesas e o resultado do período, com as transferências à parte. É o Resultado
do mês da visão geral; com `intervalo`, a evolução dele.

Exige a permissão de ver Resultados do mês, Comparação entre períodos ou Lançamentos de caixa.
  - [Saldo de cada conta numa data](/referencia/relatorios/relatorio-saldos): O saldo de cada conta ao fim de `data`, como no card Saldos de caixa: saldo inicial e todos
os lançamentos até a data, com a fatura do cartão projetada na conta que a paga. `projetado`
inclui o que vence até a data e ainda não foi pago; `confirmado`, só o realizado.

Exige a permissão de ver Saldos de caixa, Extrato de contas, Lançamentos de caixa ou Fluxo de caixa.
  - [Fluxo de caixa](/referencia/relatorios/relatorio-fluxo-caixa): Saldo inicial, entradas, saídas, resultado e saldo acumulado por período, no total e por conta,
como na tela Fluxo de caixa. Entram as contas de caixa (disponíveis, ativas, na moeda pedida;
sem cartão nem carteira de investimentos), e a fatura do cartão aparece projetada na conta que
a paga. Os valores são os projetados: `status` decide o que entra.

Os pendentes vencidos seguem a configuração do workspace (o
`pendentes_no_presente` não se aplica aqui, como na tela).

Exige a permissão de ver Fluxo de caixa.
  - [Meta × realizado por categoria](/referencia/relatorios/relatorio-metas-categorias): O Orçamento: a meta de cada categoria no período, o realizado e quanto falta ou excedeu. A categoria de cima soma as filhas; o que foi lançado direto nela, sem subcategoria, vem numa linha própria com `lancado_na_categoria_pai: true`. As metas de investimento não entram.

O período conta em meses inteiros (`inicio` vai ao primeiro dia do mês e `fim`, ao último).
Com `intervalo=mes`, uma linha por mês; outro intervalo é 400.

Exige a permissão de ver Metas de orçamento ou Metas de despesa/receita da visão geral.
  - [Meta × realizado por centro de custo](/referencia/relatorios/relatorio-metas-centros): As Metas por centro: a meta de despesa e de receita de cada centro de custo no período, o realizado e quanto falta ou excedeu.

O período conta em meses inteiros (`inicio` vai ao primeiro dia do mês e `fim`, ao último).
Com `intervalo=mes`, uma linha por mês; outro intervalo é 400.

Exige a permissão de ver Metas por centros.
  - [Demonstração do Resultado do Exercício (DRE)](/referencia/relatorios/relatorio-dre): As linhas do DRE, com o valor de cada período, a análise vertical (sobre a Receita Líquida) e
a horizontal (sobre o período anterior), a média e o total. A categoria vai para a linha a que
está vinculada na tela do DRE; sem vínculo, para a linha padrão do tipo dela. Linhas de
`tipo: categorias` trazem as categorias em `itens`.

Exige a permissão de ver o DRE.
  - [Demonstração do Fluxo de Caixa (DFC)](/referencia/relatorios/relatorio-dfc): As linhas do DFC por atividade (operacional, investimento e financiamento), do saldo inicial ao
saldo final de caixa, com o valor de cada período, as análises, a média e o total. Sempre no
regime de caixa, sobre as contas de caixa.

Exige a permissão de ver o DFC.
- Investimentos: A carteira de investimentos, com os números da tela: posição por ativo e conta e as estratégias de alocação. Somente leitura. Exige a permissão do módulo de investimentos e o módulo no plano do workspace (sem ele, 403 `plan_required`).
  - [A posição da carteira, por ativo e conta](/referencia/investimentos/get-carteira-investimentos): Uma linha por ativo em cada conta de investimento (`tipo: ativo`) e uma por conta de
investimento que não é carteira de ativos, como um CDB ou uma poupança (`tipo: conta`).
Os valores são os da tela da carteira. O valor dos títulos indexados e das contas vem da série
de rentabilidade, calculada até `atualizado_ate`. Se a data não for ontem, abra Investimentos
no Meu Dinheiro para atualizar; a leitura não recalcula nem grava.

A conta oculta para a credencial não entra, e pedi-la em `contas` responde 404. Sem o módulo
de investimentos no plano, 403 com `code` `plan_required`.
  - [As estratégias de alocação da carteira](/referencia/investimentos/list-estrategias): "Tipo de ativo" (id 0), que o app monta a partir do tipo de cada ativo, e as estratégias
ativas do workspace. Sem o plano avançado de investimentos, só as do sistema, como no app.
O id do grupo da "Tipo de ativo" é o código do tipo.
  - [A rentabilidade da carteira, com benchmarks](/referencia/investimentos/get-rentabilidade): A rentabilidade por cotização (como a tela: aporte e retirada não distorcem), acumulada desde
o dia anterior ao `inicio`, da carteira inteira ou de um recorte (`contas`, `ativos` ou o
grupo de uma estratégia). Valores em fração: 0,05 é 5%.

A série só vai até `atualizado_ate`, o último dia que o Meu Dinheiro calculou; os benchmarks
param na mesma data, para a comparação ser na mesma janela. `inicio` antes de 2018-01-01, o
marco da rentabilidade, vira 2018-01-01, e a resposta traz o `inicio` usado. Se
`atualizado_ate` não for ontem, abra Investimentos no Meu Dinheiro para atualizar; a leitura
não recalcula nem grava.
  - [A rentabilidade de cada ativo no período, do maior para o menor](/referencia/investimentos/list-rentabilidade-ativos): Por ativo em cada conta, desde `inicio` até a última cota calculada (`atualizado_ate`), com o
valor atual e a participação da posição de hoje (nulos quando a posição já fechou).
  - [Os índices que a rentabilidade compara](/referencia/investimentos/list-benchmarks)
  - [Rentabilidade, volatilidade e Sharpe da carteira](/referencia/investimentos/get-indicadores-carteira): Os indicadores do card da tela, do primeiro dia do mês de `inicio` ao último do de `fim` (até
ontem). A volatilidade é o desvio padrão da variação diária da cota; a anual, ela × √252. O
Sharpe compara com o CDI do mesmo período. Com menos de duas cotas no período, os campos vêm
nulos.
  - [A análise da carteira por mês ou por ano](/referencia/investimentos/get-analise-carteira): Por período: saldo inicial e final, aportes, retiradas, transferências de custódia,
proventos, variação, rendimentos, resultado das vendas, custos, IR e apurações; e o total do
intervalo, com a rentabilidade por cotização e a TIR. Os números são os das telas de análise
da carteira. Até 60 meses.

A análise roda na hora e pesa pelo número de ativos × meses: numa carteira grande, o período
pedido pode passar do que dá para calcular de uma vez. Aí a resposta é **422**
`analysis_too_complex`, com `max_meses_sugerido` (o maior período que cabe; nulo quando nem
um mês cabe), antes de qualquer cálculo. Repita com o período sugerido ou recorte por `contas`.