Un visor moderno y completo para tus criptomonedas con soporte para exchanges chilenos e internacionales.
¡La app definitiva para monitorear tu portfolio cripto! 🚀 Este proyecto incluye dos aplicaciones súper bacanas:
Una app nativa con Python y Tkinter que te deja ver todos tus balances cripto de una sola mirada.
Una versión web moderna con Flask - ¡accede desde cualquier navegador y dispositivo!
- 🇨🇱 Buda.com - El exchange chileno de confianza
- 🌍 Binance - El gigante mundial de cripto
- 🔄 NotBank (ex-CryptoMKT) - Exchange regional integrado
- Ver balances de todas tus cuentas en un solo lugar
- Resumen total de tu portafolio en diferentes monedas
- Actualización en tiempo real con datos de las APIs
- Gráfico General del Portfolio: Vista tipo dona con distribución de activos
- Gráficos por Moneda: Líneas de tiempo con precios históricos de 30 días
- Gráficos Interactivos: Tooltips y animaciones usando Chart.js
- Precios en Vivo: Datos actualizados desde Binance API
- 🔵 Actualizar: Refresh de datos sin recargar página
- 🟢 Importar: Sube archivos JSON con datos
- 🔴 Exportar: Descarga en JSON/CSV para Excel
- 🟠 Configurar: Gestión de API keys integrada
- 🟣 Gráfico: Vista general del portfolio
- Exportar a JSON: Formato completo con metadatos
- Exportar a CSV: Compatible con Excel y hojas de cálculo
- Importar desde archivo: Soporte para archivos JSON
- Descarga automática: Archivos con fecha incluida
- Modal de Configuración: Interfaz intuitiva para API keys
- Instrucciones integradas: Guía paso a paso dentro de la app
- Configuración segura: Archivos separados (config.py)
- Datos mock: Para desarrollo y testing
- Responsive Design: Se ve bacán en cualquier pantalla
- AJAX Updates: Sin recargar página (como las apps modernas)
- Chart.js: Gráficos interactivos profesionales
- CSS Gradients: Botones con efectos visuales elegantes
- Flask: Framework web Python confiable
- API Integration: Conexión directa con exchanges
- Error Handling: Manejo completo de errores
- Mock Data: Datos de prueba para desarrollo
- API Keys separadas: Archivo config.py independiente
- Encriptación: Utilidades crypto integradas
- Validación: Verificación de datos de entrada
- Error Masking: No expone información sensible
- 🐍 Python 3.6+ (recomendado 3.8+)
- 💻 Windows/Linux/MacOS
- 🌐 Navegador moderno (para la versión web)
- 📡 Conexión a Internet (para datos en vivo)
git clone https://github.com/gmolate/visorcrypto.git
cd visorcryptopython -m venv .venv
# Windows:
.venv\Scripts\activate
# Linux/Mac:
source .venv/bin/activatepip install -r requirements.txt¡Listo! 🎉 Ya tienes todo instalado.
# Ejecutar la app web
.venv\Scripts\python.exe app.pyLuego abre tu navegador en: http://localhost:5001
- 🔄 Actualizar Balances: Refresh en tiempo real
- 📊 Ver Gráfico General: Portfolio en gráfico de dona
- 📥 Importar Datos: Sube archivos JSON
- 📤 Exportar Datos: Descarga en JSON/CSV
- ⚙️ Configurar: Gestiona tus API keys
- 📈 Gráficos por Moneda: Clic en "Ver Gráfico" en cualquier fila
# Ejecutar la app de escritorio
.venv\Scripts\python.exe visor_crypto.py- 🔄 Botón de Refresh Prominente: Actualización con un clic
- 📊 Gráficos integrados: Usando matplotlib
- 🛠️ Menú de Ayuda: Para troubleshooting
- 📱 Interfaz nativa: Optimizada para escritorio
¡No necesitas hacer nada! La app usa datos mock automáticamente.
- Copiar plantilla de configuración:
copy config_example.py config.py- Editar
config.pycon tus API keys:
API_KEYS = {
"buda": {
"apiKey": "tu_buda_api_key_aqui",
"apiSecret": "tu_buda_api_secret_aqui"
},
"binance": {
"apiKey": "tu_binance_api_key_aqui",
"apiSecret": "tu_binance_api_secret_aqui"
},
"notbank": {
"apiKey": "tu_notbank_api_key_aqui",
"apiSecret": "tu_notbank_api_secret_aqui",
"userId": "tu_user_id_aqui",
"accountId": "tu_account_id_aqui"
}
}- Reiniciar la aplicación
- ✅ Asegúrate de que
config.pyesté en.gitignore - ✅ Usa API keys con permisos de solo lectura
- ✅ Nunca compartas tus API keys
📦 visorcrypto/
├── 🌐 app.py # Aplicación web Flask
├── 🖥️ visor_crypto.py # Aplicación desktop tkinter
├── 🔗 api_client.py # Cliente APIs exchanges
├── 🔐 crypto_utils.py # Utilidades encriptación
├── ⚙️ config_example.py # Plantilla configuración
├── 📋 requirements.txt # Dependencias Python
├── 🧪 demo_final.py # Script demostración
├── 📁 templates/
│ └── 🎨 index.html # Interfaz web
├── 📁 static/
│ ├── 💅 style.css # Estilos CSS
│ └── ⚡ main.js # JavaScript
└── 📁 lib/
└── 📁 services/ # Servicios adicionales
- Interfaz moderna y responsive
- 5 botones de acción prominentes
- Gráficos interactivos con Chart.js
- Actualización AJAX sin recargar página
- Interfaz nativa con tkinter
- Botón de refresh prominente 🔄
- Menú de ayuda integrado
- Gráficos con matplotlib
# Verificar dependencias
pip install -r requirements.txt
# Ejecutar con el Python correcto
.venv\Scripts\python.exe app.py- Verificar que
config.pyexiste y tiene las keys correctas - Verificar permisos de las API keys en cada exchange
- Revisar la consola para mensajes de error
- Usar datos mock para testing
# Reinstalar dependencias
pip install -r requirements.txt --force-reinstall- ✅ Aplicación Web: Lista para usar
- ✅ Aplicación Desktop: Completamente funcional
- ✅ APIs: Integradas (Buda, Binance, NotBank)
- ✅ Gráficos: Interactivos y modernos
- ✅ Import/Export: JSON y CSV
- ✅ Configuración: Sistema completo de API keys
- ✅ Error matplotlib: SOLUCIONADO
- ✅ Botón refresh no visible: SOLUCIONADO
- ✅ Saldos no cargan: SOLUCIONADO
- ✅ NotBank SDK integrado: SOLUCIONADO
¿Tienes ideas bacanes? ¡Manda tus PRs!
- Fork el proyecto
- Crea tu feature branch (
git checkout -b feature/AmazingFeature) - Commit tus cambios (
git commit -m 'Add some AmazingFeature') - Push al branch (
git push origin feature/AmazingFeature) - Abre un Pull Request
Este proyecto está bajo la Licencia MIT - revisa el archivo LICENSE para más detalles.
- 🇨🇱 Buda.com por su API chilena
- 🌍 Binance por la API global
- 🔄 NotBank por la continuidad de CryptoMKT
- 📊 Chart.js por los gráficos elegantes
- 🐍 Python por ser tan bacán
Desarrollado con ❤️ por @gmolate
"Crypto hecho fácil para la comunidad chilena" 🇨🇱