Pagamento de cupom de juros do Tesouro Direto¶
Resumo¶
Pagamentos semestrais de juros (cupons) dos títulos do Tesouro Direto que os preveem, por título, vencimento e data.
Os três arquivos de resgates (cupom, recompras e vencimentos) vêm do mesmo conjunto da fonte e são datasets separados no lake.
Ficha técnica¶
| Campo | Valor |
|---|---|
| Dataset | tesouro-direto/pagamento-de-cupom-de-juros-do-tesouro-direto |
| Órgão | Tesouro Nacional (STN/MF), Coordenação-Geral do Tesouro Direto (COTED), via Tesouro Transparente |
| Página oficial | https://www.tesourotransparente.gov.br/ckan/dataset/resgates-do-tesouro-direto |
| Licença | Licença Aberta para Bases de Dados (ODbL) do Open Data Commons, declarada no catálogo do Tesouro Transparente: http://www.opendefinition.org/licenses/odc-odbl |
| Periodicidade | diária, com dados até dois dias antes da extração |
| Cobertura | 2005-06 a em-curso |
| Unidade (uma linha) | resgate de um título (tipo e vencimento) em uma data |
| Granularidade | espacial: Brasil; temporal: dia |
| Formato bruto | CSV em UTF-8, separador ponto e vírgula, decimal com vírgula, datas DD/MM/AAAA; um arquivo com toda a série |
| Estado no lake | convertido |
| Partições | — |
| Chave | tipo_titulo, vencimento_do_titulo, data_resgate |
| Colunas | 6 |
| Unidades de medida | pu: R$ por título; quantidade: títulos; valor: R$ |
| Dados pessoais | nenhum |
| Eras | nenhuma |
| Revisado em | 2026-11-10 |
| Versão do fetcher | 5.0.0 |
Origem e coleta¶
- O fetcher consulta o catálogo CKAN do Tesouro Transparente (conjunto
resgates-do-tesouro-direto), que reúne três recursos CSV: pagamento de cupom de juros, recompras e vencimentos. O bruto fica na pastaresgates-do-tesouro-direto/com os nomespagamento-de-cupom-de-juros-do-tesouro-direto@…,recompras-do-tesouro-direto@…evencimentos-do-tesouro-direto@…; o conversor separa os três pelo nome do arquivo e grava um dataset para cada. - A fonte atualiza os arquivos todo dia, com dados até dois dias antes da extração, a partir do SID. No bruto, o carimbo
@AAAAMMDDTHHMMSSé a data de modificação do recurso; o lake converte a versão mais recente. O bruto tinha 9 versões do cupom e 27 de recompras e de vencimentos em 2026-11-10.
Conteúdo¶
- Uma linha por tipo de título, vencimento e data do resgate.
- Cobertura real (versão
@20261109, conferido em 2026-11-10): 123 datas de 2005-06-01 a 2026-08-17, vencimentos de 2005-07 a 2060-08; 439 linhas, sem repetição da chave (0 repetições na amostra). - A fonte anuncia: início do pagamento de cupom em 02/07/2012, recompras em 06/01/2005 e vencimentos em 15/08/2012 (metadados do conjunto). Os dados reais do arquivo de cupons começam em 2005-06-01, antes do início declarado.
Variáveis¶
| Coluna no lake | Na fonte | Tipo | Descrição | Unidade / códigos | Período |
|---|---|---|---|---|---|
tipo_titulo |
Tipo Titulo | texto | Nome do tipo de título | Selic, Prefixado, Prefixado com Juros Semestrais, IPCA+, IPCA+ com Juros Semestrais, IGPM+ com Juros Semestrais, EducA+ e outros | todo |
vencimento_do_titulo |
Vencimento do Titulo | texto | Data de vencimento do título | DD/MM/AAAA | todo |
data_resgate |
Data Resgate | texto | Data do pagamento do cupom (nome da coluna na fonte: Data Resgate; a descrição da fonte chama a coluna de Data Venda) | DD/MM/AAAA | todo |
pu |
PU | texto | Preço unitário do cupom; Valor dividido por Quantidade pode diferir por truncamento | R$, vírgula decimal | todo |
quantidade |
Quantidade | texto | Quantidade de títulos do resgate | títulos, vírgula decimal | todo |
valor |
Valor | texto | Volume financeiro do resgate: PU multiplicado pela quantidade | R$, vírgula decimal | todo |
No lake¶
- Dataset
tesouro-direto/pagamento-de-cupom-de-juros-do-tesouro-direto, sem partição. - Chave natural (amostra de 2026-11-10):
tipo_titulo,vencimento_do_titulo,data_resgate, sem repetição. - Todas as colunas são texto; só o cabeçalho é normalizado. Sem nulos na amostra.
Cuidados de uso¶
- Tudo é texto. O conversor não converte tipos: datas continuam
DD/MM/AAAA, números usam vírgula decimal (18168,832736). Converta antes de ordenar ou somar; ordenar as datas como texto não segue o calendário (conferido em 2026-11-10: o menor texto devencimento_do_titulodo estoque é01/01/2006, o maior é21/01/2004). - Só títulos com juros semestrais. Aparecem três tipos (IPCA+ com Juros Semestrais, Prefixado com Juros Semestrais, IGPM+ com Juros Semestrais).
- Início diferente do declarado. Os metadados indicam o primeiro cupom em 2012-07-02; o arquivo tem registros desde 2005-06-01 (conferido em 2026-11-10).
- Amostra pequena. São 439 linhas; cuidado com leitura de séries.
- Revisões. O Tesouro Nacional informa que os valores podem ser revistos por alteração da base primária, estornos ou erros de consolidação. O lake guarda só a versão mais recente de cada arquivo.
Exemplos¶
Valor pago em cupons por ano (R$ milhões):
import polars as pl
cupons = pl.scan_parquet("lake/tesouro-direto/pagamento-de-cupom-de-juros-do-tesouro-direto/*.parquet")
por_ano = (
cupons.with_columns(
pl.col("data_resgate").str.to_date("%d/%m/%Y").dt.year().alias("ano"),
pl.col("valor").str.replace(",", ".").cast(pl.Float64).alias("valor_rs"),
)
.group_by("ano")
.agg((pl.col("valor_rs").sum() / 1e6).alias("milhoes"))
.sort("ano")
.collect()
)
Referências¶
- Conjunto no Tesouro Transparente: https://www.tesourotransparente.gov.br/ckan/dataset/resgates-do-tesouro-direto
- Metadados em PDF: https://www.tesourotransparente.gov.br/ckan/dataset/f30db6e4-6123-416c-b094-be8dfc823601/resource/445e38cf-b3b3-4e08-879a-2724febcd861/download/resgatesdotesourodireto-metadados.pdf