🧪 Índice de Datos de Piscinas de Liquidez en Hive
https://testhivelpindex.duckdns.org/ <---- Link here
🚀 Motivación del Proyecto
La blockchain de Hive cuenta con múltiples herramientas de capa 2, pero hasta ahora no existía una forma accesible y abierta para obtener historiales diarios de trading en las piscinas de liquidez. Este proyecto nace para llenar ese vacío.
Inspirado por la necesidad de tener datos históricos precisos y reutilizables, el índice permite obtener snapshots diarios en formato JSON navegable por carpetas.
🧠 ¿Qué Problema Resuelve?
- Brinda un acceso abierto a datos clave como volumen, precios y liquidez diaria.
- Permite construir herramientas de análisis y dashboards sin depender de interfaces como tribaldex.com.
- Democratiza el acceso a información crítica que antes solo unos pocos podían recopilar.
🗂 Estructura del Índice
Los datos se almacenan así:
{
"tokenPair": "AFIT:AFITX",
"baseQuantity": "2640357.59",
"baseVolume": "41742999.59",
"basePrice": "0.00050848",
...
"isoDate": "2025-04-06T00:00:03.000Z"
}
Se organiza en carpetas por par de tokens. Cada archivo JSON representa un snapshot del día bajo esta convención:
ts_[timestamp].json
🔧 Cómo Funciona
- 🕸️ Consulta diaria a un nodo RPC con
axios. - 🔄 Job cron programado cada 24h para obtener y almacenar datos.
- 🧪 Algoritmo de selección de nodo RPC más rápido antes de cada fetch.
- 🖥 Backend con
Node.js,Express,TypeScripty documentación conSwaggerJS.
🔓 API Libre y Útil
Actualmente, toda la API está abierta al público, manteniendo el ideal descentralizado de Hive. Algunas rutas internas están protegidas por login con Hive Keychain para tareas administrativas.
💡 ¿Qué Puedes Crear con Estos Datos?
- Dashboards visuales para analizar cambios de volumen y liquidez.
- Simuladores de inversión usando data real.
- Alertas automáticas de actividad en pools.
🛠 Tecnología Utilizada
- Node.js + Express
- Cron Jobs
- SwaggerJS
- Hive Keychain (firma segura desde frontend)
- VPS personal con almacenamiento en carpetas navegables
👥 Apoyo de la Comunidad
Este proyecto ha recibido soporte moral y difusión por parte de miembros como:
Gracias a ello, el índice ha empezado a destacarse como una herramienta seria para desarrolladores.
🌱 Futuro del Proyecto
- Crear dashboards integrados.
- Extender API a visualizadores externos.
- Automatizar alertas o reportes mensuales.
🔗 Repositorio y Sitio de Pruebas
- GitHub: hive-liquidity-pools-data-index
- Live: testhivelpindex.duckdns.org
🧩 Ideas de Aplicaciones con Este Índice
- Comparadores de volumen diario entre pares de tokens
- Alertas automáticas de cambios bruscos en precios o liquidez
- Visualizadores de ROI potencial basado en snapshots históricos
- Bots para traders que detecten anomalías o tendencias
🛠 Ejemplo de Consulta a la API (JavaScript)
const pair = "BRO-SWAP.HIVE";
const response = await fetch(`https://testhivelpindex.duckdns.org/public/data-pool?tokenPair=AFIT%3AAFITX`);
const data = await response.json();
console.log(data);
🔒 Seguridad y Filosofía
Este índice es 100% público y transparente, sin almacenar información sensible ni requerir claves privadas. Promueve el acceso libre y fomenta el desarrollo de herramientas sobre datos confiables y accesibles.
📊 Métricas Iniciales del Proyecto
- Más de 70 pares de tokens indexados
- Snapshots diarios desde marzo 2024
- Uptime del servidor superior al 99.9%
- Arquitectura abierta y modular para extender fácilmente
💬 Participa y Propón Ideas
Tu feedback es clave. Si tienes ideas o mejoras:
📷 Vista de Aplicación Propuesta
Un simulador de posiciones de liquidez con visualización de evolución de ROI y variables clave en el tiempo:
📕 English Version
CLICK HERE to see english
🧪 Hive Liquidity Pools Data Index
🚀 Project Motivation
Hive has many useful layer-2 tools, but until now, there was no open and structured way to access daily trading data from its liquidity pools. This index was created to fill that gap.
It provides a browsable, JSON-based folder structure storing daily snapshots of all pools' data.
🧠 What Problem Does It Solve?
- Offers open access to vital data like volume, price, and liquidity.
- Enables creation of dashboards and tools independent from UIs like tribaldex.com.
- Promotes transparency and decentralization through free access.
🗂 Index Structure
Snapshot example:
{
"tokenPair": "AFIT:AFITX",
"baseQuantity": "2640357.59",
"baseVolume": "41742999.59",
"basePrice": "0.00050848",
...
"isoDate": "2025-04-06T00:00:03.000Z"
}
Files follow a format like:
ts_[timestamp].json
Organized by token pair, and updated daily.
🔧 How It Works
- 🕸️ Daily fetch from a Hive RPC node using
axios. - 🔄 Scheduled cron job every 24 hours.
- 🧪 Node selector determines fastest available RPC before fetching.
- 🖥 Built with
Node.js,Express,TypeScriptand documented viaSwaggerJS.
🔓 Open and Public API
The API is free to use — in the spirit of Hive’s decentralization values. Admin routes are minimal and protected via Hive Keychain-based login.
💡 What Can You Build With This?
- Dashboards to monitor liquidity trends.
- Investment simulators using real and simulated data.
- Automated alerts and data extractors.
🛠 Tech Stack
- Node.js + Express
- Cron Jobs
- SwaggerJS
- Hive Keychain frontend integration
- VPS-based file index system
👥 Community Support
Special thanks to:
This helped give the project visibility and momentum among developers.
🌱 What’s Next?
- Build real dashboards.
- Provide integration examples.
- Add automatic monthly summaries.
🔗 Repository and Demo Site
- GitHub: hive-liquidity-pools-data-index
- Live: testhivelpindex.duckdns.org
🧩 Application Ideas with This Index
- Daily volume comparers between token pairs
- Automatic alerts of sharp changes in prices or liquidity
- Potential ROI viewers based on historical snapshots
- Bots for traders that detect anomalies or trends
🛠 API Query Example (JavaScript)
const pair = "BRO-SWAP.HIVE";
const response = await fetch(`https://testhivelpindex.duckdns.org/api/pools/${pair}/latest`);
const data = await response.json();
console.log(data);
🔒 Security and Philosophy
This index is 100% public and transparent, storing no private keys or sensitive user data. It empowers open development and fosters trust through reliable on-chain data.
📊 Initial Project Metrics
- Over 70 token pairs indexed
- Daily snapshots since March 2024
- Server uptime above 99.9%
- Modular and open-source backend
💬 Get Involved
Your feedback matters! Share your ideas or improvements:
📷 Proposed App: Liquidity Position Simulator
A simulator to visualize ROI progression, usability, and incentive trends based on real snapshot data.