Curso para principiantes

Lección 1. Por qué existe este proyecto

El proyecto responde a una pregunta: ¿puede una regla sencilla ganar más que comprar una moneda y mantenerla? Un ejemplo de regla: "mantener SOL solo mientras su precio esté por encima de su media de 50 días".

Internet está lleno de reglas así, todas con gráficos bonitos. Normalmente es autoengaño: la regla se ajustó al pasado, se olvidaron las comisiones o se probó en un único periodo afortunado. Este proyecto se protege de tres maneras:

1. Primero escribir, después probar. La regla y el listón de éxito se escriben antes y se sellan con una huella (un hash). La prueba no se puede ajustar después de ver el resultado.
2. Probar en años que la regla no ha visto. La regla se elige con 2018–2021 y se juzga desde 2022.
3. Comparar con la suerte. Una prueba estadística responde si ese resultado pudo salir por casualidad.

Resultado de hoy: 2 de 33 hipótesis superan su prueba prerregistrada. También es un resultado: ahorra el dinero que se iría en operar con reglas "bonitas".

Lección 2. Cómo funciona

Todo funciona solo en los servidores de GitHub. Nadie necesita tener un ordenador encendido.

• Cada día a las 03:00–07:00 UTC se descargan y comprueban los precios nuevos, se recalcula el estado del mercado y se reconstruye esta web.
• Cada lunes las hipótesis antiguas se vuelven a probar con los datos nuevos. Si cambia un veredicto, se envía una alerta.
• Una vez al mes un modelo de IA puede proponer ideas nuevas. Una persona revisa y bloquea cada una antes de probarla.

Lección 3. Las páginas del sitio

Abre la página principal: responde dos preguntas — qué se ha encontrado y cómo está hoy el mercado. El menú de arriba lleva a cinco páginas; la lista de idiomas está a la derecha.

Cómo leer una tarjeta del mercado. El número grande es el valor de hoy. La palabra enmarcada debajo es la zona (por ejemplo "codicia" o "por encima"). La línea inferior muestra los últimos 12 meses. "¿Qué es esto?" abre una explicación breve. Lo importante no es el número sino el cambio de zona: entonces se envía un aviso (lección 7).

Lección 4. Cómo leer la página de una moneda — SOL como ejemplo

Cada moneda tiene su página. Mercado → "Monedas" → pulsa SOL Solana, o abre Solana directamente. Para otras monedas solo cambia el ticker en la dirección: ETHUSDT, BTCUSDT, EVERUSDT…

La página se lee en cuatro pasos:

1. Gráfico de 12 meses. Línea azul = precio, rayas amarillas = media de 50 días, puntos blancos = media de 200 días. Precio sobre ambas medias = tendencia alcista; bajo ambas = bajista. La escala es logarítmica: subir de $10 a $20 se ve igual que de $100 a $200.
2. Cifras. Cambio en 7 días, 30 días y un año; distancia a las medias; volatilidad. Una volatilidad del 70% significa un movimiento anual típico de un 70% arriba o abajo. Hoy: BTC 25%, SOL 35%, EVER 262%. Tres líneas más dan contexto: cuánto está por debajo de su cierre más alto (SOL: -61%), cuánto valen hoy $100 invertidos hace un año (SOL: $53) y cuánto se mueve junto con Bitcoin, de −1 a 1 (SOL: 0,83).
3. Qué dicen hoy las reglas probadas. Cuatro reglas de las hipótesis y qué haría cada una hoy: "dentro del mercado", "fuera del mercado" o una parte de la posición. Al lado, el veredicto de su prueba. Ninguna ha superado la prueba, así que es una observación, no una señal.
4. Estudios que incluyen esta moneda. Para SOL lo más interesante es H-014 (momentum semanal): en SOL la regla logró un Sharpe de 0,79 frente a 0,36 al mantener, pero falló en BTC, por eso el veredicto es "débil".

Tres preguntas para cualquier moneda: ¿el precio está por encima o por debajo de su media de 200 días? ¿La volatilidad es mayor o menor de lo habitual? ¿Bitcoin sube o baja (última fila de la tabla de reglas)?

Lección 5. Cómo leer una hipótesis

Abre cualquier hipótesis de la tabla principal, por ejemplo H-003. Arriba hay un veredicto de color y una frase "en pocas palabras".

Después viene una tabla de resultados, una fila por moneda y periodo. Las columnas se comparan siempre en parejas, regla frente a "mantener":

• Sharpe: rentabilidad por unidad de riesgo. Más es mejor. Mantener Bitcoin da alrededor de 0,5.
• CAGR: crecimiento anual medio.
• Caída máxima: la peor caída desde un pico. −50% significa que el dinero se redujo a la mitad en algún momento.
• p-valor: la probabilidad de que el resultado sea suerte. Cuanto más pequeño, mejor; debe estar por debajo del listón escrito en la hipótesis.

Bajo la tabla hay un gráfico de cómo habría crecido 1 dólar con la regla (línea continua) y manteniendo (discontinua). La lista permite cambiar de moneda y periodo.

Lección 6. Seguir a Everscale (EVER)

EVER no está en Binance, así que sus precios vienen de Gate.io. Puedes seguirlo en tres lugares:

1. La tarjeta de EVER en la página Mercado (sección "Monedas"): cuánto se aleja el precio de su media de 50 días. Positivo = la regla H-018 está "dentro", negativo = "fuera".
2. La página de EVER: Everscale, con gráfico, cifras y el estado de cada regla.
3. Las hipótesis H-018 y H-019, probadas en EVER. Desde mediados de 2022 la regla SMA50 rindió -9% al año frente a -69% manteniendo, con una caída máxima de -84% frente a -100%.

Importante. La regla "gana" a mantener sobre todo porque mantener lo perdió casi todo. El volumen diario de EVER es pequeño y el precio puede saltar incluso con operaciones pequeñas. Es información para observar, no una recomendación.

Lección 7. Alertas en Telegram

En esta web no hay que configurar nada: basta con abrir la página una vez al día. Las alertas son para quien ejecuta su propia copia del proyecto (es gratis):

1. Crea un bot con @BotFather y copia su token.
2. Envía cualquier mensaje a tu bot y averigua tu chat id (por ejemplo con @userinfobot).
3. Haz un fork del repositorio y en el fork: Settings → Secrets and variables → Actions → añade TELEGRAM_BOT_TOKEN y TELEGRAM_CHAT_ID.
4. Settings → Pages → Source: GitHub Actions, y luego Actions → research-agents → Run workflow.

La alerta llega solo cuando algo cambia: una tarjeta del mercado pasa a otra zona o una hipótesis tiene un veredicto nuevo. En los días tranquilos no hay mensajes.

Lección 8. Cómo probar tu propia idea

La forma más sencilla no necesita programar:

1. Abre una nueva issue "Hypothesis idea".
2. Describe la regla con palabras sencillas: cuándo estás dentro del mercado, cuándo fuera, qué monedas.
3. Explica por qué debería funcionar y qué cuenta como éxito. Escríbelo antes de mirar ningún gráfico.

La idea se convierte en un archivo de hipótesis, se bloquea y se prueba. El resultado aparece en esta web en todos los idiomas, con su propia página.

Si sabes algo de Python, lee CONTRIBUTING.md: una hipótesis es un archivo YAML corto.

Lección 9. Lo que el proyecto no hace

• No da consejos. Ningún veredicto dice comprar o vender. Incluso un "supera" sería solo motivo para más comprobaciones.
• No opera ni gestiona el dinero de nadie.
• No promete el futuro. Todos los resultados describen el pasado; los mercados cambian.
• No todo está incluido. Impuestos, deslizamiento en órdenes grandes y el riesgo de quiebra de un exchange no están en las cifras. Las comisiones sí.
• Las monedas pequeñas tienen un riesgo especial. Con poco volumen, el precio que ves puede no ser el precio al que compras o vendes.

Si quieres actuar según algo de aquí, pregúntate primero: ¿qué me pasa si la regla deja de funcionar mañana?

Lección 10. Práctica: tareas para una semana

• Abre la página Mercado y encuentra la zona de hoy del índice de miedo y codicia.
• Encuentra en la tabla "Monedas" la moneda con mayor volatilidad.
• Abre la página de SOL: ¿el precio está por encima o por debajo de su media de 200 días?
• Abre H-005 y explica en una frase por qué no superó la prueba.
• Abre la página de EVER y compara su volatilidad con la de Bitcoin.
• Vuelve dentro de una semana: ¿alguna tarjeta del mercado cambió de zona?
• Escribe una idea propia: la regla, por qué debería funcionar, qué cuenta como éxito.

Glosario para principiantes