Hyperliquid Market Data Connector
Hyperliquid Data Connector based on WebSocket/REST.
Features
hyperliquidConnector KeyMessage Types
✓
Level 1
✓
Level 2
✗
Level 3
✓
Trades
✗
Funding Rates
Configuration
Data Connector Parameters
| Parameter | Default Value | Description |
|---|---|---|
| WebSocket URL | wss://api.hyperliquid.xyz/ws | WebSocket root URL. |
| REST URL | https://api.hyperliquid.xyz/ | REST root URL. |
| Read Timeout | 15000 | Read timeout in milliseconds. |
| Reconnect Timeout | 15000 | Reconnect timeout in milliseconds. |
| Exchange Name | HYPERLIQD | Exchange name for this session. |
| Use Fast Order Book | false | This option enables the "fast" order book mode. In this mode, order book updates are provided by the exchange significantly more frequently than in the standard mode. However, the order book depth is limited to 5 levels. Use this mode when faster top-of-book updates are preferred over deeper order book snapshots. See the Hyperliquid WebSocket subscriptions docs for more details ( l2Book + fast).The default value for this option is false. |
| Output Book Size | 20 | Size of the output book. |
Symbology
Supported instrument types: the current version supports SPOT and PERP.
Subscribe using the instrument name from the exchange universe metadata (same value the connector validates against after REST discovery). For perpetuals, coin is the name from the perp meta response. For spot, use PURR/USDC for PURR and @{index} (for example @1) for other spot pairs, where index is the spot pair index in spotMeta.universe. Builder-deployed perps use {dex}:{coin} names.
See Hyperliquid Info endpoint and Asset IDs.
Supported symbol notations:
| Symbol Notation | Examples |
|---|---|
| COIN (upper case) (PERP) | BTC ETH |
| DEX:COIN (upper case) (PERP, builder-deployed) | xyz:TSLA flx:NVDA |
| CRYPTO/PAIR (upper case) (SPOT) | PURR/USDC |
| @index (SPOT) | @1 @107 |
Full symbol list (use each universe[].name value):
# Spot
curl -H "Content-Type: application/json" -X POST -d "{\"type\":\"spotMeta\"}" https://api.hyperliquid.xyz/info
# Perpetuals (all perp DEXes)
curl -H "Content-Type: application/json" -X POST -d "{\"type\":\"allPerpMetas\"}" https://api.hyperliquid.xyz/info
Logging
To enable detailed logging, use these lines in the <QSHOME>/config/gflog.xml file:
<logger name="deltix.qsrv.hf.plugins.data.hyperliquid" level="DEBUG">
<appender-ref ref="safeAppender"/>
</logger>