Panel de control de operaciones de Hyperliquid
Un panel de control para operaciones de grandes inversores, liquidaciones y tokens en tendencia de Hyperliquid, en tiempo real, que utiliza Hypercore gRPC de Quicknode.
Resumen
Esta aplicación de ejemplo transmite todas las operaciones de Hyperliquid a través de Hypercore gRPC de Quicknode y las filtra para detectar operaciones de grandes inversores, liquidaciones y tokens en tendencia. La transmisión bidireccional gRPC proporciona datos con una latencia inferior a un segundo, sin necesidad de realizar consultas periódicas.
Si quieres ver un tutorial en vídeo sobre cómo crear la aplicación, echa un vistazo a nuestro vídeo
Arquitectura
Quicknode Hypercore gRPC
(transmisión de todas las operaciones)
│
▼
┌─────────────────┐
│ Trabajador │
│ Filtro + Agregado │
└────────┬────────┘
│
┌────────────┼────────────┐
▼ ▼ ▼
Grandes inversores Liquidaciones Tendencias
(≥50 000 $) (intervalos de 1 millón)
│ │ │
└────────────┼────────────┘
▼
┌─────────────────┐
│ PostgreSQL │
└────────┬────────┘
│
▼
┌─────────────────┐
│ Next.js │
│ [15 m/30 m/1 h] │
└────────┬────────┘
│
▼
┌─────────────────┐
│ Panel de control │
└─────────────────┘
Características
- Detección de operaciones de gran volumen (valor nocional≥ 50 000 $, configurable)
- Seguimiento de liquidaciones con metadatos completos (usuario, precio de referencia, método)
- Tokens más populares clasificados por número de operaciones, con desglose de compras y ventas
- Filtrado por intervalos de tiempo (15 min, 30 min, 1 h)
- Seguimiento personalizado de monedas: cualquier token de Hyperliquid
- Gráficos de volumen con indicadores de tendencia
- Enlaces directos de Explorer para la verificación de transacciones
- Intervalos de agregación de 1 minuto para consultas de tendencias eficientes
Requisitos previos
- Node.js 20+ instalado
- Para una instancia de PostgreSQL, puedes utilizar una plataforma como Aiven para poner en marcha una instancia alojada. La necesitaremos para
DATABASE_URL. - Cuenta de Quicknode con el punto final gRPC de Hypercore. Lo necesitaremos para
GRPC_ENDPOINTyAUTH_TOKEN.
Primeros pasos
1. Clonar e instalar
git clone https://github.com/quiknode-labs/qn-guide-examples.git
cd qn-guide-examples/sample-dapps/hyperliquid-trading-dashboard
npm instalar
2. Iniciar PostgreSQL
Si utilizas una instancia alojada de PostgreSQL, omite este paso.
npm ejecutar db:up
3. Configurar el entorno
export DATABASE_URL="postgresql://postgres:postgres@localhost:5432/hypercore"
export GRPC_ENDPOINT="tu-punto-final.hype-mainnet.quiknode.pro:10000"
export AUTH_TOKEN="tu_token_de_quicknode"
Nota: Solo tienes que pegar esto con los valores correspondientes en dos ventanas de terminal. Necesitarás una ventana para la aplicación Next.js y otra para el proceso de la base de datos.
4. Inicializar la base de datos
npm ejecutar db:push
5. Iniciar el proceso de trabajo
npm ejecutar worker
Esto inicia el proceso de trabajo que:
- Se conecta a Quicknode HyperCore gRPC
- Retransmite eventos de trading en directo
- Almacena operaciones sin procesar y datos agregados en PostgreSQL
- Realiza un seguimiento de la actividad de las ballenas y de las liquidaciones
Deberías ver:
Ping ok: { count: 1 }
Ingester running
WHALE_MIN_USD: 50000
6. Iniciar el panel de control
npm ejecutar dev
Visita http://localhost:3000
Base de datos
PostgreSQL con Prisma ORM. Dos tablas:
TradeEvent- Operaciones y liquidaciones de grandes inversoresTradeAggMinute- Agregaciones por minuto para el análisis de tendencias
Comandos habituales:
npm ejecutar db:up # Iniciar el contenedor de PostgreSQL
npm ejecutar db:push # Aplicar el esquema
npm run db:studio # Abrir Prisma Studio
Puntos de conexión de la API
GET /api/whales?coin=BTC&windowMin=15&thresholdUsd=50000- Operaciones de los «grandes inversores»GET /api/liquidations?windowMin=15- LiquidacionesGET /api/trending?windowMin=15- Monedas en augeGET /api/sparklines?windowMin=15&coins=BTC,ETH,SOL- Gráficos de volumenGET /api/health- Revisión médica
Vista previa
Más información
- Hacer un fork del repositorio
- Crear una rama de características:git checkout -b feature/amazing-feature
- Guarda los cambios:git commit -m "Añadir una función increíble"
- Envía tu rama:git push origin feature/amazing-feature
- Abre una solicitud de incorporación de cambios.
