Pular para o conteúdo principal

Classificação de Ativos (Security Classification)

A Classificação de Ativos (Security Classification) organiza cada Ativo (Security) em uma árvore hierárquica de classes e subclasses com até 4 níveis. É ela que define, por exemplo, que uma ação está em "Renda Variável > Ações" e que um título público indexado à inflação está em "Renda Fixa > Indexado a Inflação > Título Público". Essa estrutura é a base das análises de alocação de um portfolio por classe de ativo e dos Perfis de Investimento.

Hierarquia de níveis​

Cada classificação pertence a um nível, de CLASSIFICATION_L0 (o mais amplo, como Renda Fixa, Renda Variável ou Multimercado) até CLASSIFICATION_L3 (o mais detalhado). Toda classificação abaixo do L0 aponta para a sua classificação pai por meio do parentId; no L0, o parentId é nulo. Um ativo é sempre enquadrado em uma estrutura com no mínimo 2 e no máximo 4 níveis, ou seja, para reclassificar um ativo é necessário informar (pelo menos) qual é o seu novo CLASSIFICATION_L0 e CLASSIFICATION_L1.

Nas visões de um portfólio, a hierarquia é cumulativa: um ativo classificado em "Renda Fixa > Indexado a Inflação" também compõe o total de "Renda Fixa".

Classificação oficial e reclassificação​

Por padrão, o Gorila classifica os ativos com uma metodologia proprietária que busca aderir a convenções e padrões de mercado e que também utiliza fontes oficiais, como B3 e Anbima. Essa classificação proprietária nem sempre reflete a lógica que cada instituição usa para avaliar os seus portfólios. Um fundo classificado pela Anbima como Multimercado, mas atrelado ao CDI, pode ser tratado como Renda Fixa por uma gestora, e isso muda a leitura do enquadramento da carteira ao perfil do investidor.

Para esses casos, a sua Organização (Organization) pode criar classificações personalizadas e reclassificar ativos:

  • Classes personalizadas podem ser criadas em qualquer nível, inclusive como subclasses de classes oficiais do Gorila. Para montar uma cadeia inteiramente personalizada, crie as classes em ordem, do L0 ao L3, usando o identificador da classe pai recém-criada em cada passo.
  • Reclassificar um ativo significa apontá-lo para uma classificação da sua organização. Cada ativo tem uma única classificação por vez, e os ativos que você não reclassificar continuam seguindo a classificação oficial.
  • Voltar ao padrão: ao remover a classificação personalizada de um ativo, ele retorna à classificação oficial do Gorila.

A reclassificação vale para todos os portfólios da sua organização. Nos portfólios conectados (compartilhados com a sua organização), você enxerga os ativos na classificação da sua organização, enquanto o dono do portfólio continua a vê-los na classificação oficial do Gorila, em sua conta pessoal.

Edição e exclusão​

Apenas classificações personalizadas podem ser renomeadas ou excluídas; as classificações oficiais do Gorila são fixas. Ao excluir uma classificação personalizada, todas as subclasses abaixo dela também são excluídas, e os ativos que estavam nelas retornam automaticamente à classificação oficial do Gorila.

Uso nas consultas​

As classificações também podem ser usadas para filtrar e agrupar as métricas de portfólios e grupos econômicos:

  • Considerar apenas uma classificação: a maioria dos endpoints de métricas aceita o filtro securityClassification, com o identificador de uma classificação.
  • Deixar classificações de fora: os endpoints de portfólios e grupos econômicos que aceitam securityClassification, exceto o List Position Dividend Yield, aceitam também o filtro excludeSecurityClassification, com um ou mais identificadores de classificação. Os ativos dessas classificações não entram no resultado.
  • Agrupar por nível: os detalhamentos por posição aceitam agrupar o resultado por nível de classificação (groupBy igual a CLASSIFICATION_L0, CLASSIFICATION_L1, CLASSIFICATION_L2 ou CLASSIFICATION_L3), como em List Position Market Values.

Os filtros securityClassification e excludeSecurityClassification usam a classificação de cada ativo na sua organização, com as reclassificações e as classificações personalizadas, e valem para a classificação informada e para todas as subclasses abaixo dela. Por isso, os dois podem ser combinados: com securityClassification=FIXED_INCOME e o identificador de uma subclasse de Renda Fixa em excludeSecurityClassification, o resultado traz toda a Renda Fixa, menos essa subclasse.

Para informar mais de um identificador em excludeSecurityClassification, repita o parâmetro ou separe os valores por vírgula. Por exemplo, para acompanhar o Valor Patrimonial (NAV) de um portfólio sem os ativos de Renda Variável e de Multimercado:

GET /portfolios/{portfolioId}/nav?frequency=DAILY&excludeSecurityClassification=VARIABLE_INCOME,MULTIMARKET

Um identificador que não existe não gera erro: ele apenas não deixa nada de fora. Os identificadores das classificações, oficiais e da sua organização, estão no List Securities Classifications.

Onde acessar​

No GorilaCORE, você pode listar as classificações disponíveis para a sua organização (com filtros por nível, classificação pai e nome), consultar uma classificação específica, criar, renomear e excluir classificações personalizadas. Para reclassificar um ativo, ou devolvê-lo à classificação oficial, use o endpoint de atualização de ativo informando o classificationId desejado (ou null).