fin-pocket

fin-pocket es una librería de Python ligera para el análisis técnico y el reconocimiento automatizado de patrones en gráficos bursátiles. Descarga datos históricos de Yahoo Finance y genera gráficos interactivos con un conjunto de indicadores técnicos.

El reto

Traders y desarrolladores necesitaban una herramienta accesible capaz de aplicar varios indicadores técnicos a la vez y reconocer patrones gráficos habituales, sin recurrir a plataformas de pago pesadas.

La solución

• ▸Medias móviles (MA 50/100/200) con detección de Golden Cross y Death Cross
• ▸RSI con zonas de sobrecompra/sobreventa y detección de divergencias
• ▸Niveles de soporte/resistencia basados en pivotes y detección de breakout de volumen
• ▸Reconocimiento de patrones: wedge, flag, pennant, doble techo/suelo
• ▸Bollinger Bands, MACD, ATR, OBV y niveles de retroceso de Fibonacci
• ▸Se puede enviar una captura del gráfico directamente a un chatbot (ChatGPT, Claude) para analizar las señales

Cómo funciona

fin-pocket es una herramienta de línea de comandos y un paquete de Python publicado en PyPI (pip install fin-pocket). Un solo comando como fin-pocket AAPL descarga los precios históricos de Yahoo Finance, calcula las señales activadas y abre un gráfico interactivo de Plotly en el navegador; con --output el gráfico se guarda como un archivo HTML independiente que se puede compartir o archivar.

• ▸Marco temporal diario o por horas con --timeframe
• ▸Cada señal se puede desactivar por separado (--no-rsi, --no-wedge, etc.); las Bandas de Bollinger se activan con --bb
• ▸MACD (12, 26, 9), ATR (14) y OBV con media móvil de 20 periodos en paneles separados bajo el gráfico de precios
• ▸Niveles de retroceso de Fibonacci del 23,6 % al 78,6 %, calculados a partir del último gran movimiento del precio

Ingeniería

Los casos límite en el cálculo de señales y en la generación de gráficos están cubiertos por pruebas, incluidas protecciones contra la división por cero en series de precios planas. La CI se ejecuta en GitHub Actions con informes de cobertura en Codecov, las versiones se derivan de las etiquetas de git con setuptools-scm y las versiones nuevas se publican en PyPI automáticamente.

El resultado

Los gráficos interactivos de Plotly facilitan revisar señales de varios indicadores a la vez, y el flujo captura-a-chatbot permite un análisis rápido con IA sin integración aparte.