Pular para o conteúdo principal
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, dados cadastrais e assets para UI (logo/ícone).

Quando usar​

  • Página de detalhe do fundo no app/site
  • Resolver a identidade do ativo (símbolo e tickers)
  • 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
  • CNPJ do fundo (company_id): ex. 11728688000147
Padrão 11

Em fundos listados (especialmente FIIs e muitos Fiagros), o ticker costuma terminar em 11.

Parâmetros​

ParâmetroLocalDescriçãoObrigatório
fundIdentifierURLIdentificador do fundo (ticker, symbol ou CNPJ).Obrigatório

A rota não tem parâmetros de query. A resposta sempre traz os dados cadastrais, o logo e o ícone.

Boas práticas
  • Se você for exibir uma lista, use Listar fundos e só chame Obter fundo no clique do usuário.

Resposta​

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

Formato da resposta​

A resposta é um objeto com os campos abaixo:

CampoTipoDescrição
symbolstringSímbolo raiz do fundo.
namestringNome completo (razão) do fundo.
trading_namestringNome de negociação do fundo.
company_idstringIdentificador/CNPJ do fundo (quando aplicável).
typestringTipo do fundo (ex.: FII, ETF, FIAGRO).
tickersarrayTickers que o fundo negocia hoje.
past_tickersarrayTickers que o fundo já usou e não usa mais.
total_unitsnumberNúmero de cotas mais recente.
total_unitholdersnumberNúmero de cotistas mais recente. Ausente quando o fundo não informa.
benchmark_indexobjectÍndice de referência do fundo (name e short_name, ex.: IBOV). Só em fundos de índice.
ipo_datestring (YYYY-MM-DD)Data de listagem (IPO) do fundo. Pode ser null.
classificationobjectClassificação do fundo: Tijolo, Papel ou Multiestratégia. Só no modelo atual dos informes. Ver Setorização.
subclassificationobjectSubclassificação dentro da classificação (ex.: Renda, Desenvolvimento). Só no modelo atual.
sectorobjectSegmento de atuação (ex.: Logística, Shopping Centers). Nos dois modelos.
management_typeobjectTipo de gestão (ex.: Gestão Ativa). Nos dois modelos.
mandateobjectMandato. Só no modelo antigo dos informes, no lugar de classification e subclassification.
segmentobjectNome antigo de classification, com o mesmo valor. Será removido em 01/01/2027; use classification.
websitestringWebsite oficial do fundo/administrador.
addressstringEndereço principal retornado pela fonte.
phone_numberstringTelefone de contato.
position_managerobjectAdministrador do fundo, conforme registro CVM. Pode ser null.
position_manager.company_idstringCNPJ do administrador.
position_manager.namestringNome do administrador.
managersarrayGestores do fundo, conforme registro CVM. Fundos co-geridos possuem mais de um item. Pode ser null.
managers[].company_idstringCPF/CNPJ do gestor.
managers[].namestringNome do gestor.
registrar.namestringNome do escriturador conforme fonte.
registrar.addressstringEndereço do escriturador.
registrar.phone_numberstringTelefone do escriturador.
registrar.emailstringE-mail do escriturador.
logo / iconobjectURLs de logo e ícone em SVG e PNG (1024, 512, 256, 128 e 64 px).

Exemplo​

{
"type": "FII",
"symbol": "HGLG",
"name": "PÁTRIA LOG - FUNDO DE INVESTIMENTO IMOBILIÁRIO - RESPONSABILIDADE LIMITADA",
"trading_name": "FII HGLG PAX",
"company_id": "11728688000147",
"tickers": ["HGLG11"],
"past_tickers": [],
"total_units": 46398492,
"total_unitholders": 633787,
"ipo_date": "2011-03-02",
"classification": { "id": "MULTI_STRATEGY", "name": "Multiestratégia" },
"subclassification": { "id": "NOT_REPORTED", "name": "" },
"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": "escrituracao@bancogenial.com"
},
"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 recenteCampos 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.

idnameO que indica
PHYSICAL_REAL_ESTATETijoloImóveis: lajes, galpões, shoppings, residenciais e outros.
REAL_ESTATE_SECURITIESPapelTítulos do mercado imobiliário, como CRIs e cotas de outros fundos.
MULTI_STRATEGYMultiestratégiaImó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 { "id": "NOT_REPORTED", "name": "" }.

classificationidname
TijoloINCOMERenda
TijoloDEVELOPMENTDesenvolvimento
TijoloHYBRID_REAL_ESTATEHíbrido
PapelCRICertificados de Recebíveis Imobiliários
PapelCRI_HIGH_GRADECertificados de Recebíveis Imobiliários High Grade
PapelFUND_OF_FUNDSFundo de Fundos
PapelHYBRID_SECURITIESHíbrido
MultiestratégiaNOT_REPORTED(em branco)

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.

idnameObservação
LOGISTICSLogística
SHOPPING_MALLSShopping Centers
CORPORATE_OFFICESLajes CorporativasInclui os fundos que informam Escritórios.
RESIDENTIALResidencial
HOSPITALSHospital
HOTELSHotel
RETAILVarejo
EDUCATIONEducacional
MULTI_CATEGORYMulticategoriaVários segmentos. Inclui o Híbrido do modelo antigo.
OTHEROutrosSegmento fora desta lista, como energia ou agronegócio.
SECURITIESTítulos e Valores MobiliáriosSó no modelo antigo.

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

idnameModelo
ACTIVEGestão AtivaAtual e antigo
DEFINEDGestão DefinidaAtual
PASSIVEGestão PassivaAntigo

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.

idname
INCOMERenda
HYBRIDHíbrido
SECURITIESTítulos e Valores Mobiliários
DEVELOPMENT_FOR_INCOMEDesenvolvimento para Renda
DEVELOPMENT_FOR_SALEDesenvolvimento para Venda

Valores vazios​

Todo campo do modelo do fundo vem sempre como objeto, nunca como null:

  • { "id": "NOT_REPORTED", "name": "" }: o fundo não informou o valor. O informe não traz o campo, ou traz um valor que 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.

Os campos do outro modelo não aparecem na resposta: um fundo do modelo atual não traz mandate, e um do modelo antigo não traz classification nem subclassification.