A análise da carteira por mês ou por ano
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.
accessTokenAuthorizationBearer <token>Access token (mda_…) obtido em POST /auth/token. Vale 1 hora.
inicio?stringO primeiro mês. Sem o parâmetro, 11 meses antes do fim; antes de 2018-01, 2018-01.
^\d{4}-(0[1-9]|1[0-2])$fim?stringO último mês, até o corrente. Sem o parâmetro, o mês corrente.
^\d{4}-(0[1-9]|1[0-2])$intervalo?stringUm período por mes ou por ano.
"mes""mes""ano"detalhar?booleanCom true, traz também os grupos da estratégia (ou dos tipos de ativo), com os ativos.
falsecontas?stringIds das contas de investimento, separados por vírgula.
estrategia?integerO id de uma estratégia (GET /investimentos/estrategias).
grupo?integerO id de um grupo da estrategia; exige estrategia.
moeda?stringCódigo ISO 4217 dos valores, convertidos. Sem o parâmetro, BRL.
A análise.
application/json- response
inicio*MesMês no formato AAAA-MM.
^\d{4}-(0[1-9]|1[0-2])$fim*MesMês no formato AAAA-MM.
^\d{4}-(0[1-9]|1[0-2])$intervalo*string"mes""ano"atualizado_ate*|O último dia calculado. Se não for ontem, abra Investimentos no Meu Dinheiro para atualizar.
datemoeda*stringtotal*periodos*array<>grupos?array<>Só com detalhar.
curl -X GET "https://example.com/investimentos/analise"{ "inicio": "2026-08", "fim": "2026-08", "intervalo": "mes", "atualizado_ate": "2019-08-24", "moeda": "string", "total": { "saldo_inicial": 0, "saldo_final": 0, "aportes": 0, "retiradas": 0, "transferencias_entrada": 0, "transferencias_saida": 0, "proventos": 0, "movimentacao": 0, "variacao": 0, "rendimentos": 0, "resultado": 0, "total": 0, "ir": 0, "custos": 0, "apuracoes": 0, "rentabilidade": 0, "tir": 0 }, "periodos": [ { "periodo": "string", "variacao_percentual": 0, "saldo_inicial": 0, "saldo_final": 0, "aportes": 0, "retiradas": 0, "transferencias_entrada": 0, "transferencias_saida": 0, "proventos": 0, "movimentacao": 0, "variacao": 0, "rendimentos": 0, "resultado": 0, "total": 0, "ir": 0, "custos": 0, "apuracoes": 0 } ], "grupos": [ { "nome": "string", "rentabilidade": 0, "ativos": [ { "tipo": "ativo", "ativo_id": 0, "conta_id": 0, "codigo": "string", "nome": "string", "fracao_no_grupo": 0, "rentabilidade": 0, "saldo_inicial": 0, "saldo_final": 0, "aportes": 0, "retiradas": 0, "transferencias_entrada": 0, "transferencias_saida": 0, "proventos": 0, "movimentacao": 0, "variacao": 0, "rendimentos": 0, "resultado": 0, "total": 0, "ir": 0, "custos": 0, "apuracoes": 0 } ], "saldo_inicial": 0, "saldo_final": 0, "aportes": 0, "retiradas": 0, "transferencias_entrada": 0, "transferencias_saida": 0, "proventos": 0, "movimentacao": 0, "variacao": 0, "rendimentos": 0, "resultado": 0, "total": 0, "ir": 0, "custos": 0, "apuracoes": 0 } ]}