Cole no ChatGPT/Claude e peça para resumir/gerar SDK.

Obter fundo

GET

/traded-funds/{fundIdentifier}

Retorna informações detalhadas de um fundo listado específico (ex.: FII, ETF, Fiagro), incluindo identificadores, classificação e — opcionalmente — dados de mercado e assets para UI (logo/ícone).

Quando usar

Página de detalhe do fundo no app/site
Resolver a identidade do ativo (símbolo, ticker principal e tickers alternativos)
Enriquecer UI com logo/ícone e detalhes operacionais (site, endereço, administrador etc.)
Preparar integrações com módulos de proventos, indicadores e carteira do fundo

Identificador do fundo (`fundIdentifier`)

Você pode consultar um fundo usando um destes valores:

ticker (recomendado para uso em produto): ex. HGLG11
symbol (raiz do ativo): ex. HGLG
um valor existente em other_tickers (quando aplicável): ex. HGLG11T

Padrão 11 e tickers alternativos

Em fundos listados (especialmente FIIs e muitos Fiagros), o ticker costuma terminar em 11.
Em períodos de eventos como subscrições, podem existir tickers temporários (recibos/direitos) listados em other_tickers. Para “o ativo principal”, prefira o ticker padrão.

Parâmetros

Parâmetro	Local	Descrição	Obrigatório
`fundIdentifier`	URL	Identificador do fundo (ticker/symbol/other ticker).	Obrigatório
`show_market_cap`	Query	Boolean. Se `true`, retorna market cap e valor patrimonial quando disponíveis.	Opcional
`show_logo`	Query	Boolean. Se `true`, retorna logos e ícones do fundo quando disponíveis.	Opcional
`show_details`	Query	Boolean. Se `true`, retorna detalhes (website, endereço, datas e outros campos quando disponíveis).	Opcional

Boas práticas

Para telas rápidas, comece sem enriquecimentos e habilite show_logo e show_details apenas quando necessário.
Se você for exibir uma lista, use Listar fundos e só chame Obter fundo no clique do usuário.

Resposta

Código	Descrição
200	Retorna os dados do fundo.
400	Identificador inválido/parâmetros inválidos.
401	Não autorizado.
404	Fundo não encontrado.

Formato da resposta

A resposta é um objeto com os campos abaixo:

Campo	Tipo	Descrição
`type`	string	Tipo geral do ativo retornado.
`symbol`	string	Símbolo raiz do fundo.
`name`	string	Nome completo (razão) do fundo.
`trading_name`	string	Nome de negociação do fundo.
`company_id`	string	Identificador/CNPJ do fundo (quando aplicável).
`type`	string	Tipo do fundo (ex.: `FII`, `ETF`, `FIAGRO`).
`ticker`	string	Ticker principal de negociação.
`other_tickers`	array	Tickers alternativos/temporários relacionados.
`ipo_date`	string (`YYYY-MM-DD`)	Data de listagem (IPO) do fundo. Pode ser `null`.
`classification`	object ou null	Classificação do fundo: Tijolo, Papel ou Multiestratégia. Só no modelo atual dos informes. Ver Setorização.
`subclassification`	object ou null	Subclassificação dentro da classificação (ex.: Renda, Desenvolvimento). Só no modelo atual.
`sector`	object ou null	Segmento de atuação (ex.: Logística, Shopping Centers). Nos dois modelos.
`management_type`	object ou null	Tipo de gestão (ex.: Gestão Ativa). Nos dois modelos.
`mandate`	object ou null	Mandato. Só no modelo antigo dos informes, no lugar de `classification` e `subclassification`.
`website`	string	Website oficial do fundo/administrador.
`address`	string	Endereço principal retornado pela fonte.
`phone_number`	string	Telefone de contato.
`position_manager`	object	Administrador do fundo, conforme registro CVM. Pode ser `null`.
`position_manager.company_id`	string	CNPJ do administrador.
`position_manager.name`	string	Nome do administrador.
`managers`	array	Gestores do fundo, conforme registro CVM. Fundos co-geridos possuem mais de um item. Pode ser `null`.
`managers[].company_id`	string	CPF/CNPJ do gestor.
`managers[].name`	string	Nome do gestor.
`registrar.name`	string	Nome do escriturador conforme fonte.
`registrar.address`	string	Endereço do escriturador.
`registrar.phone_number`	string	Telefone do escriturador.
`registrar.email`	string	E-mail do escriturador.
`past_symbols`	array	Símbolos históricos do fundo.
`logo` / `icon`	Assets para UI (quando `show_logo=true`)

Exemplo

{
  "type": "FII",
  "symbol": "HGLG",
  "name": "PÁTRIA LOG - FUNDO DE INVESTIMENTO IMOBILIÁRIO - RESPONSABILIDADE LIMITADA",
  "trading_name": "FII HGLG PAX",
  "company_id": "11728688000147",
  "type": "FII",
  "ticker": "HGLG11",
  "other_tickers": ["HGLG11T"],
  "ipo_date": "2011-03-02",
  "classification": { "id": "MULTI_STRATEGY", "name": "Multiestratégia" },
  "subclassification": null,
  "sector": { "id": "MULTI_CATEGORY", "name": "Multicategoria" },
  "management_type": { "id": "ACTIVE", "name": "Gestão Ativa" },
  "website": "https://www.bancogenial.com/",
  "address": "PRAIA DE BOTAFOGO, 228 - SALA 907, RJ, RIO DE JANEIRO, BOTAFOGO - CEP: 22250040",
  "phone_number": "+552139233000",
  "position_manager": {
    "company_id": "45246410000155",
    "name": "BANCO GENIAL S.A."
  },
  "managers": [
    {
      "company_id": "12461756000117",
      "name": "PÁTRIA INVESTIMENTOS LTDA."
    }
  ],
  "registrar": {
    "name": "BANCO GENIAL S.A.",
    "address": "PRAIA DO BOTAFOGO, 228 - SALA 907 - CEP: 22250040 - RIO DE JANEIRO - RJ",
    "phone_number": "null",
    "email": "[email protected]"
  },
  "past_symbols": ["HGLG"],
  "logo": {
    "svg": "https://sa-east-1-public-cdn.partnr.ai/logos/HGLG.svg",
    "png_1024": "https://sa-east-1-public-cdn.partnr.ai/logos/HGLG_1024.png",
    "png_512": "https://sa-east-1-public-cdn.partnr.ai/logos/HGLG_512.png",
    "png_256": "https://sa-east-1-public-cdn.partnr.ai/logos/HGLG_256.png",
    "png_128": "https://sa-east-1-public-cdn.partnr.ai/logos/HGLG_128.png",
    "png_64": "https://sa-east-1-public-cdn.partnr.ai/logos/HGLG_64.png"
  },
  "icon": {
    "svg": "https://sa-east-1-public-cdn.partnr.ai/icons/HGLG.svg",
    "png_1024": "https://sa-east-1-public-cdn.partnr.ai/icons/HGLG_1024.png",
    "png_512": "https://sa-east-1-public-cdn.partnr.ai/icons/HGLG_512.png",
    "png_256": "https://sa-east-1-public-cdn.partnr.ai/icons/HGLG_256.png",
    "png_128": "https://sa-east-1-public-cdn.partnr.ai/icons/HGLG_128.png",
    "png_64": "https://sa-east-1-public-cdn.partnr.ai/icons/HGLG_64.png"
  }
}

Setorização

classification, subclassification, sector, management_type e mandate mostram como o próprio fundo se classifica no bloco Autorregulação dos informes que entrega à CVM (Informe Mensal e Informe Anual). Valem para FIIs e para os Fiagros que entregam o informe no formato de FII.

Cada campo vem como um objeto { "id", "name" }, no mesmo padrão dos setores de empresas:

id: código estável, em inglês e em UPPER_SNAKE_CASE. Use-o em filtros e regras.
name: nome completo em português, para exibir.

Integração

Novos valores podem ser incluídos quando a CVM ou o fundo passam a usar outro termo. Trate um id desconhecido sem quebrar a integração.

De onde vem o valor

A Partnr usa o informe mais recente do fundo que traz o bloco Autorregulação: entre o último Informe Mensal e o último Informe Anual, vale o de data de referência mais recente. Quando os dois têm a mesma data (o Informe Anual e o Informe Mensal do último mês do exercício), vale o publicado por último. Quando o fundo entrega um informe novo, os campos acompanham.

Modelo atual e modelo antigo

Em 2025, os informes trocaram o Mandato pela Classificação e pela Subclassificação. A resposta segue o modelo do informe mais recente do fundo:

Modelo do informe mais recente	Campos na resposta
Atual (Classificação e Subclassificação)	`classification`, `subclassification`, `sector`, `management_type`
Antigo (Mandato)	`mandate`, `sector`, `management_type`
Sem informe com o bloco (ETFs, FIDCs, FIPs e outros)	nenhum destes campos

mandate e classification nunca vêm juntos. Não há correspondência direta entre o mandato do modelo antigo e a classificação do atual, então a Partnr não converte um no outro.

Trecho da resposta de um fundo cujo informe mais recente é do modelo antigo:

{
  "mandate": { "id": "DEVELOPMENT_FOR_INCOME", "name": "Desenvolvimento para Renda" },
  "sector": { "id": "CORPORATE_OFFICES", "name": "Lajes Corporativas" },
  "management_type": { "id": "ACTIVE", "name": "Gestão Ativa" }
}

`classification`: Classificação (só modelo atual)

O tipo de ativo em que o fundo investe principalmente.

`id`	`name`	O que indica
`PHYSICAL_REAL_ESTATE`	Tijolo	Imóveis: lajes, galpões, shoppings, residenciais e outros.
`REAL_ESTATE_SECURITIES`	Papel	Títulos do mercado imobiliário, como CRIs e cotas de outros fundos.
`MULTI_STRATEGY`	Multiestratégia	Imóveis e títulos combinados.

`subclassification`: Subclassificação (só modelo atual)

Detalha a classificação, e os valores possíveis dependem dela. Multiestratégia não tem subclassificação: nesse caso o campo vem null.

`classification`	`id`	`name`
Tijolo	`INCOME`	Renda
Tijolo	`DEVELOPMENT`	Desenvolvimento
Tijolo	`HYBRID_REAL_ESTATE`	Híbrido
Papel	`CRI`	Certificados de Recebíveis Imobiliários
Papel	`CRI_HIGH_GRADE`	Certificados de Recebíveis Imobiliários High Grade
Papel	`FUND_OF_FUNDS`	Fundo de Fundos
Papel	`HYBRID_SECURITIES`	Híbrido

O Híbrido de Tijolo (imóveis para renda e em desenvolvimento) e o Híbrido de Papel (títulos de tipos diferentes) são categorias diferentes, com id diferentes.

`sector`: Segmento de atuação (modelo atual e antigo)

O segmento do mercado imobiliário em que o fundo atua.

`id`	`name`	Observação
`LOGISTICS`	Logística
`SHOPPING_MALLS`	Shopping Centers
`CORPORATE_OFFICES`	Lajes Corporativas	Inclui os fundos que informam Escritórios.
`RESIDENTIAL`	Residencial
`HOSPITALS`	Hospital
`HOTELS`	Hotel
`RETAIL`	Varejo
`EDUCATION`	Educacional
`MULTI_CATEGORY`	Multicategoria	Vários segmentos. Inclui o Híbrido do modelo antigo.
`OTHER`	Outros	Segmento fora desta lista, como energia ou agronegócio.
`SECURITIES`	Títulos e Valores Mobiliários	Só no modelo antigo.

`management_type`: Tipo de gestão (modelo atual e antigo)

`id`	`name`	Modelo
`ACTIVE`	Gestão Ativa	Atual e antigo
`DEFINED`	Gestão Definida	Atual
`PASSIVE`	Gestão Passiva	Antigo

`mandate`: Mandato (só modelo antigo)

Só aparece quando o informe mais recente do fundo é do modelo antigo, usado até 2025, em que o Mandato ocupava o lugar da Classificação e da Subclassificação.

`id`	`name`
`INCOME`	Renda
`HYBRID`	Híbrido
`SECURITIES`	Títulos e Valores Mobiliários
`DEVELOPMENT_FOR_INCOME`	Desenvolvimento para Renda
`DEVELOPMENT_FOR_SALE`	Desenvolvimento para Venda

Valores vazios

null: o informe não traz o valor, ou o valor significa ausência (como "Não possui subclassificação").
{ "id": null, "name": null }: o fundo informou um valor que a Partnr ainda não mapeou. A equipe de dados faz o mapeamento, e o campo passa a vir com id e name.

Quando usar​

Identificador do fundo (fundIdentifier)​

Parâmetros​

Resposta​

Formato da resposta​

Exemplo​

Setorização​

De onde vem o valor​

Modelo atual e modelo antigo​

classification: Classificação (só modelo atual)​

subclassification: Subclassificação (só modelo atual)​

sector: Segmento de atuação (modelo atual e antigo)​

management_type: Tipo de gestão (modelo atual e antigo)​

mandate: Mandato (só modelo antigo)​

Valores vazios​