Hyperliquid
Hyperliquid
Hyperliquid une blockchain conçue pour le trading sur la chaîne, dont la rapidité et les frais se rapprochent des performances des plateformes d'échange centralisées. Son architecture se compose de deux éléments interconnectés :
HyperCore - Le moteur de carnet d'ordres sur la chaîne qui gère l'exécution des transactions et fournit des données de marché. HyperCore met à disposition plusieurs streams de données en temps réel streams les API gRPC, JSON-RPC/HTTP et WebSocket, la disponibilité des protocoles variant selon le type de flux (voir Streams de données disponibles » ci-dessous).
HyperEVM - Une couche d'exécution compatible EVM destinée au déploiement et à l'interaction avec les contrats intelligents. Les développeurs peuvent lancer de nouvelles classes d'actifs, créer des coffres-forts de stratégies de trading, mettre au point des protocoles DeFi et gérer des actifs numériques à l'aide des méthodes Ethereum standard Ethereum . HyperEVM prend en charge tous les principaux outils Ethereum , notamment Foundry, Hardhat, Web3.js, Ethers.js et Viem.
Ces deux composants fonctionnent selon le protocole de consensus HyperBFT (basé sur HotStuff) et utilisent le token natif HYPE pour les frais de transaction.
Primiitives de marché HyperCore
Hyperliquid différents types de marchés par le biais des « Hyperliquid Proposals » (HIP) :
- HIP-1 - Marchés perpétuels: Contrats à terme perpétuels sur la chaîne, avec des modes de marge isolée et croisée. Les paires de contrats perpétuels apparaissent sous forme de symboles simples (par exemple,
BTC,ETH) dans l'API. - HIP-2 - Cotations de jetons Spot: Marchés au comptant natifs pour les jetons déployés par les utilisateurs. Les paires au comptant utilisent
@indexnotation (par exemple,@107) dans l'API. - HIP-3 - Contrats à durée indéterminée déployés par le développeur: Les développeurs indépendants peuvent déployer leur propre DEX perp sur HyperCore, avec des carnets d'ordres et des garanties distincts. Pour interroger les DEX des développeurs, il suffit de transmettre le
dexparamètre vers les points de terminaison d'information ; utiliserperpDexspour afficher la liste de tous ceux qui sont actifs. - HIP-4 - Marchés des résultats: Contrats à résultat entièrement garantis (binaires et à prix multiples) dont le règlement s'effectue dans une fourchette de prix fixe. Binaires (
priceBinary) les marchés se négocient à « oui » ou « non » ; à prix multiples (priceBucket) Les marchés de questions regroupent plusieurs résultats binaires en tranches de prix, de sorte qu'un seul d'entre eux soit retenu. Les parties prenantes utilisent#Nnotation (par exemple,#0pour Oui,#1pour le nombre de cas du premier résultat). VoiroutcomeMetapour le endpoint « info ».
Accès à /hypercore (JSON-RPC et WebSocket) et gRPC HyperCore gRPC nécessitent un Plan « Quicknode ou supérieur. Consulter les tarifs pour effectuer la mise à niveau.
Interagir avec les API Hyperliquid
HyperCore and HyperEVM are Hyperliquid-native protocol components available from any infrastructure provider. Quicknode provides managed access to both layers through a single endpoint, handling node infrastructure, reliability, and performance. In addition to the native APIs, Quicknode offers complementary products: Streams (push-based HyperEVM event delivery), Webhooks (HTTP event notifications), SQL Explorer (SQL queries on indexed Hyperliquid data), community SDKs, and add-ons.
Quicknode d'accéder aux deux Hyperliquid grâce à des API spécialisées conçues pour différents cas d'utilisation :
API HyperEVM
HyperEVM prend en charge les méthodes Ethereum standard Ethereum , ce qui permet aux développeurs d'utiliser sans modification Ethereum qu'ils connaissent bien, tels que Foundry, Hardhat et les bibliothèques Web3. Vous pouvez accéder à HyperEVM via deux chemins d'accès spécifiques :
/evm chemin - Opérations blockchain standard, notamment les soldes de comptes, les requêtes de transactions, les appels de contrats intelligents (eth_call), l'estimation du gas et la diffusion des transactions. Ce parcours est conçu pour les opérations de lecture et les requêtes à haute fréquence. Remarque : Le /evm endpoint que les données de blocs récentes et ne permet pas d'accéder aux archives. Les requêtes portant sur des blocs plus anciens que la période de conservation renverront des erreurs. Utilisez /nanoreth pour répondre aux besoins en données historiques.
/nanoreth chemin - Fournit toutes les méthodes standard ainsi que des fonctionnalités avancées de débogage (debug_traceTransaction, debug_storageRangeAt), le traçage des transactions (trace_transaction, trace_block, trace_filter), la prise en charge de WebSocket pour les événements de la blockchain en temps réel, ainsi qu’une archive complète des données historiques. Cette approche prend également en charge les requêtes eth_call historiques sur n’importe quel bloc, alors que /evm ne prend en charge que le dernier bloc.
Compatible avec : Foundry, Hardhat, Truffle, Web3.js, Ethers.js, Viem, Metamask et tous les frameworks Ethereum standard.
En raison des différences architecturales Hyperliquid, certaines méthodes RPC peuvent se comporter différemment par rapport à Ethereum. Nous vous recommandons de consulter la Hyperliquid officielle Hyperliquid pour connaître les dernières mises à jour.
Intégration intercouches: les contrats intelligents sur HyperEVM peuvent consulter les cours fournis par l'oracle HyperCore. Consultez notre guide sur l'accès aux données HyperCore depuis les contrats.
API HyperCore
HyperCore permet d'accéder en temps réel et à l'historique des données boursières via plusieurs protocoles API :
Endpoint d'informations (/info path) - Query comprehensive market data, user positions, order status, trading history, vault information, and exchange state through 73 specialized methods covering perpetual and spot markets. Quicknode's /info endpoint supports 71 of 73 methods natively; see the Page « Points de terminaison » pour plus de détails.
API REST - Opérations de trading (création et envoi d'ordres avec signatures), gestion des autorisations de frais de création, exploration du marché (liste des marchés/DEX, ordres ouverts, statut des ordres) et validation des ordres (pré-validation). Prend en charge la gestion du cycle de vie des ordres, de la création d'actions non signées à la soumission de transactions signées, avec des points de terminaison améliorés permettant de vérifier le statut des autorisations et d'interroger des données enrichies sur les ordres.
Si vous bénéficiez d'un essai gratuit, nous mettons à votre disposition une URL, mais celle-ci n'est pas spécifique à votre Quicknode . Veuillez consulter le site hyperliquidapi.com pour plus de détails et notre serveur Discord pour obtenir de l'aide.
JSON-RPC/HTTP (/hypercore path) - Requêtes de données historiques de cotation (hl_getLatestBlocks, hl_getBlock, hl_getBatchBlocks) pour le remplissage historique et le traitement par lots pouvant aller jusqu’à 200 blocs par requête, ainsi que des requêtes sur l’état des portefeuilles et des chambres de compensation (hl_portfolioState, hl_batchClearinghouseStates, hl_batchPortfolioStates) permettant de récupérer les positions, les soldes et les données de marge pour un ou plusieurs utilisateurs, ainsi que des requêtes de données sur les ordres (hl_batchOpenOrders) permettant de récupérer les ordres ouverts pour un maximum de 100 utilisateurs en une seule requête.
gRPC (port 10000) - Diffusion bidirectionnelle avec une latence inférieure à la milliseconde pour les données de marché. Prend en charge les treize streams de données streams compression zstd native (réduit la bande passante d'environ 70 %), notamment StreamL2Book (profondeur agrégée) et StreamL4Book (ordre individuel) avec instantanés intégrés. Convient aux teneurs de marché, aux systèmes de trading algorithmique et aux applications d'analyse en temps réel nécessitant une faible latence.
WebSocket (/hypercore/ws path) - Abonnements en temps réel compatibles avec les navigateurs, utilisant des bibliothèques WebSocket standard. Protocole basé sur JSON avec les méthodes hl_subscribe et hl_unsubscribe. Prend en charge six streams de données streamsMÉTIERS, COMMANDES, MISE À JOUR DES LIVRES, TWAP, ÉVÉNEMENTS, ACTIONS_DE_L'AUTEUR). BLOCS et le OrderBookStreaming méthodes (StreamL2Book, StreamL4Book, StreamBboBook, StreamL2BookDiff, StreamL4BookUpdates, StreamTpslUpdates) fonctionnent gRPC. Elles conviennent particulièrement aux tableaux de bord de trading en ligne, aux outils de suivi des cours et aux outils de suivi de portefeuille.
Streams de données disponibles
| Diffusion en continu | Description | gRPC | WebSocket | JSON-RPC |
|---|---|---|---|---|
| MÉTIERS | Transactions exécutées avec informations sur le « maker » et le « taker » | ✓ | ✓ | ✓ |
| COMMANDES | Événements du cycle de vie d'une commande (plus de 18 types de statut) | ✓ | ✓ | ✓ |
| MISE À JOUR DES LIVRES | Évolution progressive du carnet de commandes | ✓ | ✓ | ✓ |
| TWAP | Données d'exécution de l'algorithme TWAP | ✓ | ✓ | ✓ |
| ÉVÉNEMENTS | Modifications de solde, virements, liquidations | ✓ | ✓ | ✓ |
| ACTIONS_DE_L'AUTEUR | Données de la passerelle HyperCore ↔ HyperEVM | ✓ | ✓ | ✓ |
| BLOCS | Données brutes de la blockchain (replica_cmds) | ✓ | - | - |
| StreamL2Book | Profondeur agrégée du niveau des prix (instantané complet à chaque bloc) | ✓ | - | - |
| StreamL4Book | Carnet d'ordres individuel (instantané + différences par bloc) | ✓ | - | - |
| StreamBboBook | Meilleur cours acheteur/vendeur en haut du carnet d'ordres, diffusé uniquement lorsque le BBO change | ✓ | - | - |
| StreamL2BookDiff | Variations incrémentielles du niveau de prix L2 avec numéros de séquence par pièce | ✓ | - | - |
| StreamL4BookUpdates | Différences d'ajout, de mise à jour et de suppression classées par ordre de saisie | ✓ | - | - |
| StreamTpslUpdates | Mises à jour relatives à l'ajout/la suppression d'ordres à déclenchement (TP/SL) avec instantané des ordres ouverts | ✓ | - | - |
| MEMPOOL_TXS | Transactions en attente dans le mempool | ✓ | - | - |
Tous streams d'appliquer des filtres par adresse d'utilisateur, par paires de devises, etc. Les limites de filtrage varient selon le niveau d'abonnement.
En savoir plus sur streams de données streams le filtrage HyperCore.
Données indexées et analyses
Pour les charges de travail analytiques couvrant de larges plages temporelles, telles que les indicateurs agrégés, l'historique des transactions, les taux de financement et l'historique des liquidations, Quicknode des produits indexés et pilotés par les événements qui viennent compléter les API natives mentionnées ci-dessus.
- SQL Explorer: Interrogez Hyperliquid pré-indexées à l'aide de requêtes SQL standard, sans avoir à créer ni à gérer de pipeline d'indexation. Consultez les exemplesHyperliquid et la référence des schémas pour commencer.
- Streams: Diffusion en mode « push » de données HyperEVM en temps réel et historiques vers vos propres destinations, avec une garantie de transmission unique et un filtrage personnalisé.
- Webhooks: Déclenchez des notifications HTTP lors d'événements HyperEVM pour alimenter des workflows pilotés par les événements.
Utilisez SQL Explorer pour les analyses ponctuelles et historiques, et utilisez Streams Webhooks une diffusion continue des données, pilotée par les événements.
SDK pris en charge
Quicknode des SDK communautaires open source pour Hyperliquid plusieurs langages. Ces SDK prennent en charge la création, la signature et l'envoi de transactions pour les opérations de trading HyperCore et les interactions avec HyperEVM.
Ces SDK open source sont développés et maintenus par Quicknode. Ils s'adressent à la communauté et ne sont ni affiliés à, ni approuvés par, ni associés à Hyperliquid ou à Hyperliquid .
SDK disponibles :
- Python - sdk PyPI
- TypeScript/JavaScript - sdk npm
- Rust - sdk crates.io
- Go - Disponible dans le SDK
Tous les SDK sont open source et disponibles sur GitHub. Les SDK s'intègrent aux Quicknode pour permettre l'accès à /info, /échange, /evm, /nanoreth, /hypercore, ainsi questreams gRPC . Ils peuvent être utilisés avec ou sansendpoint Quicknode .
Pour consulter SDK détaillée SDK , des exemples et des guides d'installation, rendez-vous sur la page « SDK et bibliothèques ».
Effectuer des appels Hyperliquid
Pour commencer à développer sur Hyperliquid, créez unendpoint Quicknode endpoint accédez aux services HyperEVM et HyperCore.
Quicknode fournit Hyperliquid gérée, vous permettant d'accéder aux deux composants sans avoir à gérer vos propres nœuds. Ces points de terminaison offrent :
- Fiabilité - Une infrastructure répartie à l'échelle mondiale pour réduire au minimum les temps d'arrêt
- Performances - Faible latence et traitement des requêtes pour les applications de production
- Accès à deux composants - endpoint unique endpoint d'accéder à la fois à HyperEVM (contrats intelligents via
/evmet/nanoreth) et HyperCore (échange de données via/hypercoreHTTP/WebSocket et gRPC) - Prise en charge de plusieurs protocoles: HTTP, WebSocket et gRPC )
- Intégration des écosystèmes - Produits complémentaires, notamment Streams, Webhookset SQL Explorer. Voir la section « Données indexées et analyses » ci-dessus pour plus de détails.
Rendez-vous sur la page « QuickStart » pour créer votre endpoint envoyer votre première requête.
Réseaux pris en charge
Quicknode d'accéder aux Hyperliquid suivants :
*Politique en matière d'élagage:
/evm → Données récentes uniquement. Le /evm endpoint d'accéder aux archives : les données des blocs les plus anciens sont supprimées périodiquement (environ toutes les 12 heures). Les requêtes portant sur des blocs situés en dehors de la période de conservation renverront une hauteur de bloc non valide erreur. Utilisez /nanoreth pour les requêtes historiques.
/nanoreth → Archives historiques complètes avec prise en charge du traçage. Comprend toutes les méthodes de débogage et de traçage, ainsi que la fonctionnalité WebSocket.
- Mainnet: archives historiques complètes
- Testnet: commence au bloc 34112653 (et non au bloc de genèse)
Disponibilité des données HyperCore :
/info (HTTP) - Comprehensive market data and user information via 73 info methods (meta, clearinghouseState, userFills, l2Book, portfolio, etc.)
API REST - Opérations de trading (création/envoi d'ordres, annulation, modification), gestion des frais de création d'ordres (validation/révocation), requêtes sur les marchés (liste des marchés/DEX, ordres ouverts, statut des ordres) et validation des ordres (vérification préalable)
/hypercore (HTTP) - Requêtes relatives à l'historique des blocs (hl_getLatestBlocks, hl_getBlock, hl_getBatchBlocks), requêtes relatives à l'état des portefeuilles et des chambres de compensation (hl_portfolioState, hl_batchClearinghouseStates, hl_batchPortfolioStates) et requêtes relatives aux données sur les ordres (hl_batchOpenOrders)
/hypercore/ws (WebSocket) - Diffusion en temps réel de 6 streams de données streams TRADES, ORDERS, BOOK_UPDATES, TWAP, EVENTS, WRITER_ACTIONS)
gRPC - Diffusion en temps réel des 13 streams de données, streams prise en charge de la compression zstd
HyperEVM : /evm (HTTP uniquement) • /nanoreth (HTTP + WebSocket + traçage/débogage)
HyperCore : /info (73 info methods) • /hypercore/.. API REST (requêtes relatives aux transactions et aux marchés) • /hypercore (requêtes historiques par bloc) • /hypercore/ws WebSocket (6 streams) • gRPC 13 streams StreamL2Book/StreamL4Book + compression)
En savoir plus sur les terminaux HyperEVM et HyperCore
Disponibilité des API par réseau
| API / Endpoint | Mainnet | Testnet |
|---|---|---|
| Endpoint HyperCore Info Endpoint /info) | ✓ | ✓ |
| API HyperCore Exchange (/hypercore/*) | ✓ | ✗ |
| HyperCore JSON-RPC/WSS (/hypercore) | ✓ | ✓ |
| gRPC (port 10000) | ✓ | ✓ |
| HyperEVM (/evm) | ✓ | ✓ |
| API de débogage (/nanoreth) | ✓ | ✓ |
| API Trace (/nanoreth) | ✓ | ✓ |
Guide complet destiné aux développeurs utilisant Hyperliquid Quicknode:
Démarrage rapide
Lancez-vous Hyperliquid avec Hyperliquid . Suivez notre guide de démarrage rapide étape par étape pour configurer votre endpoint effectuer votre première requête API.
Points de terminaison des fournisseurs
Découvrez comment configurer et gérer vos Hyperliquid pour bénéficier de performances et d'une fiabilité optimales.
Présentation de l'API
Découvrez les API prises en charge, les réseaux, Quicknode et les fonctionnalités avancées des API pour développer des applications performantes.
Modules complémentaires
Discover endpoint add-ons that extend your Hyperliquid development workflow.
Endpoint
Sécurisez vos terminaux grâce à l'authentification, aux listes blanches et aux meilleures pratiques en matière de sécurité.
Codes d'erreur
Découvrez les codes d'erreur courants et les étapes de dépannage pour les requêtes Hyperliquid .