Composição teórica dos índices da B3¶
Resumo¶
Para cada um dos índices IBOV (Ibovespa B3), IBRX100 (IBrX 100), SMLL (Small Cap), IDIV (Dividendos), IFIX (Fundos Imobiliários) e IFIL (Fundos Imobiliários de Alta Liquidez), a B3 publica a carteira teórica vigente: a lista de ativos, o percentual de participação e a quantidade teórica de cada um. O dataset guarda uma fotografia dessa carteira a cada coleta. Serve para reconstituir os pesos de um índice e acompanhar mudanças de composição.
Ficha técnica¶
| Campo | Valor |
|---|---|
| Dataset | b3/indices_carteiras |
| Órgão | B3 S.A. - Brasil, Bolsa, Balcão |
| Página oficial | https://www.b3.com.br/pt_br/market-data-e-indices/indices/indices-amplos/indice-ibovespa-ibovespa-composicao-da-carteira.htm |
| Licença | Não informado pela fonte. Veja os Termos e Condições de Uso da B3: https://www.b3.com.br/pt_br/termos-de-uso-e-protecao-de-dados/termos-de-uso/ |
| Periodicidade | carteira vigente a cada consulta; a B3 revê as carteiras periodicamente (o Ibovespa, a cada quatro meses, segundo a metodologia) |
| Cobertura | 2026-11 a em-curso |
| Unidade (uma linha) | um ativo na carteira de um índice em uma data |
| Granularidade | espacial: nacional (bolsa); temporal: data da carteira |
| Formato bruto | JSON da resposta do serviço GetPortfolioDay (cabeçalho com data, redutor e quantidade teórica total; lista de resultados), números com ponto de milhar e vírgula decimal |
| Estado no lake | convertido |
| Partições | indice, ano, mes, dia |
| Chave | indice, data_carteira, ticker |
| Colunas | 10 |
| Unidades de medida | participacao_pct: % da carteira; participacao_acumulada_pct: % da carteira (sempre nula nas amostras); qtd_teorica: ações; redutor: não informada pela fonte; qtd_teorica_total: ações |
| Dados pessoais | nenhum |
| Eras | nenhuma |
| Revisado em | 2026-11-09 |
| Versão do fetcher | 0.4.1 |
Origem e coleta¶
- O fetcher consulta o serviço
GetPortfolioDaydo site de índices da B3, um índice por vez. O serviço só devolve a carteira vigente; o parâmetro de data é ignorado. O IBrX 100 se chamaIBXXna API; comIBRX100o serviço responde vazio. - No bruto, cada coleta é
indices_carteiras-<ÍNDICE>-<AAAA-MM-DD>.json, em que a data é a do dia da coleta. - Conferido em 2026-11-09 pela listagem do bruto: 18 arquivos, os seis índices em 2026-11-04, 2026-11-05 e 2026-11-06. Não há histórico anterior.
Conteúdo¶
- Unidade: um ativo na carteira de um índice. Contagens na carteira de 2026-11-06: IBOV 76 ativos, IBRX100 100, IDIV 51, IFIL 56, IFIX 94 e SMLL 103.
- A participação soma 100,000000 e a soma das quantidades teóricas é igual à quantidade teórica total do cabeçalho em todas as sete carteiras convertidas (conferido em 2026-11-09).
- O IBOV de 2026-11-04 e o de 2026-11-06 têm o mesmo número de ativos (76), o mesmo redutor e a mesma quantidade teórica total; os arquivos diferem na data do cabeçalho. Não verificamos peso a peso.
- Não há eras.
Variáveis¶
Não localizamos dicionário de dados desta resposta; as descrições abaixo vêm dos rótulos da própria resposta (por exemplo, "Quantidade Teórica Total" e "Redutor" no cabeçalho) e da conferência dos dados. O que a fonte não define está marcado como "não informado pela fonte". As colunas indice, ano, mes e dia são partições.
| Coluna no lake | Na fonte | Tipo | Descrição | Unidade / códigos | Período |
|---|---|---|---|---|---|
indice |
nome do arquivo | texto (partição) | Sigla do índice no lake | IBOV, IBRX100, SMLL, IDIV, IFIX, IFIL |
todo |
ano |
data do nome do arquivo | inteiro (partição) | Ano da coleta | ano de 4 dígitos | todo |
mes |
data do nome do arquivo | inteiro (partição) | Mês da coleta | 1 a 12 | todo |
dia |
data do nome do arquivo | inteiro (partição) | Dia da coleta | 1 a 31 | todo |
segmento |
segment |
texto | Segmento do ativo; não informado pela fonte | sempre nulo nas amostras | todo |
ticker |
cod |
texto | Código de negociação do ativo | como ABEV3 |
todo |
nome |
asset |
texto | Nome do ativo (nome resumido da empresa ou do fundo) | — | todo |
especie |
type |
texto | Espécie do ativo, com espaços de preenchimento da fonte | como ON NM, UNT N2, CI |
todo |
participacao_pct |
part |
decimal(12,6) | Percentual de participação do ativo na carteira (a soma é 100) | % | todo |
participacao_acumulada_pct |
partAcum |
decimal(12,6) | Participação acumulada; não informado pela fonte | sempre nula nas amostras | todo |
qtd_teorica |
theoricalQty |
inteiro | Quantidade teórica do ativo na carteira | ações (ponto de milhar na fonte) | todo |
data_carteira |
header.date |
data | Data da carteira, do cabeçalho da resposta (dd/mm/aa) |
— | todo |
redutor |
header.reductor |
decimal(28,8) | Redutor do índice, do cabeçalho; unidade não informada pela fonte | número decimal | todo |
qtd_teorica_total |
header.theoricalQty |
inteiro | Quantidade teórica total da carteira, do cabeçalho (rótulo "Quantidade Teórica Total") | ações | todo |
No lake¶
- Dataset
b3/indices_carteiras, particionado porindice,ano,mesedia, um Parquet por índice e coleta. - O JSON é lido de
resultse do cabeçalho; sem cabeçalho ou resultados, o arquivo falha. - Números em formato brasileiro viram decimal exato ou inteiro com conversão estrita. Percentuais com 6 casas, redutor com 8.
data_carteira,redutoreqtd_teorica_totalsão repetidos em todas as linhas da carteira.- O índice vem do nome do arquivo e precisa ser um dos seis conhecidos; a data da partição também vem do nome (a data da coleta), enquanto
data_carteiravem do conteúdo. - Esquema de referência (
indices_carteiras.schema.json): 10 colunas, de sete carteiras.
Cuidados de uso¶
- A data da partição é a da coleta. Use
data_carteiracomo data da carteira. Em todos os arquivos convertidos as duas coincidem, mas a B3 só devolve a carteira vigente, então coletar mais tarde não recupera carteiras antigas. - Sem histórico. O bruto conferido tem três dias; para uma série de composições é preciso acumular coletas.
- Duas colunas sempre nulas.
segmentoeparticipacao_acumulada_pctsão nulas nas 7 carteiras convertidas (2026-11-09). - Espaços na espécie.
especiemantém os espaços de preenchimento da fonte (ON NM); apliquestr.replace_all(r"\s+", " ")antes de agrupar. - Definições. Quantidade teórica, redutor e participação não têm definição na resposta; a metodologia de cada índice está no site da B3.
- Termos de uso. Veja os termos citados na licença.
Exemplos¶
Os dez maiores pesos do IBOV na carteira mais recente coletada:
import polars as pl
c = pl.scan_parquet("lake/b3/indices_carteiras/**/*.parquet", hive_partitioning=True)
ibov = c.filter(pl.col("indice") == "IBOV")
ultima = ibov.select(pl.col("data_carteira").max()).collect().item()
top10 = (
ibov.filter(pl.col("data_carteira") == ultima)
.sort("participacao_pct", descending=True)
.select("ticker", "nome", "participacao_pct")
.head(10)
.collect()
)
Referências¶
- Composição da carteira do Ibovespa (B3): https://www.b3.com.br/pt_br/market-data-e-indices/indices/indices-amplos/indice-ibovespa-ibovespa-composicao-da-carteira.htm
- Termos e Condições de Uso da B3: https://www.b3.com.br/pt_br/termos-de-uso-e-protecao-de-dados/termos-de-uso/