🧪 Í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:

• Hive account@ecoinstants
• Hive account@aliento
• Hive account@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
• 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:

👉 Abre un issue en GitHub

---

📷 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, 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:

• Hive account@ecoinstants
• Hive account@aliento
• Hive account@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
• 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:

👉 Open an issue on GitHub

---

📷 Proposed App: Liquidity Position Simulator

A simulator to visualize ROI progression, usability, and incentive trends based on real snapshot data.