A posição da carteira, por ativo e conta
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.
accessTokenAuthorizationBearer <token>Access token (mda_…) obtido em POST /auth/token. Vale 1 hora.
limit?integerItens por página.
1 <= value <= 500100cursor?stringO next_cursor da página anterior. Omita na primeira página.
contas?stringIds das contas de investimento, separados por vírgula. Sem o parâmetro, todas.
moeda?stringCódigo ISO 4217 em que os valores saem, convertidos. Sem o parâmetro, BRL.
estrategia?integerO id de uma estratégia (GET /investimentos/estrategias). Com ela, cada linha traz os grupos da estratégia em que entra.
grupo?integerO id de um grupo da estrategia; exige estrategia.
A posição.
application/json- response
data*array<>next_cursor*|Cursor da próxima página; nulo na última.
moeda*stringA moeda dos valores (ISO 4217).
atualizado_ate*|O último dia da série de rentabilidade; nulo se a carteira nunca foi processada. Se não for ontem, abra Investimentos no Meu Dinheiro para atualizar.
datecurl -X GET "https://example.com/investimentos/carteira"{ "data": [ { "tipo": "ativo", "ativo_id": 0, "conta_id": 0, "codigo": "string", "nome": "string", "tipo_ativo": "acao", "secao": "comprada", "quantidade": 0, "preco_medio": 0, "cotacao": { "valor": 0, "data": "2019-08-24" }, "valor_investido": 0, "valor_atual": 0, "resultado": 0, "variacao": 0, "participacao": 0, "grupos": [ { "grupo_id": 0, "nome": "string", "fracao": 0 } ] } ], "next_cursor": "string", "moeda": "string", "atualizado_ate": "2019-08-24"}Demonstração do Fluxo de Caixa (DFC) GET
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.
As estratégias de alocação da carteira GET
"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.