Tesouro Direto: taxas, preços e curva de juros
As taxas e os preços diários de cada título do Tesouro Direto, guardados como o Tesouro Nacional publica, sem recálculo. É a leitura pública de quanto o mercado cobra por prazo (a curva de juros dos títulos públicos), enquanto a B3 não divulga os juros futuros. A página é /tesouro; a rota JSON/CSV é /tesouro/taxas.
Por que fica na seção Macro
Todo número de companhia deste banco é recomputável do documento da CVM. A taxa de um título público no mercado
secundário não é: é um agregado apurado pelo Tesouro, que ninguém reconstrói de documento público. Aceita-se o
número da fonte oficial ou não se usa. Por isso mora em tabela própria (tesouro_taxa) e na seção Macro, com a
fonte e a licença escritas em cada página e em cada resposta.
A fonte e a licença
- Fonte: Tesouro Transparente (Secretaria do Tesouro Nacional), conjunto de dados abertos Taxas dos Títulos
Ofertados pelo Tesouro Direto, arquivo
PrecoTaxaTesouroDireto.csv. Endereço: https://www.tesourotransparente.gov.br/ckan/dataset/df56aa42-484a-4a59-8184-7676580c81e3. - Licença: o portal declara no metadado do conjunto a ODbL 1.0 (Open Data Commons Open Database License), conferida em 31/10/2026. É a mesma do Banco Central e da CVM: uso livre, inclusive comercial, citando o Tesouro Nacional como fonte e compartilhando a base derivada nos mesmos termos.
- Cobertura: o arquivo público começa em 31/12/2004 e vai até o último dia útil. Não há dado anterior a isso no arquivo.
O que cada coluna é
| Coluna da fonte | O que guardamos |
|---|---|
| Tipo Titulo | o nome do título (Tesouro Selic, Prefixado, IPCA+, ...) |
| Data Vencimento | o vencimento |
| Data Base | o dia a que a taxa se refere |
| Taxa Compra Manha / Taxa Venda Manha | as taxas indicativas da manhã, % ao ano |
| PU Compra Manha / PU Venda Manha / PU Base Manha | os preços unitários, em reais |
Compra e venda são os rótulos da fonte, do ponto de vista do investidor: a compra é a ponta em que ele compra do Tesouro (taxa menor, preço maior); a venda, a ponta em que vende de volta.
Como ler a taxa de cada título
- Prefixado: taxa nominal ao ano, fixa até o vencimento.
- IPCA+, Renda+ e Educa+: taxa real, acima do IPCA.
- Selic: o ágio ou deságio sobre a Selic, por isso perto de zero.
- Taxa nominal e taxa real não se comparam diretamente. Por isso a página tem dois gráficos de curva, um para os prefixados e outro para os IPCA+, e não um só.
O gráfico da curva
SVG gerado no servidor (o site não executa script no navegador). Cada ponto é um vencimento: o eixo horizontal é o prazo em anos do dia-base até o vencimento (dias corridos divididos por 365,25 — a única conta nossa na página) e o eixo vertical é a taxa de compra da fonte. Renda+ e Educa+ (vencimentos de 2030 a 2084) e o Tesouro Selic ficam só na tabela.
Como a coleta funciona
- Toda semana, na reconstrução da base, o arquivo é baixado inteiro (uma requisição, com o robô identificado).
- Toda noite, o mesmo arquivo, mas só os últimos 45 dias são gravados.
- Falha isolada. Fonte fora do ar, cabeçalho diferente do conferido ou número fora da faixa plausível: o lote não é gravado e o histórico fica como estava. Nada é apagado; a reconstrução do zero herda do banco anterior o que a fonte não trouxe.
- Faixa plausível: taxa entre -10% e 60% ao ano; preço entre R$ 0 e R$ 100 mil. Fora disso é leitura errada (vírgula trocada, coluna deslocada), e o lote inteiro é recusado.
- No /saude, o bloco
tesouromostra o último dia-base, quantos dias se passaram e o resultado da última coleta (alarme depois de 7 dias).
O que a página NÃO faz
- Não recomenda título, prazo nem momento. É o número da fonte, a definição de cada título e nada mais.
- Não tem a taxa de fechamento nem do mercado intradiário: o arquivo traz as taxas indicativas da manhã.
- Não substitui os juros futuros (DI) da B3, que têm outra natureza; é o que o público consegue conferir hoje.
Acesso
- /tesouro — a página, aberta, em português e inglês.
/tesouro/taxas— JSON (ou?formato=csv). Sem parâmetro: todos os títulos no dia-base mais recente.titulo(selic, prefixado, prefixado-juros, ipca, ipca-juros, renda-mais, educa-mais, igpm-juros) filtra a família;data=AAAA-MM-DDpede outro dia-base;titulo+vencimento=AAAA-MM-DDdevolve a série diária de um título, recortada pordeeate. Aberta, sem chave. Toda resposta traz afonte, a licença e acitacao.- Ferramenta do conector MCP:
tesouro_direto.