Resumen
SQL Explorer te ofrece acceso directo mediante SQL a miles de millones de filas de datos indexados de la cadena de bloques, sin necesidad de gestionar la infraestructura. Consulta operaciones, órdenes, posiciones, liquidaciones y mucho más utilizando SQL estándar, todo ello dentro de la misma plataforma que ya utilizas para RPC y Streams.
SQL Explorer se encuentra actualmente en fase beta. Estamos ampliando activamente la cobertura de los conjuntos de datos e incorporando nuevas funciones basándonos en los comentarios de los usuarios.
Instala la Skill de Quicknode para que tu agente domine SQL Explorer y la plataforma Quicknode en su conjunto:
Habilidades de npx añadir quiknode-labs/blockchain-skills
Para generar consultas SQL, descarga el esquema legible por máquina e inclúyelo en el contexto de tu agente. Consulta la Referencia de esquemas para obtener más detalles.
¿Por qué SQL Explorer?
SQL Explorer permite realizar consultas flexibles en datos de la cadena de bloques indexados mediante SQL estándar. En lugar de depender de puntos finales de API predefinidos, puedes escribir consultas personalizadas directamente sobre los conjuntos de datos subyacentes.
Características principales:
- Sin necesidad de gestionar infraestructura: consulta datos de la cadena de bloques mediante SQL sin necesidad de ejecutar nodos, bases de datos ni indexadores
- Flexibilidad total en las consultas: escribe consultas SQL con sintaxis estándar, incluyendo funciones, subconsultas, funciones de ventana y uniones.
- Diseñado para la escalabilidad: las consultas se ejecutan sobre miles de millones de filas utilizando un almacenamiento columnar con optimización adaptada a las particiones
- Totalmente integrado: disponible junto con RPC, Streams y otros productos de Quicknode en la misma plataforma
Características de SQL Explorer
SQL Explorer incluye herramientas para consultar, analizar e integrar datos de la cadena de bloques:
- Editor de SQL: Editor integrado en el navegador con resaltado de sintaxis y compatibilidad con SQL estándar, incluidas las subconsultas, las funciones de ventana,
AGRUPAR POR, yÚNETE - Navegador de esquemas: Visualiza los metadatos de las tablas, incluyendo el número de filas, los nombres de las columnas, los tipos de datos, las claves de ordenación (⚡) y las estrategias de partición. Consulta la Referencia de esquemas para obtener la documentación completa.
- Consultas predefinidas: consultas listas para usar para casos de uso habituales en las cadenas compatibles
- Visualización: Genera gráficos con ejes configurables, superposiciones de varias series e información emergente al pasar el cursor por encima.
- Acceso a la API REST: Ejecutar consultas mediante programación a través de POST a
https://api.quicknode.com/sql/rest/v1/querymediante autenticación con clave API - Generador de consultas: Genera llamadas a la API REST (cURL) desde la interfaz de usuario para cualquier consulta
- Biblioteca de consultas guardadas: guarda tus consultas más habituales para acceder a ellas rápidamente
- Métricas de ejecución: Ver el tiempo de ejecución de la consulta, las filas devueltas, las filas analizadas y los bytes procesados para cada consulta
Cómo acceder a SQL Explorer
Se puede acceder a SQL Explorer a través de varios métodos:
- Panel de control: consultas interactivas con visualización en tu navegador
- API REST: Solicitudes HTTP directas para el acceso programático
- SDK: Cliente tipado para aplicaciones de Node.js, Python, Rust y Ruby
- CLI: Comandos de terminal para scripts y consultas rápidas
Cómo utilizar el panel de control
El panel de control de Quicknode ofrece un entorno interactivo para crear, probar y visualizar consultas SQL:
- Abre SQL Explorer en tu panel de control de Quicknode
- Navega por la pestaña «Tablas» para explorar los conjuntos de datos disponibles, ver los detalles del esquema o seleccionar una consulta predefinida en la pestaña «Consultas ».
- Escribe una nueva consulta o modifica una consulta predefinida en el editor
- Haz clic en «Ejecutar » para ejecutar tu consulta
- Consulta los resultados en la pestaña «Resultados» o pasa a la pestaña «Gráficos» para visualizarlos.
- Haz clic en «Guardar» para guardar la consulta, o en «API» para generar la solicitud REST correspondiente
Uso de la API REST
La API REST te permite ejecutar consultas SQL mediante programación.
Las consultas SQL se ejecutan mediante una solicitud HTTP POST a https://api.quicknode.com/sql/rest/v1/query utilizando tu clave API de Quicknode. Los resultados se devuelven en formato JSON junto con las estadísticas de ejecución de la consulta.
Obtén la llamada a la API desde el panel de control:
Después de ejecutar una consulta en el panel de control de SQL Explorer, haz clic en «API» en la parte superior para generar una solicitud cURL lista para usar que incluya tu consulta.
Ejemplo de solicitud:
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT time, validator, reward, block_number FROM hyperliquid_validator_rewards ORDER BY block_number DESC LIMIT 100",
"clusterId": "hyperliquid-core-mainnet"
}'
Ejemplo de respuesta:
{
"meta": [
{
"name": "time",
"type": "DateTime64(6, 'UTC')"
}
],
"data": [
{
"time": "2026-03-30 16:24:00.058516",
"validator": "0xf8efb4cb844a8458114994203d7b0bfe2422a288",
"reward": 0.18548686,
"block_number": 940269912
},
{
"time": "2026-03-30 16:24:00.058516",
"validator": "0xeeee86f718f9da3e7250624a460f6ea710e9c006",
"reward": 0.50774076,
"block_number": 940269912
}
],
"rows": 100,
"rows_before_limit_at_least": 120,
"statistics": {
"elapsed": 0.073805665,
"rows_read": 71918,
"bytes_read": 5322148
}
}
Comprender la respuesta:
La respuesta de la API contiene los siguientes campos:
meta: Matriz de metadatos de columnas connombreytipopara cada columna del conjunto de resultadosdatos: Matriz de objetos que contiene los resultados reales de la consulta, en la que cada objeto representa una filafilas: Número de filas devueltas en esta respuestafilas_antes_del_límite_como_mínimo: Número total de filas que coincidían con la consulta antes de aplicar LIMIT (útil para la paginación)estadísticas: Indicadores de rendimiento para la optimización de consultas:transcurrido: Tiempo total de ejecución de la consulta en segundosfilas_leídas: Número total de filas analizadas durante la ejecución (puede ser superior al número de filas devueltas debido a los filtros)bytes_read: Total de datos analizados en bytes (útil para comprender el coste de las consultas y las oportunidades de optimización)
Utiliza el estadísticas campos para comprender el rendimiento de las consultas y optimizar los escaneos. Menor filas_leídas y bytes_read por lo general, indican consultas más eficientes.
Consulta la guía «Descripción general de la API REST» para obtener instrucciones detalladas, información sobre la configuración de la autenticación y ejemplos.
Uso del SDK
El SDK de Quicknode ofrece acceso tipado a SQL Explorer desde Node.js, Python, Rust y Ruby. Utiliza el sql cliente para ejecutar consultas y recuperar esquemas.
Ejemplo (Node.js):
import { QuicknodeSdk } from "@quicknode/sdk";
const qn = new QuicknodeSdk();
// Run a SQL query
const resp = await qn.sql.query(
"SELECT action_type, user FROM hyperliquid_system_actions LIMIT 3",
"hyperliquid-core-mainnet"
);
console.log(`${resp.rows} rows, ${resp.credits} credits`);
// Get the schema for a cluster
const schema = await qn.sql.getSchema("hyperliquid-core-mainnet");
Consulta la documentación del SDK para obtener información sobre la instalación y la configuración de la autenticación.
Uso de la CLI
La CLI de Quicknode ofrece comandos de terminal para consultas SQL y la recuperación de esquemas.
Ejecuta una consulta:
Consulta SQL "SELECT * FROM hyperliquid_trades LIMIT 10" --cluster hyperliquid-core-mainnet
Consigue el esquema:
Esquema SQL de qn --clúster hyperliquid-core-mainnet
Consulta la documentación de la CLI para obtener información sobre la instalación y la configuración de la autenticación.
Los resultados de la consulta se limitan a 1000 filas por solicitud. Para conjuntos de resultados más grandes, utiliza LÍMITE y DESPLAZAMIENTO cláusulas para navegar por los resultados. Consulta la Guía de paginación para ver ejemplos completos y buenas prácticas.
Explora el «SQL Explorer Cookbook», donde encontrarás más de 40 consultas predefinidas que abarcan la actividad de los monederos, las recompensas de los validadores, las liquidaciones y mucho más. Cada ejemplo incluye parámetros personalizables y código listo para usar en SQL, cURL, TypeScript y Python.
Facturación
SQL Explorer utiliza los créditos de API de tu cuenta de Quicknode. El consumo de créditos se calcula en el servidor en función de los recursos que consume cada consulta:
- Tiempo de ejecución de las consultas: las consultas que tardan más en ejecutarse tienen un coste mayor, con una tarifa progresiva para las consultas que superen los 250 ms y los 2 segundos.
- Datos leídos: las consultas que leen más bytes del disco se facturan en consecuencia
- Tarifa base: cada consulta conlleva un cargo mínimo en créditos para cubrir los costes fijos de infraestructura
Cada respuesta de la API incluye el coste del crédito en el Créditos X encabezado de respuesta, junto con las estadísticas de ejecución (transcurrido, filas_leídas, bytes_read) en el cuerpo de la respuesta para que puedas supervisar y optimizar los costes de las consultas.
Consejos para reducir el uso del crédito:
- Filtrar por
usuariosiempre que sea posible —esto permite aprovechar las proyecciones ya clasificadas para realizar búsquedas rápidas— - Uso
LÍMITEpara limitar el tamaño del resultado - Correr
EXPLICARpara obtener una vista previa del plan de consulta antes de ejecutar consultas que consumen muchos recursos
Puedes consultar el uso de tus créditos en el panel de control de Quicknode.
Redes compatibles
SQL Explorer admite actualmente las siguientes cadenas; próximamente se añadirán otras:
| Cadena | Red | Tablas | Total de filas | Cobertura |
|---|---|---|---|---|
| Hiperlíquido | Red principal | Ver esquema | Más de mil millones+ | Operaciones, órdenes, ejecuciones, financiación, diferencias en el libro de órdenes, mercados perpetuos, mercados al contado, bloques, transacciones, acciones del sistema, actividad del generador, staking, libro mayor, estados de la cámara de compensación, precios de los oráculos, subcuentas, activos de la caja fuerte, agentes, eventos de puente, nombres de visualización, transferencias de activos, estados de TWAP, referencias, recompensas para validadores, recompensas para delegadores, resúmenes, métricas y mucho más |
Esquema disponible
SQL Explorer ofrece una cobertura exhaustiva de Hyperliquid HyperCore con miles de millones de filas de datos indexados repartidos en múltiples tablas, entre las que se incluyen operaciones, órdenes, ejecuciones, financiación, datos de mercado y mucho más.
Consulta la referencia completa del esquema para conocer las definiciones de las columnas, los tipos de datos, las claves de ordenación y los detalles de partición. El esquema se actualiza y optimiza continuamente para facilitar la realización de consultas.
Preguntas frecuentes
¡Nos encanta recibir comentarios!
Si tienes algún comentario o pregunta sobre esta documentación, háznoslo saber. ¡Nos encantaría saber tu opinión!