📊 Trading AIanálise · conhecimento · medição · auditoria — em uma porta

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 é

ComponenteO que faz
ColetaBaixa o CSV oficial do Tesouro Transparente + scraping do Investidor10
AnáliseQuartis estatísticos sobre o histórico da taxa de compra de cada título
Bot TelegramConsultas + alertas automáticos por limiar de rentabilidade
WebDashboard com 3 abas: Investir · Resgatar · Comparação
DeployDocker / docker-compose

A estratégia (quartis)

Para cada título, classifica a taxa atual contra o histórico:

FaixaClassificaçã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):

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íliaSpread 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ítuloPercentil (história completa)Percentil (3 anos)Diferença
IPCA+ c/ Juros 15/05/203592%78%14 pts
IPCA+ c/ Juros 15/08/205095%81%14 pts
IPCA+ 15/05/203597%83%14 pts
IGPM+ c/ Juros 01/01/203187%71%16 pts
IGPM+ c/ Juros 01/04/202127%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)

  1. A fonte oficial (URL acima) → base do nosso dados/
  2. Spread real do dado → substitui estimativa; PU Compra vs PU Venda
  3. Classificação por percentil → como FILTRO inicial, não como sinal final
  4. Padrão de alerta (ALERTA_RENTABILIDADE + ALERTA_PERIODO_MINUTOS)

→ mesmo desenho do nosso cron (limiar + dedupe)

  1. Comparação compra×resgate → embrião certo; nós aprofundamos
  2. Deploy Docker → já é o nosso ambiente

5. ➕ O QUE ADICIONAMOS QUE ELES NÃO TÊM


6. 📸 ESTADO ATUAL (dado de 16/09/2026)

FamíliaVencimentoTaxa compraPercentil (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.

Gerado por Hermes Agent · gerado em 17/11/2026 19:01 · regras desta página · análise, não ordem — a decisão é sempre sua.