RPC hiperlíquido
Descripción general de Hyperliquid
Hyperliquid es una cadena de bloques diseñada para el comercio en cadena, con una velocidad y unas comisiones que se acercan al rendimiento de las plataformas de intercambio centralizadas. La arquitectura consta de dos componentes interconectados:
HyperCore: el motor de libro de órdenes en cadena que gestiona la ejecución de operaciones y proporciona datos de mercado. HyperCore ofrece múltiples flujos de datos en tiempo real a través de las API gRPC, JSON-RPC/HTTP y WebSocket, y la disponibilidad de los protocolos varía según el tipo de flujo (véase «Flujos de datos disponibles» más abajo).
HyperEVM: una capa de ejecución compatible con EVM para el despliegue y la interacción de contratos inteligentes. Los desarrolladores pueden lanzar nuevas clases de activos, crear «vaults» de estrategias de negociación, desarrollar protocolos DeFi y gestionar activos digitales utilizando los métodos JSON-RPC estándar de Ethereum. HyperEVM es compatible con todas las principales herramientas de desarrollo de Ethereum, entre las que se incluyen Foundry, Hardhat, Web3.js, Ethers.js y Viem.
Ambos componentes funcionan bajo el consenso HyperBFT (basado en HotStuff) y utilizan el token nativo HYPE para las comisiones de transacción.
Primitivas de mercado de HyperCore
Hyperliquid define distintos tipos de mercado a través de las Propuestas de Mejora de Hyperliquid (HIP):
- HIP-1 - Mercados perpetuos: Futuros perpetuos en cadena con modos de margen aislado y cruzado. Los pares de futuros perpetuos aparecen como símbolos simples (p. ej.,
BTC,ETH) en la API. - HIP-2 - Listados de tokens en Spot: Mercados al contado nativos para tokens desplegados por los usuarios. Los pares al contado utilizan
@índicenotación (p. ej.,@107) en la API. - HIP-3 - Perpetuos implementados por el generador: Los desarrolladores independientes pueden implementar su propio DEX perpetuo en HyperCore con libros de órdenes y garantías independientes. Para consultar los DEX de los desarrolladores, hay que pasar el
dexparámetro a los puntos finales de información; utilizaperpDexspara mostrar todos los que están activos. - HIP-4 - Mercados de resultados: Contratos de resultado totalmente garantizados (binarios y de precios múltiples) cuya liquidación se realiza dentro de un rango de precios fijo. Binarios (
priceBinary) los mercados se cierran con «Sí» o «No»; de precios múltiples (priceBucket) Los mercados de preguntas agrupan múltiples resultados binarios en tramos de precios, de modo que solo uno de ellos se liquida como «Sí». Las partes de los resultados utilizan#Nnotación (p. ej.,#0para Sí,#1(para el número del primer resultado). VéaseoutcomeMetapara el punto final «info».
Acceso a /hypercore (JSON-RPC y WebSocket) y la transmisión mediante HyperCore gRPC requiere un Plan «Quicknode Build» o superior. Ver precios para actualizar.
Interacción con las API de Hyperliquid
HyperCore e HyperEVM son componentes de protocolo nativos de Hyperliquid disponibles a través de cualquier proveedor de infraestructura. Quicknode proporciona acceso gestionado a ambas capas a través de un único punto de conexión, encargándose de la infraestructura de los nodos, la fiabilidad y el rendimiento. Además de las API nativas, Quicknode ofrece productos complementarios: Streams (entrega de eventos de HyperEVM basada en push), Webhooks (notificaciones de eventos HTTP), SQL Explorer (consultas SQL sobre datos indexados de Hyperliquid), SDK de la comunidad y complementos del Marketplace.
Quicknode permite acceder a ambos componentes de Hyperliquid a través de API especializadas diseñadas para distintos casos de uso:
API de HyperEVM
HyperEVM es compatible con los métodos JSON-RPC estándar de Ethereum, lo que permite a los desarrolladores utilizar herramientas habituales de Ethereum, como Foundry, Hardhat y las bibliotecas Web3, sin necesidad de modificarlas. Se puede acceder a HyperEVM a través de dos vías específicas:
/evm ruta - Operaciones estándar de la cadena de bloques, como saldos de cuentas, consultas de transacciones, llamadas a contratos inteligentes (eth_call), estimación del gas y difusión de transacciones. Esta ruta está diseñada para operaciones de lectura y consultas de alta frecuencia. Nota: El /evm El punto final solo conserva los datos de los bloques recientes y no permite el acceso a los archivos históricos. Las consultas sobre bloques anteriores al periodo de retención devolverán errores. Utiliza /nanoreth para satisfacer las necesidades de datos históricos.
/nanoreth ruta - Ofrece todos los métodos estándar, además de funciones avanzadas de depuración (debug_traceTransaction, debug_storageRangeAt), seguimiento de transacciones (trace_transaction, trace_block, trace_filter), compatibilidad con WebSocket para eventos de la cadena de bloques en tiempo real y un archivo completo de datos históricos. Esta ruta también admite consultas históricas de eth_call en cualquier bloque, mientras que /evm solo admite el último bloque.
Compatible con: Foundry, Hardhat, Truffle, Web3.js, Ethers.js, Viem, Metamask y todos los marcos de desarrollo estándar de Ethereum.
Debido a las diferencias arquitectónicas de Hyperliquid, es posible que algunos métodos RPC se comporten de forma diferente a como lo hacen en Ethereum. Recomendamos consultar la documentación oficial de Hyperliquid para conocer las últimas actualizaciones.
Integración entre capas: los contratos inteligentes en HyperEVM pueden leer los precios del oráculo HyperCore. Consulta nuestra guía sobre cómo acceder a los datos de HyperCore desde los contratos.
API de HyperCore
HyperCore ofrece acceso en tiempo real y a datos históricos de las bolsas a través de múltiples protocolos API:
Punto final de información (/info path) - Consulta datos exhaustivos del mercado, posiciones de los usuarios, estado de las órdenes, historial de operaciones, información sobre la cartera e información sobre el estado de la plataforma a través de 52 métodos especializados que abarcan los mercados perpetuos y al contado. Quicknode's /info El punto final admite de forma nativa 50 de los 52 métodos; consulta el Página de puntos finales Para más información.
API REST: operaciones de negociación (creación y envío de órdenes con firmas), gestión de la aprobación de comisiones de los creadores, información de mercado (lista de mercados/DEX, órdenes abiertas, estado de las órdenes) y validación de órdenes (preflight). Permite gestionar el ciclo de vida de las órdenes, desde la creación de acciones sin firmar hasta el envío de transacciones firmadas, con puntos de conexión mejorados para comprobar el estado de las aprobaciones y consultar datos enriquecidos sobre las órdenes.
Si estás en un plan de prueba gratuito, te proporcionamos una URL para que la utilices, pero no es específica de tu cuenta de Quicknode. Consulta hyperliquidapi.com para obtener más detalles y nuestro Discord para recibir asistencia.
JSON-RPC/HTTP (/hypercore path) - Consultas de datos históricos de la bolsa (hl_getLatestBlocks, hl_getBlock, hl_getBatchBlocks) para la recuperación de datos históricos y el procesamiento por lotes de hasta 200 bloques por solicitud, además de consultas sobre el estado de carteras y de la cámara de compensación (hl_portfolioState, hl_batchClearinghouseStates, hl_batchPortfolioStates) para recuperar posiciones, saldos y datos de margen de uno o varios usuarios, así como consultas de datos de órdenes (hl_batchOpenOrders) para recuperar órdenes abiertas de hasta 100 usuarios en una sola solicitud.
Transmisión gRPC (puerto 10000) - Transmisión bidireccional con una latencia inferior a un milisegundo para datos de mercado. Admite las trece fuentes de datos con compresión zstd nativa (que reduce el ancho de banda en aproximadamente un 70 %), entre las que se incluyen StreamL2Book (profundidad agregada) y StreamL4Book (orden individual) con instantáneas integradas. Adecuado para creadores de mercado, sistemas de negociación algorítmica y aplicaciones de análisis en tiempo real que requieran baja latencia.
WebSocket (/hypercore/ws path) - Suscripciones en tiempo real compatibles con navegadores mediante bibliotecas WebSocket estándar. Protocolo basado en JSON con los métodos hl_subscribe y hl_unsubscribe. Admite seis flujos de datos (OFICIOS, PEDIDOS, NOVEDADES SOBRE EL LIBRO, TWAP, EVENTOS, ACCIONES_DEL_ESCRITOR). BLOQUES y el OrderBookStreaming métodos (StreamL2Book, StreamL4Book, StreamBboBook, StreamL2BookDiff, StreamL4BookUpdates, StreamTpslUpdates) funcionan exclusivamente con gRPC. Son adecuadas para paneles de control de operaciones en línea, monitores de precios y herramientas de seguimiento de carteras.
Flujos de datos disponibles
| Transmisión | Descripción | gRPC | WebSocket | JSON-RPC |
|---|---|---|---|---|
| OFICIOS | Operaciones ejecutadas con información sobre «maker» y «taker» | ✓ | ✓ | ✓ |
| PEDIDOS | Eventos del ciclo de vida de los pedidos (más de 18 tipos de estado) | ✓ | ✓ | ✓ |
| NOVEDADES SOBRE EL LIBRO | Variaciones incrementales en la cartera de pedidos | ✓ | ✓ | ✓ |
| TWAP | Datos de ejecución del algoritmo TWAP | ✓ | ✓ | ✓ |
| EVENTOS | Variaciones en el saldo, transferencias, liquidaciones | ✓ | ✓ | ✓ |
| ACCIONES_DEL_ESCRITOR | Datos del puente HyperCore ↔ HyperEVM | ✓ | ✓ | ✓ |
| BLOQUES | Datos sin procesar de la cadena de bloques (replica_cmds) | ✓ | - | - |
| StreamL2Book | Profundidad agregada del nivel de precios (instantánea completa en cada bloque) | ✓ | - | - |
| StreamL4Book | Libro de órdenes individual (instantánea + diferencias por bloque) | ✓ | - | - |
| StreamBboBook | Mejor precio de compra/venta en la parte superior del libro de órdenes; se muestra únicamente cuando cambia el BBO | ✓ | - | - |
| StreamL2BookDiff | Variaciones incrementales del nivel de precios en L2 con números de secuencia por moneda | ✓ | - | - |
| StreamL4BookUpdates | Diferencias de adición, actualización y eliminación clasificadas por tipo de pedido | ✓ | - | - |
| StreamTpslUpdates | Actualizaciones de alta y baja de órdenes con nivel de activación (TP/SL) con instantánea de las órdenes abiertas | ✓ | - | - |
| MEMPOOL_TXS | Transacciones pendientes en el mempool | ✓ | - | - |
Todas las transmisiones permiten filtrar por direcciones de usuario, pares de negociación y otros criterios. Los límites de filtrado varían según el nivel del plan.
Más información sobre los flujos de datos y el filtrado de HyperCore.
Datos indexados y análisis
Para cargas de trabajo analíticas que abarcan amplios intervalos de tiempo, como métricas agregadas, operaciones históricas, tasas de financiación e historial de liquidaciones, Quicknode ofrece productos indexados y basados en eventos que complementan las API nativas mencionadas anteriormente.
- SQL Explorer: Consulta datos de Hyperliquid preindexados con SQL estándar, sin necesidad de crear ni mantener un proceso de indexación. Consulta los ejemplos de consultas de Hyperliquid y la referencia de esquemas para empezar.
- Flujos: Entrega mediante push de datos de HyperEVM, tanto en tiempo real como históricos, a tus propios destinos, con garantía de entrega única y filtrado personalizado.
- Webhooks: Activa notificaciones HTTP ante eventos de HyperEVM para impulsar flujos de trabajo basados en eventos.
Utiliza SQL Explorer para realizar análisis ad hoc e históricos, y utiliza Streams o Webhooks para la entrega continua de datos basada en eventos.
SDK compatibles
Quicknode mantiene SDK comunitarios de código abierto para Hyperliquid en varios lenguajes. Estos SDK se encargan de la creación, la firma y el envío de transacciones para las operaciones de negociación de HyperCore y las interacciones con HyperEVM.
Estos SDK de código abierto los desarrolla y mantiene Quicknode. Están orientados a la comunidad y no están afiliados, respaldados ni asociados a Hyperliquid Foundation ni a Hyperliquid Labs.
SDK disponibles:
- Python - hyperliquid-sdk en PyPI
- TypeScript/JavaScript - @quicknode/hyperliquid-sdk en npm
- Rust - quicknode-hyperliquid-sdk en crates.io
- Go: disponible en el repositorio del SDK
Todos los SDK son de código abierto y están disponibles en GitHub. Los SDK se integran con los puntos de conexión de Quicknode para acceder a /info, /intercambio, /evm, /nanoreth, /hypercore, y flujos gRPC. Se pueden utilizar con o sin un punto final de Quicknode.
Para consultar la documentación detallada del SDK, ejemplos y guías de configuración, visita la página «SDK y bibliotecas ».
Realizar llamadas a la API de Hyperliquid
Para empezar a desarrollar en Hyperliquid, crea un punto de conexión de Quicknode y accede a los servicios HyperEVM e HyperCore.
Quicknode ofrece una infraestructura gestionada de Hyperliquid, lo que te permite acceder a ambos componentes sin necesidad de ejecutar tus propios nodos. Estos puntos de conexión ofrecen:
- Fiabilidad: infraestructura distribuida a nivel mundial para minimizar el tiempo de inactividad
- Rendimiento: baja latencia y gestión de solicitudes para aplicaciones de producción
- Acceso de dos componentes - Un único punto de acceso permite acceder tanto a HyperEVM (contratos inteligentes a través de
/evmy/nanoreth) e HyperCore (intercambio de datos a través de/hypercoreHTTP/WebSocket y gRPC) - Compatibilidad con múltiples protocolos: HTTP, WebSocket y transmisión gRPC
- Integración en el ecosistema: productos complementarios como Streams, Webhooks y SQL Explorer. Para más detalles, consulta la sección «Datos indexados y análisis» más arriba.
Visita la página de inicio rápido para crear tu punto final y enviar tu primera solicitud.
Redes compatibles
Quicknode ofrece acceso a las siguientes redes de Hyperliquid:
*Política de poda:
/evm → Solo datos recientes. El /evm El punto final no permite el acceso a archivos: los datos de bloques más antiguos se eliminan periódicamente (aproximadamente cada 12 horas). Las solicitudes de bloques que se encuentren fuera del periodo de retención devolverán un altura de bloque no válida error. Utiliza /nanoreth para consultas históricas.
/nanoreth → Archivo histórico completo con soporte de seguimiento. Incluye todos los métodos de depuración y seguimiento, además de la funcionalidad WebSocket.
- Red principal: Archivo histórico completo
- Red de pruebas: Comienza a partir del bloque 34112653 (no es el bloque génesis)
Disponibilidad de datos de HyperCore:
/info (HTTP) - Datos completos del mercado e información sobre los usuarios a través de 52 métodos de información (meta, clearinghouseState, userFills, l2Book, portfolio, etc.)
API REST - Operaciones de negociación (crear/enviar órdenes, cancelar, modificar), gestión de comisiones de los creadores (aprobar/revocar), consultas de mercado (listado de mercados/DEX, órdenes abiertas, estado de las órdenes) y validación de órdenes (preflight)
/hypercore (HTTP) - Consultas de bloques históricos (hl_getLatestBlocks, hl_getBlock, hl_getBatchBlocks), consultas sobre el estado de carteras y cámaras de compensación (hl_portfolioState, hl_batchClearinghouseStates, hl_batchPortfolioStates) y consultas de datos de órdenes (hl_batchOpenOrders)
/hypercore/ws (WebSocket) - Transmisión en tiempo real de 6 flujos de datos (TRADES, ORDERS, BOOK_UPDATES, TWAP, EVENTS, WRITER_ACTIONS)
gRPC - Transmisión en tiempo real de las 13 secuencias de datos con compatibilidad con la compresión zstd
HyperEVM: /evm (solo HTTP) • /nanoreth (HTTP + WebSocket + seguimiento/depuración)
HyperCore: /info (52 métodos de información) • /hypercore/.. API REST (consultas sobre operaciones y mercados) • /hypercore (consultas de bloques históricos) • /hypercore/ws WebSocket (6 flujos) • gRPC (13 flujos, incluidos StreamL2Book/StreamL4Book + compresión)
Más información sobre los terminales HyperEVM e HyperCore
Disponibilidad de la API por red
| API / Punto de conexión | Red principal | Red de pruebas |
|---|---|---|
| Punto final de información de HyperCore (/info) | ✓ | ✓ |
| API de HyperCore Exchange (/hypercore/*) | ✓ | ✗ |
| HyperCore JSON-RPC/WSS (/hypercore) | ✓ | ✓ |
| Transmisión gRPC (puerto 10000) | ✓ | ✓ |
| HyperEVM (/evm) | ✓ | ✓ |
| API de depuración (/nanoreth) | ✓ | ✓ |
| API de Trace (/nanoreth) | ✓ | ✓ |
Guía de referencia completa para desarrolladores que trabajan con Hyperliquid y Quicknode:
Inicio rápido
Empieza a utilizar Hyperliquid rápidamente. Sigue nuestra guía de inicio rápido paso a paso para configurar tu punto final y realizar tu primera solicitud de API.
Puntos de conexión de los proveedores
Descubre cómo configurar y gestionar tus puntos finales de Hyperliquid para obtener un rendimiento y una fiabilidad óptimos.
Descripción general de la API
Descubre las API compatibles, las redes, los productos de Quicknode y las funciones mejoradas de las API para crear aplicaciones potentes.
Mercado
Descubre e integra potentes complementos y herramientas del Quicknode Marketplace para mejorar tus aplicaciones web3.
Seguridad de los dispositivos finales
Protege tus dispositivos finales mediante la autenticación, las listas blancas y las mejores prácticas de seguridad.
Códigos de error
Conoce los códigos de error más habituales y los pasos para solucionar problemas en las solicitudes de la API de Hyperliquid.