Tesouro Direto (tesouro-direto)¶
O tesouro-direto-fetcher coleta oito conjuntos de dados abertos do Tesouro Direto, programa do Tesouro Nacional (STN/MF) para venda de títulos públicos a pessoas físicas, e os converte para o lake em Parquet. Os dados são publicados no portal Tesouro Transparente, em conjuntos mantidos pela Coordenação-Geral do Tesouro Direto (COTED) e pela CODIP.
| Dataset | O que é | Origem (conjunto no Tesouro Transparente) | Período | Página |
|---|---|---|---|---|
taxas-dos-titulos-ofertados-pelo-tesouro-direto |
Taxas e preços diários de compra e venda, por título e vencimento | taxas-dos-titulos-ofertados-pelo-tesouro-direto |
2004-12 em diante | taxas |
estoque-do-tesouro-direto |
Estoque mensal de títulos, em quantidade e valor | estoque-do-tesouro-direto |
2002-01 em diante | estoque |
vendas-do-tesouro-direto |
Vendas diárias por título e vencimento | vendas-do-tesouro-direto |
2002-01 em diante | vendas |
pagamento-de-cupom-de-juros-do-tesouro-direto |
Pagamentos de cupons de juros | resgates-do-tesouro-direto |
2005-06 em diante | cupom |
recompras-do-tesouro-direto |
Títulos devolvidos antes do vencimento | resgates-do-tesouro-direto |
2005-01 em diante | recompras |
vencimentos-do-tesouro-direto |
Títulos pagos no vencimento | resgates-do-tesouro-direto |
2005-01 em diante | vencimentos |
investidores-do-tesouro-direto |
Cadastro de investidores (microdados) | investidores-do-tesouro-direto |
adesões desde 2002 | investidores |
operacoes-do-tesouro-direto |
Operações dos investidores (microdados) | operacoes-do-tesouro-direto |
2014-01 em diante | operações |
Como o Tesouro Nacional publica¶
- Cada conjunto é um pacote do catálogo CKAN do Tesouro Transparente (
https://www.tesourotransparente.gov.br/ckan/), com recursos em CSV e um PDF de metadados com o dicionário das colunas. O fetcher baixa só os recursos em CSV. - Os arquivos de taxas, vendas e resgates são regerados todo dia, com a série inteira. Estoque, investidores e operações são mensais. Investidores e operações são divididos por ano (e, para investidores, um arquivo "até 2017").
- Cada arquivo vem com data de modificação, que o fetcher grava no nome do bruto (
<arquivo>@AAAAMMDDTHHMMSS.csv). Versões sucessivas convivem; o lake converte a mais recente de cada arquivo. - O catálogo declara a licença Open Data Commons Open Database License (ODbL) para os oito conjuntos.
Como os conjuntos se relacionam¶
- Vendas × operações. O volume de vendas de um ano é próximo à soma das operações de compra do investidor (
C) no mesmo ano. Em 2014, R$ 4,991 bilhões em vendas e R$ 4,993 bilhões em operaçõesC(conferido em 2026-11-10). Veja o cuidado sobreCeVna página de operações. - Recompras × operações. As recompras de 2014 (R$ 1,703 bilhão) ficam perto das operações
Vdo mesmo ano (R$ 1,689 bilhão). - Investidores × operações.
codigo_do_investidoré o mesmo nos dois. - Estoque. É um retrato mensal acumulado, pela taxa de emissão, e não é preço de mercado; as taxas e preços dos títulos ofertados são do mercado secundário.
Quebras que valem para mais de um conjunto¶
| Desde | Mudança | Afeta |
|---|---|---|
| 2023-01 | Entra o Tesouro RendA+ (data conferida nas taxas; os tipos RendA+ e EducA+ também aparecem em estoque, vendas e recompras) | taxas e demais |
| 2023-08 | Entra o Tesouro EducA+ (idem) | taxas e demais |
O nome do título nem sempre é o mesmo entre arquivos: o RendA+ aparece como Tesouro Renda+ Aposentadoria Extra no arquivo de taxas e como Tesouro RendA+ nos demais.
Todas as colunas chegam ao lake como texto, com datas DD/MM/AAAA e vírgula decimal; veja o cuidado de cada página.