Curso para iniciantes

Lição 1. Por que este projeto existe

O projeto responde a uma pergunta: uma regra simples consegue ganhar mais do que comprar uma moeda e segurar? Um exemplo de regra: "segurar SOL só enquanto o preço estiver acima da média de 50 dias".

A internet está cheia de regras assim, todas com gráficos bonitos. Normalmente é autoengano: a regra foi ajustada ao passado, as taxas foram esquecidas ou o teste foi feito num único período de sorte. Este projeto se protege de três formas:

1. Primeiro escrever, depois testar. A regra e a meta de sucesso são escritas antes e seladas com uma impressão digital (um hash). O teste não pode ser ajustado depois de ver o resultado.
2. Testar em anos que a regra não viu. A regra é escolhida em 2018–2021 e avaliada a partir de 2022.
3. Comparar com a sorte. Um teste estatístico responde se esse resultado poderia surgir por acaso.

Resultado de hoje: 2 de 33 hipóteses passam no teste pré-registrado. Isso também é um resultado: economiza o dinheiro que iria para operar com regras "bonitas".

Lição 2. Como funciona

Tudo roda sozinho nos servidores do GitHub. Ninguém precisa deixar um computador ligado.

• Todo dia às 03:00–07:00 UTC os preços novos são baixados e verificados, o estado do mercado é recalculado e este site é reconstruído.
• Toda segunda-feira as hipóteses antigas são testadas de novo com os dados novos. Se um veredicto muda, um alerta é enviado.
• Uma vez por mês um modelo de IA pode sugerir ideias novas. Uma pessoa revisa e trava cada uma antes do teste.

Lição 3. As páginas do site

Abra a página principal: ela responde duas perguntas — o que foi encontrado e como está o mercado hoje. O menu no topo leva a cinco páginas; a lista de idiomas fica à direita.

Como ler um cartão do mercado. O número grande é o valor de hoje. A palavra emoldurada abaixo é a faixa (por exemplo "ganância" ou "acima"). A linha de baixo mostra os últimos 12 meses. "O que é isto?" abre uma explicação curta. O que importa não é o número, mas a mudança de faixa: é quando chega um alerta (lição 7).

Lição 4. Como ler a página de uma moeda — SOL como exemplo

Cada moeda tem sua página. Mercado → "Moedas" → clique em SOL Solana, ou abra Solana direto. Para outras moedas só muda o ticker no endereço: ETHUSDT, BTCUSDT, EVERUSDT…

A página é lida em quatro passos:

1. Gráfico de 12 meses. Linha azul = preço, tracejado amarelo = média de 50 dias, pontos brancos = média de 200 dias. Preço acima das duas médias = tendência de alta; abaixo das duas = de baixa. A escala é logarítmica: subir de $10 para $20 parece igual a subir de $100 para $200.
2. Números. Variação em 7 dias, 30 dias e um ano; distância das médias; volatilidade. Volatilidade de 70% significa um movimento anual típico de cerca de 70% para cima ou para baixo. Hoje: BTC 25%, SOL 35%, EVER 262%. Mais três linhas dão contexto: quanto o preço está abaixo do maior fechamento (SOL: -61%), quanto valem hoje $100 investidos há um ano (SOL: $53) e quanto a moeda se move junto com o Bitcoin, de −1 a 1 (SOL: 0,83).
3. O que as regras testadas dizem hoje. Quatro regras das hipóteses e o que cada uma faria hoje: "no mercado", "fora do mercado" ou uma fração da posição. Ao lado, o veredicto do teste. Nenhuma passou, então isto é uma observação, não um sinal.
4. Estudos com esta moeda. Para SOL o mais interessante é a H-014 (momentum semanal): em SOL a regra chegou a Sharpe 0,79 contra 0,36 de segurar, mas falhou no BTC, por isso o veredicto é "fraca".

Três perguntas para qualquer moeda: o preço está acima ou abaixo da média de 200 dias? A volatilidade está maior ou menor que o normal? O Bitcoin está subindo ou caindo (última linha da tabela de regras)?

Lição 5. Como ler uma hipótese

Abra qualquer hipótese da tabela principal, por exemplo a H-003. No topo há um veredicto colorido e uma frase "em poucas palavras".

Depois vem a tabela de resultados, uma linha por moeda e período. As colunas são sempre comparadas em pares, regra contra "segurar":

• Sharpe: retorno por unidade de risco. Maior é melhor. Segurar Bitcoin dá cerca de 0,5.
• CAGR: crescimento anual médio.
• Drawdown máximo: a pior queda a partir de um pico. −50% significa que o dinheiro caiu pela metade em algum momento.
• p-valor: a chance de o resultado ser sorte. Quanto menor, melhor; precisa ficar abaixo da meta escrita na hipótese.

Abaixo da tabela há um gráfico de como 1 dólar teria crescido com a regra (linha cheia) e segurando (tracejada). A lista troca a moeda e o período.

Lição 6. Acompanhando a Everscale (EVER)

A EVER não está na Binance, então os preços vêm da Gate.io. Dá para acompanhar em três lugares:

1. O cartão da EVER na página Mercado (seção "Moedas"): quanto o preço está longe da média de 50 dias. Positivo = a regra H-018 está "no mercado", negativo = "fora".
2. A página da EVER: Everscale, com gráfico, números e o estado de cada regra.
3. As hipóteses H-018 e H-019, testadas na EVER. Desde meados de 2022 a regra SMA50 rendeu -9% ao ano contra -69% segurando, com pior queda de -84% contra -100%.

Importante. A regra "vence" segurar principalmente porque segurar perdeu quase tudo. O volume diário da EVER é pequeno, e o preço pode saltar mesmo com negócios pequenos. É informação para acompanhar, não uma recomendação.

Lição 7. Alertas no Telegram

Neste site não é preciso configurar nada: basta abrir a página uma vez por dia. Os alertas são para quem roda a própria cópia do projeto (é grátis):

1. Crie um bot com o @BotFather e copie o token.
2. Mande qualquer mensagem para o seu bot e descubra o seu chat id (por exemplo com o @userinfobot).
3. Faça um fork do repositório e no fork: Settings → Secrets and variables → Actions → adicione TELEGRAM_BOT_TOKEN e TELEGRAM_CHAT_ID.
4. Settings → Pages → Source: GitHub Actions, depois Actions → research-agents → Run workflow.

O alerta chega só quando algo muda: um cartão do mercado muda de faixa ou uma hipótese ganha um veredicto novo. Em dias calmos não há mensagens.

Lição 8. Como testar sua própria ideia

O caminho mais simples não exige programação:

1. Abra uma nova issue "Hypothesis idea".
2. Descreva a regra com palavras simples: quando você está no mercado, quando está fora, quais moedas.
3. Explique por que ela deveria funcionar e o que conta como sucesso. Escreva isso antes de olhar qualquer gráfico.

A ideia vira um arquivo de hipótese, é travada e testada. O resultado aparece neste site em todos os idiomas, com página própria.

Se você sabe um pouco de Python, leia o CONTRIBUTING.md: uma hipótese é um arquivo YAML curto.

Lição 9. O que o projeto não faz

• Não dá conselhos. Nenhum veredicto diz para comprar ou vender. Mesmo um "passou" seria só motivo para mais verificações.
• Não opera nem administra dinheiro de ninguém.
• Não promete o futuro. Todos os resultados descrevem o passado; os mercados mudam.
• Nem tudo está incluído. Impostos, slippage em ordens grandes e o risco de falência de uma corretora não estão nos números. As taxas estão.
• Moedas pequenas têm um risco especial. Com pouco volume, o preço que você vê pode não ser o preço em que você compra ou vende.

Se quiser agir com base em algo daqui, pergunte-se antes: o que acontece comigo se a regra parar de funcionar amanhã?

Lição 10. Prática: tarefas para uma semana

• Abra a página Mercado e encontre a faixa de hoje do índice de medo e ganância.
• Encontre na tabela "Moedas" a moeda com maior volatilidade.
• Abra a página da SOL: o preço está acima ou abaixo da média de 200 dias?
• Abra a H-005 e explique em uma frase por que ela foi reprovada.
• Abra a página da EVER e compare a volatilidade dela com a do Bitcoin.
• Volte daqui a uma semana: algum cartão do mercado mudou de faixa?
• Escreva uma ideia sua: a regra, por que deveria funcionar, o que conta como sucesso.

Glossário para iniciantes