Renda fixa — arquivo de instrumentos (BVBG.028.02)¶

Leitura do bloco FxdIncmInf do arquivo de instrumentos do pregão (IN{aammdd}.zip), publicado em www.b3.com.br/pesquisapregao/download. Registra os instrumentos de renda fixa negociáveis registrados para a sessão.

Veja também: Visão geral da seção para a forma do reader, proveniência e path_raw · Arquivo consolidado para a visão de todos os tipos.

Descrição¶

InstrumentsFileFxdIncmReader baixa o mesmo IN{aammdd}.zip que os demais readers da família, mantém apenas os registros que carregam o bloco FxdIncmInf e mapeia a lista completa de campos desse bloco — 13 campos próprios, mais as colunas comuns a todo instrumento (data de referência, identificação e atributos comuns), totalizando 26 colunas de origem.

Na sessão reconciliada (IN260729), o bloco trouxe 424 registros.

O layout vem da taxonomia autoritativa da B3 (BVBG.028 para UP2DATA, aba BVBG.028 - Taxonomia) — a árvore completa de tags com cardinalidade e tipo XSD — conferida contra um arquivo IN real. Os nomes seguem a convenção da biblioteca: pascal_to_upper_snake da abreviação do tag.

Mudança incompatível na 0.3.0 — TP virou UNDRLYG_INSTRM_ID_TP

Até a 0.2.1 este reader publicava UndrlygInstrmId/OthrId/Tp/Prtry como TP, enquanto os outros quatro readers que mapeiam o mesmo campo o publicavam como UNDRLYG_INSTRM_ID_TP — um campo com dois nomes no mesmo arquivo, o que quebrava um UNION ALL sobre a família (#165). Migração: renomeie TP para UNDRLYG_INSTRM_ID_TP no seu consumo. O caminho de origem e os valores não mudaram — só o nome da coluna.

O contrato exige ALLCN_RND_LOT, ASST, ASST_DESC, DAYS_TO_STTLM, MKT_IDR_CD, MKT_NM, OTHR_ID, PMT_TP, PRIC_FCTR, RPT_DT, SCTY_CTGY_NM, SGMT_NM, TCKR_SYMB, TRADG_CCY, UNDRLYG_INSTRM_ID, UNDRLYG_INSTRM_ID_TP, UNDRLYG_INSTRM_ID_MKT_IDR_CD. Os campos [0..1] do bloco fluem como colunas tipadas sem serem obrigatórios, de modo que um pregão em que a B3 não preencha um campo opcional ainda é lido.

Tipagem	Colunas
`datetime.date`	`TRADG_END_DT`, `TRADG_START_DT`
`decimal.Decimal` exato	—

As demais colunas preservam o texto exato da fonte.

Colunas monetárias carregam a sua moeda numa coluna companheira (TRADG_CCY): no ISO-20022 a moeda de um valor é um atributo do elemento, e sem ela o número perderia a unidade.

Exemplos¶

Ler o bloco de um pregão¶

from datetime import date
from filings_b3.search_trading_session import InstrumentsFileFxdIncmReader

df = InstrumentsFileFxdIncmReader(date(2026, 7, 29)).read()
print(df.head())

date_ref é obrigatório — o endpoint é endereçado por data.

Manter o artefato bruto (camada bronze)¶

from pathlib import Path

df = InstrumentsFileFxdIncmReader(
    date(2026, 7, 29), path_raw=Path("/data/bronze/b3")
).read()

print(df[["source_key", "content_hash", "updated_at"]].iloc[0])

Consolidado ou por tipo?¶

Uma leitura consolidada (InstrumentsFileReader) traz todos os tipos sob o layout de 52 colunas publicado pela B3. Este reader traz um tipo com todos os campos que a B3 declara para ele — mais colunas, um tipo só. Os dois leem o mesmo download.