Análise do `bot-tesouro-direto` — o que extraímos
estrategia/TESOURO-BOT-REFERENCIA.md
title: REFERÊNCIA — Bot Tesouro Direto (ghostnetrn) — análise
criado: 2026-09-17
status: 🔍 ANALISADO — ideias extraídas, com correções
origem: https://github.com/ghostnetrn/bot-tesouro-direto
Análise do bot-tesouro-direto — o que extraímos
Repositório de terceiro (Node.js), lido e não executado. Copiado para
inspeção em/tmp/bot-tesouro-direto(fora do projeto).
Nada do código dele foi rodado.
1. O que o sistema é
| Componente | O que faz |
|---|---|
| Coleta | Baixa o CSV oficial do Tesouro Transparente + scraping do Investidor10 |
| Análise | Quartis estatísticos sobre o histórico da taxa de compra de cada título |
| Bot Telegram | Consultas + alertas automáticos por limiar de rentabilidade |
| Web | Dashboard com 3 abas: Investir · Resgatar · Comparação |
| Deploy | Docker / docker-compose |
A estratégia (quartis)
Para cada título, classifica a taxa atual contra o histórico:
| Faixa | Classificação |
|---|---|
| mínimo → Q1 | 😡 COMPRA PÉSSIMA |
| Q1 → mediana | 😒 COMPRA RUIM |
| mediana → Q3 | 😗 COMPRA BOA |
| Q3 → máximo | 😀 COMPRA ÓTIMA |
Premissa: taxa perto do máximo histórico = bom momento para comprar.
E a ideia de resgate (spread)
Spread = Taxa Compra − Taxa Venda → mede o custo real de liquidez.
Spread muito negativo = "considere resgatar".
2. 🏆 O ACHADO MAIS VALIOSO: a fonte de dados oficial
URL (verificada hoje, HTTP 200 ✅):
https://www.tesourotransparente.gov.br/ckan/dataset/df56aa42-484a-4a59-8184-7676580c81e3/resource/796d2059-14e9-44e3-80c9-2d9e30b405c1/download/PrecoTaxaTesouroDireto.csv
O que tem dentro (medido):
- 176.274 linhas, de 31/12/2004 até 16/09/2026 (dado diário!)
- 58 títulos com cotação em set/2026
- Colunas: `Tipo Titulo · Data Vencimento · Data Base · Taxa Compra Manha ·
Taxa Venda Manha · PU Compra Manha · PU Venda Manha · PU Base Manha`
Por que é ouro: é a série histórica oficial, gratuita, diária, com
taxa de compra E de venda — ou seja, o spread real está no dado.
Isso resolve a estimativa que eu tinha usado no TESOURO-MARKUP.md §2.
📐 Spread REAL medido (substitui minha estimativa de 0,10%)
| Família | Spread mediano (Taxa Compra − Taxa Venda) |
|---|---|
| Tesouro IPCA+ | −0,070 |
| Tesouro IPCA+ c/ Juros Semestrais | −0,060 |
| Tesouro Prefixado | −0,040 |
| Tesouro Prefixado c/ Juros Sem. | −0,060 |
| Tesouro Selic | −0,040 |
| Tesouro IGPM+ c/ Juros Sem. | −0,060 |
(negativo = você vende a uma taxa PIOR do que compra — é o custo de saída)
3. 🚨 O QUE EU CORRIJO NO MÉTODO DELES
3.1 O viés da janela (medido, não teórico)
O repo usa história COMPLETA para os quartis. Testei contra janela de 3 anos:
| Título | Percentil (história completa) | Percentil (3 anos) | Diferença |
|---|---|---|---|
| IPCA+ c/ Juros 15/05/2035 | 92% | 78% | 14 pts |
| IPCA+ c/ Juros 15/08/2050 | 95% | 81% | 14 pts |
| IPCA+ 15/05/2035 | 97% | 83% | 14 pts |
| IGPM+ c/ Juros 01/01/2031 | 87% | 71% | 16 pts |
| IGPM+ c/ Juros 01/04/2021 | 27% | 100% | 73 pts (!) |
Conclusão: a escolha da janela muda o sinal. Comparar a taxa de hoje com
2005-2015 mistura regimes macro completamente diferentes (juro real de outro mundo).
Correção: usar janela móvel (3-5 anos) e declarar a escolha — nunca
apresentar "COMPRA ÓTIMA" sem dizer contra qual janela.
3.2 Nunca validaram o sinal (sem walk-forward)
O repo afirma que comprar no J4 é bom, mas não testa. Falta o óbvio:
"comprar quando J4 e segurar X anos rendeu mais do que comprar em J1?"
Correção: backtest walk-forward — é o que nosso METODO.md exige.
3.3 Ignoram o problema da reaplicação
O repo diz quando comprar, mas não resolve o "e depois de vender?" —
a lavagem matemática do TESOURO-MARKUP.md §2. Correção: calcular o breakeven.
3.4 Sem impostos nem custódia
Spread está no dado, mas IR regressivo e custódia B3 não entram.
Correção: líquido de verdade.
3.5 Robustez de dados
O parser deles detecta encoding/delimitador/BOM de forma frágil (latin1 vs utf-8).
Correção: nosso METODO.md §A4 — contrato de dados que para em mismatch.
4. ✅ O QUE EXTRAÍMOS (usar a nosso favor)
- A fonte oficial (URL acima) → base do nosso
dados/ - Spread real do dado → substitui estimativa;
PU CompravsPU Venda - Classificação por percentil → como FILTRO inicial, não como sinal final
- Padrão de alerta (
ALERTA_RENTABILIDADE+ALERTA_PERIODO_MINUTOS)
→ mesmo desenho do nosso cron (limiar + dedupe)
- Comparação compra×resgate → embrião certo; nós aprofundamos
- Deploy Docker → já é o nosso ambiente
5. ➕ O QUE ADICIONAMOS QUE ELES NÃO TÊM
- Janela móvel em vez de história completa (§3.1)
- Walk-forward para provar que o sinal funciona (§3.2)
- Matemática do breakeven — o "e depois?" (§3.3)
- Líquido de IR + custódia (§3.4)
- Visão de juros (Copom, Focus, mercados de predição) — a parte preditiva
- Scorecard — medir se as recomendações acertam
6. 📸 ESTADO ATUAL (dado de 16/09/2026)
| Família | Vencimento | Taxa compra | Percentil (3a) |
|---|---|---|---|
| Tesouro Prefixado | (curto) | 13,58% | 44% |
| Tesouro Prefixado | (médio) | 13,89% | 84% |
| Tesouro Prefixado | (longo) | 14,30% | 70% |
| Tesouro IPCA+ | (curto) | 7,23% | 79% |
| Tesouro IPCA+ | (médio) | 7,30% | 64% |
| Tesouro IPCA+ | (longo) | 7,60% | 83% |
(percentis recalculados por mim na janela de 3 anos; n = nº de observações de cada título)
Leitura rápida: os prefixados e os IPCA+ longos estão na faixa alta do
histórico recente → por este filtro, momento de compra, não de venda.
⚠️ Isso é filtro estatístico, não recomendação. Falta o resto: breakeven,
líquido de impostos e visão de juros.
7. Status
🔍 Análise concluída. Nada implementado.
O repo fica como referência (não como dependência). Nenhuma linha de código
dele foi executada.