Passer au contenu principal

Hyperliquid API Overview

Mis à jour le
25 juin 2026

Quicknode provides comprehensive API access to Hyperliquid's dual-layer architecture, supporting both HyperCore trading infrastructure and HyperEVM smart contract capabilities. Using your Hyperliquid endpoint, you can seamlessly access:

HyperCore APIs:


  • Info Endpoints (/info path) - Query market data, user positions, trading history, vault analytics, and exchange state. 50 of 52 methods are natively supported on Quicknode's /info path. See the method availability table for the full list.
  • Data Streams - Real-time streaming of trades, orders, events, and blockchain data via high-performance gRPC and JSON-RPC/WebSocket APIs
  • REST API - Trading operations (build, sign, and send orders), builder fee approval management, market discovery (list markets, open orders, order status), and order validation via HTTP REST endpoints
  • API JSON-RPC (/hypercore path) - Historical block queries, portfolio and clearinghouse state queries, order data, and WebSocket subscriptions for backfilling and batch processing

HyperEVM APIs:


  • Ethereum JSON-RPC API - Full compatibility with Ethereum tooling (Foundry, Hardhat, Web3 libraries)
  • Debug API - Advanced transaction tracing and debugging capabilities
  • Trace API - Detailed transaction analysis and monitoring tools
Plan Requirement

Access to /hypercore (JSON-RPC and WebSocket) and HyperCore gRPC streaming requires a Quicknode Build plan or higher. View pricing to upgrade.


REST API: If you are on a free trial plan, we provide a URL for you to use, but it is not specific to your Quicknode account. Please see hyperliquidapi.com for details and our Discord for support.

For detailed method documentation and implementation guides, refer to the specific API sections below.

Supported SDKs

Quicknode maintains open-source community SDKs for Hyperliquid in multiple languages. These SDKs handle transaction building, signing, and submission for HyperCore trading operations and HyperEVM interactions.

Community SDKs

These open-source SDKs are developed and maintained by Quicknode. They are community-oriented and not affiliated with, endorsed by, or associated with Hyperliquid Foundation or Hyperliquid Labs.

Available SDKs:

All SDKs are open source and available on GitHub. The SDKs integrate with Quicknode endpoints for accessing /info, /exchange, /evm, /nanoreth, /hypercore, and gRPC streams. They can be used with or without a Quicknode endpoint.

For detailed SDK documentation, examples, and setup guides, see the SDKs & Libraries page.

API prises en charge

Réseaux pris en charge

Quicknode provides access to the following Hyperliquid networks:

Mainnet
Type :Production
ID de chaîne :
999
HTTP :
WSS :
Archive :Oui
Pruning:See comment below*
Testnet
Type :Testnet
ID de chaîne :
998
HTTP :
WSS :
Archive :Oui
Pruning:See comment below*

*Pruning Policy:

/evm → Recent data only. The /evm endpoint does not provide archival access — older block data is periodically pruned (approximately every 12 hours). Requests for blocks outside the retention window will return an invalid block height error. Use /nanoreth for historical queries.

/nanoreth → Full historical archive with tracing support. Includes all debug and trace methods plus WebSocket functionality.

  • Mainnet: Full historical archive
  • Testnet: Starts from block 34112653 (not genesis)

Learn more about Hyperliquid endpoints here

API Availability by Network

API / EndpointMainnetTestnet
HyperCore Info Endpoint (/info)
HyperCore Exchange API (/hypercore/*)
HyperCore JSON-RPC/WSS (/hypercore)
gRPC Streaming (port 10000)
HyperEVM (/evm)
Debug API (/nanoreth)
Trace API (/nanoreth)

Query Indexed Hyperliquid Data with SQL Explorer

The APIs above provide live, on-demand access to Hyperliquid. For large-scale historical analysis, Quicknode also indexes HyperCore data into queryable tables you can analyze with standard SQL through SQL Explorer, removing the need to run your own indexer for dashboards, backtests, and research.

What you can query

SQL Explorer exposes pre-indexed Hyperliquid tables covering:

  • Trades and fills: executed trades, individual fills, realized PnL, and liquidations (hyperliquid_trades, hyperliquid_fills)
  • Orders: placements, cancellations, and status updates (commandes_hyperliquides)
  • Funding: funding payments and historical funding rates per coin (hyperliquid_funding, hyperliquid_funding_summary_hourly)
  • Markets: perpetual and spot market metadata, oracle prices, open interest, and market context (hyperliquid_perpetual_markets, hyperliquid_perpetual_market_contexts, hyperliquid_oracle_prices)
  • Portfolio and positions: clearinghouse state, spot balances, vault equity, sub-accounts, and delegation (hyperliquid_clearinghouse_states, hyperliquid_vault_equities)
  • Ledger and bridge: deposits, withdrawals, transfers, and L1 bridge activity (hyperliquid_asset_transfers, hyperliquid_ledger_updates, hyperliquid_bridge)
  • Entrepreneurs: builder (frontend) transaction volume and fee distribution (hyperliquid_builder_fills, hyperliquid_builder_transactions)
  • Pre-aggregated analytics: hourly funding, liquidations, OHLCV, and platform-wide daily metrics (hyperliquid_metrics_overview, hyperliquid_liquidations_hourly)

Example: trading volume by coin over the last 24 hours

curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT coin, count() AS trades, sum(toFloat64(price) * toFloat64(size)) AS volume_usd FROM hyperliquid_trades WHERE timestamp > now() - INTERVAL 24 HOUR GROUP BY coin ORDER BY volume_usd DESC LIMIT 50",
"clusterId": "hyperliquid-core-mainnet"
}'

Queries run against the hyperliquid-core-mainnet cluster via the SQL Explorer REST API. See the Hyperliquid query library for 30+ ready-to-use queries, the schema reference for full table and column documentation, and the REST API guide for authentication and response formats.

SQL Explorer is one of several Quicknode products available for Hyperliquid. For real-time, event-driven data, Streams push HyperEVM activity to your own destinations and Webhooks deliver HTTP notifications for on-chain events. All supported products are listed below.

Produits pris en charge

API Specifications (OpenRPC, OpenAPI)

Partager ce document