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ível | type | Definição | Exemplo (Itaú Unibanco) |
|---|---|---|---|
| 1. Setor | sector | Bloco da economia em que a companhia atua. Segue o padrão global. | Financeiro (FINANCIALS) |
| 2. Grupo setorial | industry_group | Conjunto de indústrias do setor que respondem aos mesmos fatores. Segue o padrão global. | Bancos (BANKS) |
| 3. Indústria | industry | Conjunto de sub-indústrias com atividades similares; indica o modelo de negócio. | Bancos (BANKS) |
| 4. Sub-indústria | sub_industry | Recorte 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 oidem filtros e integrações. Onameé o rótulo de exibição em português e pode ser ajustado. - O mesmo
idpode existir em mais de um nível. Por exemplo,BANKSé grupo setorial e indústria, eUTILITIESé 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.
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
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ódigo | Descrição |
|---|---|
| 200 | Retorna a árvore de setores. |
| 401 | Não autorizado. |
| Campo | Tipo | Descrição |
|---|---|---|
id | string | Identificador do setor. É o valor do parâmetro sector de GET /companies. |
name | string | Nome do setor em português. |
industry_groups | array | Grupos setoriais do setor, cada um com id, name e industries. |
industry_groups[].industries | array | Indústrias do grupo, cada uma com id, name e sub_industries. |
industry_groups[].industries[].sub_industries | array | Sub-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
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âmetro | Local | Descrição | Obrigatório |
|---|---|---|---|
[sectorIdentifier] | URL | id da classificação, como em GET /companies/sectors (ex.: FINANCIALS, BANKS, AEROSPACE_DEFENSE). | Obrigatório |
type | Query | Ní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ódigo | Descrição |
|---|---|
| 200 | Retorna a classificação e as suas empresas. |
| 400 | type inválido. |
| 404 | Não existe classificação com este id no nível de type. |
| 401 | Não autorizado. |
| Campo | Tipo | Descrição |
|---|---|---|
id | string | Identificador da classificação. |
name | string | Nome da classificação em português. |
companies | array | Empresas da classificação, em ordem de symbol. |
companies[].company_id | string | CNPJ (quando houver CNPJ brasileiro) ou código CVM. |
companies[].name | string | Razão social. |
companies[].trading_name | string | Nome de negociação. |
companies[].symbol | string | Símbolo raiz. |
companies[].tickers | array de string | Tickers negociados. |
companies[].description | string | Descrição da empresa. |
companies[].logo / companies[].icon | object | URLs de logo e ícone em SVG e PNG (1024, 512, 256, 128 e 64 px). |
companies[].market_cap | object | Valor 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_value | object | Enterprise 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" }
}
]
}