Pular para o conteúdo principal
Cole no ChatGPT/Claude e peça para resumir/gerar SDK.

Setores

A Partnr classifica as companhias listadas na B3 com uma metodologia própria, baseada na estrutura de quatro níveis do GICS (Global Industry Classification Standard) e adaptada ao mercado brasileiro. A taxonomia tem 11 setores, 24 grupos setoriais, 56 indústrias e 99 sub-indústrias. Os critérios de classificação estão em Setorização (metodologia própria).

Cada companhia tem uma classificação em cada um dos quatro níveis, e cada nível detalha o nível acima:

NíveltypeDefiniçãoExemplo (Itaú Unibanco)
1. SetorsectorBloco da economia em que a companhia atua. Segue o padrão global.Financeiro (FINANCIALS)
2. Grupo setorialindustry_groupConjunto de indústrias do setor que respondem aos mesmos fatores. Segue o padrão global.Bancos (BANKS)
3. IndústriaindustryConjunto de sub-indústrias com atividades similares; indica o modelo de negócio.Bancos (BANKS)
4. Sub-indústriasub_industryRecorte operacional que define o negócio principal. É o nível para escolher pares comparáveis.Bancos Diversificados (DIVERSIFIED_BANKS)

Regras que valem para as duas rotas:

  • A classificação nasce na sub-indústria. A companhia recebe a sub-indústria do segmento com a maior receita líquida, e os três níveis acima são os ancestrais dessa sub-indústria. Os quatro níveis de uma companhia são sempre coerentes entre si.
  • O id é estável. Use o id em filtros e integrações. O name é o rótulo de exibição em português e pode ser ajustado.
  • O mesmo id pode existir em mais de um nível. Por exemplo, BANKS é grupo setorial e indústria, e UTILITIES é setor e grupo setorial.
  • A ordem é fixa. As rotas de empresas devolvem os quatro níveis sempre na ordem setor, grupo setorial, indústria, sub-indústria.
Relação com o GICS

A taxonomia é adaptada a partir da arquitetura do GICS, mas não é o GICS e não é endossada pela MSCI ou pela S&P Dow Jones Indices. Os níveis de setor e grupo setorial são compatíveis com o padrão global; indústria e sub-indústria têm adaptações ao mercado brasileiro.

Listar setores​

GET
/companies/sectors

Retorna todos os setores. Cada setor traz os seus grupos setoriais, cada grupo traz as suas indústrias e cada indústria traz as suas sub-indústrias. Todos os níveis vêm em ordem de id.

Resposta​

CódigoDescrição
200Retorna a árvore de setores.
401Não autorizado.
CampoTipoDescrição
idstringIdentificador do setor. É o valor do parâmetro sector de GET /companies.
namestringNome do setor em português.
industry_groupsarrayGrupos setoriais do setor, cada um com id, name e industries.
industry_groups[].industriesarrayIndústrias do grupo, cada uma com id, name e sub_industries.
industry_groups[].industries[].sub_industriesarraySub-indústrias da indústria, cada uma com id e name.

Exemplo (trecho)​

[
{
"id": "UTILITIES",
"name": "Serviços de Utilidade Pública",
"industry_groups": [
{
"id": "UTILITIES",
"name": "Serviços de Utilidade Pública",
"industries": [
{
"id": "ELECTRIC_UTILITIES",
"name": "Energia Elétrica",
"sub_industries": [
{ "id": "ELECTRIC_UTILITIES", "name": "Energia Elétrica" }
]
},
{
"id": "GAS_UTILITIES",
"name": "Distribuição de Gás",
"sub_industries": [
{ "id": "GAS_UTILITIES", "name": "Distribuição de Gás" }
]
}
]
}
]
}
]

Consultar setor​

GET
/companies/sectors/[sectorIdentifier]

Retorna uma classificação de qualquer nível e as empresas que a compõem. As empresas são as mesmas de GET /companies: têm symbol, não são BDR e têm pelo menos um ticker. Companhias deslistadas mantêm a sua classificação, mas não aparecem nesta lista. Por isso, as sub-indústrias MARINE_PORT_SERVICES e CONTAINERS_PACKAGING, que só têm companhias deslistadas, devolvem companies vazio.

Parâmetros de requisição​

ParâmetroLocalDescriçãoObrigatório
[sectorIdentifier]URLid da classificação, como em GET /companies/sectors (ex.: FINANCIALS, BANKS, AEROSPACE_DEFENSE).Obrigatório
typeQueryNível do id: sector, industry_group, industry ou sub_industry. Padrão: sector. O mesmo id pode existir em mais de um nível (ex.: BANKS é grupo setorial e indústria).Opcional

Resposta​

CódigoDescrição
200Retorna a classificação e as suas empresas.
400type inválido.
404Não existe classificação com este id no nível de type.
401Não autorizado.
CampoTipoDescrição
idstringIdentificador da classificação.
namestringNome da classificação em português.
companiesarrayEmpresas da classificação, em ordem de symbol.
companies[].company_idstringCNPJ (quando houver CNPJ brasileiro) ou código CVM.
companies[].namestringRazão social.
companies[].trading_namestringNome de negociação.
companies[].symbolstringSímbolo raiz.
companies[].tickersarray de stringTickers negociados.
companies[].descriptionstringDescrição da empresa.
companies[].logo / companies[].iconobjectURLs de logo e ícone em SVG e PNG (1024, 512, 256, 128 e 64 px).
companies[].market_capobjectValor de mercado mais recente (value, format, date). date é o dia do pregão do valor. Presente quando o plano inclui indicadores de preço e a empresa tem valor publicado.
companies[].enterprise_valueobjectEnterprise value mais recente (value, format, date). Mesmas condições de market_cap.

Exemplo​

GET /companies/sectors/AEROSPACE_DEFENSE?type=sub_industry

{
"id": "AEROSPACE_DEFENSE",
"name": "Aeroespacial e Defesa",
"companies": [
{
"company_id": "07689002000189",
"name": "EMBRAER S.A.",
"trading_name": "EMBRAER",
"symbol": "EMBJ",
"tickers": ["EMBJ3"],
"description": "A Embraer projeta, desenvolve, fabrica e vende aeronaves e sistemas, e também gera receita com serviços de suporte e pós-venda...",
"logo": {
"svg": "https://sa-east-1-public-cdn.partnr.ai/logos/EMBJ.svg",
"png_1024": "https://sa-east-1-public-cdn.partnr.ai/logos/EMBJ_1024.png",
"png_512": "https://sa-east-1-public-cdn.partnr.ai/logos/EMBJ_512.png",
"png_256": "https://sa-east-1-public-cdn.partnr.ai/logos/EMBJ_256.png",
"png_128": "https://sa-east-1-public-cdn.partnr.ai/logos/EMBJ_128.png",
"png_64": "https://sa-east-1-public-cdn.partnr.ai/logos/EMBJ_64.png"
},
"icon": {
"svg": "https://sa-east-1-public-cdn.partnr.ai/icons/EMBJ.svg",
"png_1024": "https://sa-east-1-public-cdn.partnr.ai/icons/EMBJ_1024.png",
"png_512": "https://sa-east-1-public-cdn.partnr.ai/icons/EMBJ_512.png",
"png_256": "https://sa-east-1-public-cdn.partnr.ai/icons/EMBJ_256.png",
"png_128": "https://sa-east-1-public-cdn.partnr.ai/icons/EMBJ_128.png",
"png_64": "https://sa-east-1-public-cdn.partnr.ai/icons/EMBJ_64.png"
},
"market_cap": { "value": 82976512830.64, "format": "BRL", "date": "2026-11-13" },
"enterprise_value": { "value": 89103639830.64, "format": "BRL", "date": "2026-11-13" }
},
{
"company_id": "92781335000102",
"name": "TAURUS ARMAS S.A.",
"trading_name": "TAURUS ARMAS",
"symbol": "TASA",
"tickers": ["TASA4", "TASA3"],
"description": "Taurus Armas fabrica e vende armas leves — como revólveres, pistolas e armas táticas...",
"logo": { "svg": "https://sa-east-1-public-cdn.partnr.ai/logos/TASA.svg", "...": "..." },
"icon": { "svg": "https://sa-east-1-public-cdn.partnr.ai/icons/TASA.svg", "...": "..." },
"market_cap": { "value": 690921656.95, "format": "BRL", "date": "2026-11-13" },
"enterprise_value": { "value": 1364556656.95, "format": "BRL", "date": "2026-11-13" }
}
]
}