🧪 Í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`, `TypeScript` y documentación con `SwaggerJS`.
## 🔓 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:
* @ecoinstants
* @aliento
* @thecrazygm
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](https://github.com/theghost1980/hive-liquidity-pools-data-index)
* Live: [testhivelpindex.duckdns.org](https://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)
```typescript
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](https://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:
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`, `TypeScript` and documented via `SwaggerJS`.
## 🔓 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:
* @ecoinstants
* @aliento
* @thecrazygm
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](https://github.com/theghost1980/hive-liquidity-pools-data-index)
* Live: [testhivelpindex.duckdns.org](https://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)
```typescript
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);