Pular para o conteúdo principal

Perfil de Investimento (Investment Profile)

Um Perfil de Investimento (Investment Profile) é uma alocação-alvo definida no escopo da Organização para servir de referência ou portfólio modelo aos seus portfólios. Cada perfil tem um nome único e distribui 100% do portfólio entre classificações de ativos. Ele é a base do enquadramento, que compara a alocação real de um Portfólio com a alocação definida no perfil.

Escritórios de investimento costumam atender clientes com tolerâncias a risco diferentes. Em vez de acompanhar cada portfólio isoladamente, eles criam alguns perfis, como "Conservador" ou "Arrojado", e associam cada cliente a um deles. Assim, o escritório mantém um padrão de investimento que segue as suas diretrizes e, ao mesmo tempo, respeita as diferenças entre os clientes.

Composição do perfil​

Um perfil é formado por uma lista de classificações de ativos (classifications), cada uma com a sua porcentagem-alvo. As porcentagens são informadas em formato decimal (0.65 = 65%), são sempre relativas ao total do portfólio e precisam somar exatamente 1 (100% do portfólio). Cada perfil aceita no máximo 100 classificações. O identificador de uma classificação pode ser um símbolo, como VARIABLE_INCOME_STOCKS, ou o UUID de uma classificação criada pela própria organização.

As classificações de um perfil não podem estar na mesma vertical hierárquica. Ao definir, por exemplo, 25% para "Renda Variável", nem os níveis acima nem os níveis abaixo dela podem entrar no mesmo perfil. Por isso, quem quer detalhar uma parte da carteira precisa distribuir a porcentagem entre todos os níveis irmãos daquela parte.

//REQUEST
//POST https://core.gorila.com.br/investment-profiles

{
  "name": "Conservador",
  "thresholdLimits": [5, 15],
  "classifications": [
    { "id": "FIXED_INCOME", "percentage": 0.8 },
    { "id": "VARIABLE_INCOME", "percentage": 0.2 }
  ]
}

Nesse exemplo, o perfil usa apenas classificações do primeiro nível (Renda Fixa e Renda Variável). Os identificadores das classificações disponíveis podem ser consultados em List Securities Classifications.

Enquadramento do portfólio​

Pense no Perfil de Investimento como uma meta ideal: ele diz exatamente qual porcentagem da carteira deveria estar em cada classificação (ex.: 20% em Renda Fixa, 15% em Ações etc.).

No dia a dia, com a oscilação dos preços e novos aportes, as porcentagens reais da carteira mudam. O Índice de Desenquadramento mede simplesmente: "Quanto do dinheiro dessa carteira precisaria trocar de lugar para voltar a ficar 100% igual à meta?"

Como funciona o cálculo​

  1. Calculamos a diferença de cada classificação: Comparamos a porcentagem real com a porcentagem planejada. Se uma classificação tem alocação excessiva ou insuficiente, calculamos essa distância.

  2. Ignoramos o sinal (valores em módulo): Não importa se está 5% "acima" ou 5% "abaixo"; em ambos os casos, a carteira desviou 5% do alvo.

  3. Somamos todos os desvios e dividimos por 2: Em uma carteira que sempre soma 100%, para você ter R$ 5 a mais em Ações, obrigatoriamente você teve que deixar R$ 5 a menos em outra coisa (como Renda Fixa). Se somássemos direto, contaríamos o mesmo dinheiro fora do lugar duas vezes (na sobra e na falta). Dividir por 2 nos dá a porcentagem real da carteira que precisa ser movimentada.

Iˊndice de Desenquadramento=∑∣Alocac¸a˜o Real−Alocac¸a˜o Ideal∣2\text{Índice de Desenquadramento} = \frac{\sum |\text{Alocação Real} - \text{Alocação Ideal}|}{2}

Exemplo prático​

Imagine um perfil com a meta ideal comparado com a carteira real do cliente:

Classe de AtivoMeta no PerfilCarteira AtualDiferençaDesvio Absoluto
Renda Fixa - Indexado a Juros20%18%-2,0%2,0%
Renda Fixa - Indexado a Inflação20%25%+5,0%5,0%
Ações15%15%0,0%0,0%
Fundos Multimercado15%8%-7,0%7,0%
Fundos Imobiliários10%11,5%+1,5%1,5%
Fundos de Investimento10%6,5%-3,5%3,5%
Ações Internacionais5%6%+1,0%1,0%
Ouro5%3%-2,0%2,0%
Outros (alocações em outras classificações)0%7%+7,0%7,0%
Total100%100%—Soma dos desvios: 29,0%

Fazendo a conta final: 29,0%2=14,5%\frac{29,0\%}{2} = \mathbf{14,5\%}

Isso significa que 14,5% do patrimônio total dessa carteira precisa ser rebalanceado para que ela volte a ficar 100% enquadrada.

Obs.: Na API, o campo differential de cada classificação traz essa diferença com o sinal invertido (meta − atual): valores positivos indicam alocação abaixo da meta, e valores negativos indicam alocação acima da meta.

Faixas de enquadramento​

Além da composição, o perfil define as faixas de enquadramento (thresholdLimits), que indicam quanta diferença em relação ao perfil ainda é aceitável. São dois valores percentuais, entre 0 e 100: o menor marca o limite de "enquadrado" e o maior, o de "desenquadrado". Entre os dois, o portfólio é considerado "parcialmente enquadrado". O campo é opcional e, quando omitido, o GorilaCORE usa as faixas padrão [5, 15].

Com base no percentual final encontrado no cálculo do desenquadramento, a carteira recebe um status de conformidade. Com as faixas padrão:

  • 🟢 Enquadrado: desvio de até 5% (a carteira está praticamente no alvo).
  • 🟡 Parcialmente Enquadrado: desvio entre 5% e 15% (a carteira requer atenção e pequenos ajustes).
  • 🔴 Desenquadrado: desvio maior que 15% (a carteira se distanciou bastante do perfil e precisa de rebalanceamento).

No exemplo acima, com 14,5%, o portfólio é classificado como 🟡 Parcialmente Enquadrado.

Associação a portfólios​

Os perfis são gerenciados de forma independente dos portfólios: você pode criar e editar um perfil sem associá-lo a nenhum portfólio. Cada portfólio pode estar associado a, no máximo, um perfil. A associação é feita pelo campo investmentProfileId na atualização do portfólio, e enviar null remove o perfil associado. Ao excluir um perfil, todos os portfólios associados a ele ficam automaticamente sem perfil.

Com um perfil associado, você pode consultar o enquadramento do portfólio, que retorna, para cada classificação do perfil, a alocação-alvo (target), a alocação real (allocation) e a diferença entre elas (differential), além das faixas de enquadramento do perfil. Quando a data de referência (referenceDate) não é informada, a data de hoje é usada. Também é possível filtrar a alocação das posições pelas posições dentro (IN) ou fora (OUT) do perfil, usando o parâmetro investmentProfileRelation.

Onde acessar​

No GorilaCORE, você pode criar, listar, consultar, atualizar e excluir perfis de investimento. A listagem não traz as classificações de cada perfil; para vê-las, consulte o perfil pelo seu ID. Na atualização, ao enviar classifications, o conjunto inteiro de classificações do perfil é substituído.