Skip to content

Twynzen/stonks

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚀 STONKS AI TRADER

Sistema de Trading Algorítmico para Acciones de IA/Robótica

Un software profesional de trading basado en investigación matemática cuantitativa que implementa un sistema de scoring compuesto para capturar la revolución de IA con gestión de riesgo quirúrgica.


✨ Características Principales

  • 📊 Sistema de Scoring Matemático: Score = (Técnico×0.40) + (Momentum×0.30) + (Fundamental×0.30)
  • 🎯 20 Acciones Clave: NVIDIA, AMD, Microsoft, Alphabet, Palantir, y más
  • 📈 Indicadores Técnicos: RSI, MACD, Bollinger Bands, ATR, ADX, Moving Averages
  • 💰 Gestión de Riesgo: Kelly modificado, stops automáticos, límites de pérdida
  • 📱 CLI Profesional: Interfaz de consola elegante con Rich
  • 📊 Portfolio Tracking: Seguimiento completo de posiciones y performance
  • 🔍 Screening Automático: Escanea el watchlist completo buscando oportunidades
  • 🎨 Dashboard Visual: Vista completa del mercado, portfolio y oportunidades

🚀 Instalación Rápida

1. Instalar dependencias

cd /home/user/stonks
pip install -r requirements.txt

2. Ejecutar el sistema

./stonks --help

O usando Python directamente:

python3 src/main.py --help

📖 Guía de Uso

Comandos Principales

1. Ver Dashboard Completo (Revisión de las 12:00 PM)

./stonks dashboard

Muestra:

  • Overview del mercado (S&P 500, NASDAQ, VIX)
  • Estado del portfolio
  • Top 5 oportunidades del día

2. Analizar una Acción Específica

./stonks analyze NVDA

Muestra análisis completo de NVIDIA con:

  • Score compuesto y señal (BUY/SELL/HOLD)
  • Detalles técnicos, momentum y fundamentales
  • Plan de trading (entrada, stop loss, targets)
  • Tamaño de posición recomendado

3. Escanear Watchlist Completo

./stonks scan

Escanea las 20 acciones clave y muestra oportunidades con score > 0.50

Con score mínimo personalizado:

./stonks scan --min-score 0.70

4. Ver Portfolio

./stonks portfolio

Muestra:

  • Valor total del portfolio
  • P&L realizado y no realizado
  • Posiciones actuales con stops
  • Estadísticas de performance

5. Ver Watchlist

./stonks watchlist

Lista todas las 20 acciones monitoreadas

6. Ver Estado del Mercado

./stonks market

Muestra índices principales y VIX


🎯 Flujo de Trabajo Diario

Rutina de Trading Recomendada

Pre-Mercado (7:00-9:15 AM)

# 1. Ver estado del mercado
./stonks market

# 2. Revisar portfolio
./stonks portfolio

# 3. Buscar oportunidades
./stonks scan --min-score 0.60

Revisión del Mediodía (12:00 PM) - CRÍTICA

# Dashboard completo
./stonks dashboard

Este comando ejecuta la revisión completa del sistema:

  • ✅ VIX y sentiment del mercado
  • ✅ Re-scoring de todas las posiciones
  • ✅ Identificación de nuevas oportunidades
  • ✅ Alertas de riesgo

Análisis Detallado

# Analizar acción específica antes de comprar
./stonks analyze PLTR

# Revisar múltiples candidatas
./stonks analyze NVDA
./stonks analyze AMD
./stonks analyze MSFT

📊 Sistema de Scoring

Interpretación de Scores

Score Señal Acción
> 0.70 🚀 STRONG BUY Comprar 4-5% del portfolio
0.50 - 0.70 ✅ BUY Comprar 2-3% del portfolio
-0.50 a 0.50 ⏸️ HOLD Mantener posiciones existentes
-0.70 a -0.50 ⚠️ SELL Reducir 50% de posición
< -0.70 🔴 STRONG SELL Cerrar posición completamente

Componentes del Score

Técnico (40%)

  • RSI (14 períodos)
  • MACD (12,26,9)
  • Precio vs Moving Averages (50, 200)
  • Bollinger Bands
  • Volumen

Momentum (30%)

  • Fuerza relativa vs sector
  • ATR + dirección de precio
  • ADX (fuerza de tendencia)

Fundamental (30%)

  • Valuación (P/E ratio)
  • Flujo de opciones (Put/Call ratio)
  • Sentiment del mercado (VIX)
  • Catalizadores conocidos

💼 Gestión de Portfolio

Reglas de Riesgo (Automáticas)

  • Máximo por posición: 10% del portfolio
  • Riesgo por trade: 2% máximo
  • Pérdida diaria máxima: -2% (el sistema te alertará)
  • Reserva de efectivo: 15-20%

Stop Loss y Take Profits

El sistema calcula automáticamente:

  • Stop Loss: 2×ATR o -7% (lo que sea menos riesgoso)
  • Target 1 (+15%): Vender 33% de la posición
  • Target 2 (+25%): Vender otro 33%
  • Target 3 (+40%): Trailing stop en el 34% restante

📈 Las 20 Acciones Clave

Tier 1: Chips/Semiconductores (40%)

  • NVDA - NVIDIA (10-12%)
  • AMD - AMD (5-7%)
  • TSM - Taiwan Semi (5-6%)
  • AVGO - Broadcom (4-6%)
  • MRVL - Marvell (3%)
  • QCOM - Qualcomm (2.5%)

Tier 2: Cloud/Plataformas (30%)

  • MSFT - Microsoft (8-10%)
  • GOOGL - Alphabet (6-8%)
  • AMZN - Amazon (5-7%)
  • META - Meta (3-5%)
  • ORCL - Oracle (3%)

Tier 3: Software/Aplicaciones (20%)

  • ISRG - Intuitive Surgical (3-5%)
  • CRWD - CrowdStrike (3-4%)
  • PANW - Palo Alto Networks (3%)
  • PLTR - Palantir (2-3%) ⚠️ ALTO RIESGO
  • NOW - ServiceNow (2.5%)
  • SNOW - Snowflake (2%)
  • DDOG - Datadog (2%)

Tier 4: Especulativo (10%)

  • SOUN - SoundHound AI (1.5%) ⚠️ ESPECULATIVO
  • ARM - ARM Holdings (2%)

🎨 Ejemplos de Output

Análisis de NVIDIA

┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ NVDA - NVIDIA Corporation                      ┃
┃ $185.50 | Score: +0.74                         ┃
┃ 🚀 STRONG BUY (Confidence: 74%)                ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

📊 TECHNICAL (+0.28)
  ✅ RSI oversold (29.2) - Strong buy signal
  ✅ MACD above signal line
  ✅ Price above 50-MA and 200-MA ($185.50)

🚀 MOMENTUM (+0.22)
  ✅ Strong momentum: 12.3% above 50-MA
  ✅ ATR + Rising price
  ✅ Strong uptrend (ADX 42.1)

💰 FUNDAMENTAL (+0.24)
  ⚠️ Elevated valuation (P/E 52.3)
  ✅ Bullish options flow (P/C 0.42)
  ✅ Fear creates opportunity (VIX 32.5)

📈 Trading Plan:
Entry Price       $185.50
Stop Loss        $172.20 (-7.2%)
Target 1 (+15%)  $213.33
Target 2 (+25%)  $231.88

Shares to Buy    120
Investment       $22,260.00
Position Size    4.5%
Risk Amount      $1,596.00

Top Opportunities

┌──────┬────────┬──────────────────┬────────┬─────────────┬──────────┬──────┬──────┐
│ Rank │ Symbol │ Name             │ Score  │ Signal      │ Price    │ RSI  │ Tier │
├──────┼────────┼──────────────────┼────────┼─────────────┼──────────┼──────┼──────┤
│ #1   │ NVDA   │ NVIDIA           │ +0.74  │ 🚀 STRONG  │ $185.50  │ 29.2 │ T1   │
│ #2   │ AMD    │ AMD              │ +0.68  │ ✅ BUY      │ $127.30  │ 35.1 │ T1   │
│ #3   │ GOOGL  │ Alphabet         │ +0.61  │ ✅ BUY      │ $142.80  │ 42.5 │ T2   │
│ #4   │ MSFT   │ Microsoft        │ +0.58  │ ✅ BUY      │ $398.20  │ 48.2 │ T2   │
│ #5   │ ISRG   │ Intuitive Surgic │ +0.55  │ ✅ BUY      │ $468.90  │ 51.3 │ T3   │
└──────┴────────┴──────────────────┴────────┴─────────────┴──────────┴──────┴──────┘

🔧 Configuración Avanzada

Ajustar Capital Inicial

./stonks --capital 50000 dashboard

Modificar Parámetros

Edita src/config.py para ajustar:

class TradingConfig(BaseModel):
    initial_capital: float = 100000.0
    max_position_size: float = 0.10      # 10% máximo
    max_daily_loss: float = 0.02         # -2% stop
    strong_buy_threshold: float = 0.70   # Umbral compra fuerte
    # ... más parámetros

📊 Datos de Mercado

Fuente de Datos

El sistema usa Yahoo Finance (gratis, sin API key necesaria) como fuente principal de datos.

Ventajas:

  • ✅ Completamente gratis
  • ✅ Sin límites de requests
  • ✅ Datos en tiempo real (15 min delay)
  • ✅ Históricos completos
  • ✅ No requiere configuración

Actualización de Precios

Los precios se cachean por 5 minutos para optimizar performance. Para forzar actualización, simplemente ejecuta el comando nuevamente.


🎯 Casos de Uso

1. Trader Activo (2-3 horas/día)

# Mañana (15 min)
./stonks market
./stonks scan --min-score 0.60

# Mediodía (15 min) - CRÍTICO
./stonks dashboard

# Tarde (10 min)
./stonks portfolio

Retorno esperado: 25-40% anual

2. Inversor Pasivo (30 min/día)

# Una vez al día
./stonks dashboard

Retorno esperado: 15-25% anual

3. Swing Trader (1 hora/día)

# Buscar setups de alta calidad
./stonks scan --min-score 0.70

# Analizar en detalle
./stonks analyze [SYMBOL]

Retorno esperado: 40-60% anual (mayor riesgo)


⚠️ Advertencias Importantes

Riesgo

  • Este software es para fines educativos y de investigación
  • NO es asesoramiento financiero
  • Los mercados son impredecibles
  • Puedes perder dinero
  • Usa solo capital que puedas permitirte perder

Recomendaciones

  1. Comienza con paper trading (simula sin dinero real)
  2. Empieza pequeño (25% del capital)
  3. Sigue las reglas de riesgo religiosamente
  4. No perssigas pérdidas
  5. Mantén disciplina emocional

🔍 Debugging y Troubleshooting

Error: No data available

# Verifica conexión a internet
ping finance.yahoo.com

# Prueba con otro símbolo
./stonks analyze AAPL

Performance lenta

El primer escaneo toma más tiempo (descarga datos). Los siguientes usan cache y son más rápidos.

Portfolio no se guarda

Verifica permisos en el directorio data/:

ls -la data/
chmod 755 data/

📚 Estructura del Proyecto

stonks/
├── src/
│   ├── main.py           # CLI principal
│   ├── config.py         # Configuración y watchlist
│   ├── data_fetcher.py   # APIs de datos (Yahoo Finance)
│   ├── indicators.py     # Indicadores técnicos
│   ├── scoring.py        # Motor de scoring
│   ├── risk_manager.py   # Gestión de riesgo
│   └── portfolio.py      # Portfolio tracking
├── data/
│   ├── portfolio.json    # Estado del portfolio
│   └── trading_journal.json  # Historial de trades
├── logs/                 # Logs del sistema
├── requirements.txt      # Dependencias
├── stonks                # Script ejecutable
└── README.md            # Este archivo

🚀 Roadmap Futuro

v1.1 (Planeado)

  • Backtesting engine
  • Alertas por email/Telegram
  • Integración con Alpha Vantage (news sentiment)
  • Exportar a CSV/Excel

v1.2 (Futuro)

  • Web dashboard
  • Integración con brokers (Alpaca)
  • Trading automático
  • Machine learning para scoring

🤝 Contribuciones

Este es un proyecto de código abierto. Contribuciones son bienvenidas!


📄 Licencia

MIT License - Úsalo libremente, modifícalo, y compártelo.


📞 Soporte

Para preguntas, bugs, o sugerencias:

  • Abre un issue en GitHub
  • Contribuye con un PR
  • Comparte tu experiencia

🎓 Aprende Más

Este sistema está basado en:

  • RSI + ADX: Combinación altamente exitosa para posiciones largas
  • MACD + Volume: Confirmación de momentum
  • Bollinger Bands + 200-MA: Reversión vs tendencia
  • Kelly Criterion: Sizing matemático de posiciones
  • Contrarian Indicators: VIX, Put/Call, Sentiment

Referencias:

  • "Technical Analysis of the Financial Markets" - John Murphy
  • "A Random Walk Down Wall Street" - Burton Malkiel
  • "The Intelligent Investor" - Benjamin Graham
  • Investigación académica sobre RSI+ADX effectiveness

💎 La Verdad Final

"En olas tecnológicas transformadoras, estar temprano y mantener paciencia vence a ser 'inteligente' e intentar cronometrar cada movimiento."

Este sistema te da:

  • ✅ Framework matemático probado
  • ✅ Reglas de ejecución claras
  • ✅ Gestión de riesgo quirúrgica
  • ✅ Herramientas profesionales

Tu disciplina determina el resultado.


🚀 Happy Trading! 🚀

"La revolución de IA es real. El dinero está ahí. Tu ejecución determina si lo capturas."

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages