hyperliquid

hyperliquid

An agent skill for Hyperliquid's WebSocket API — live mids, L2 order books, trades, candles, best bid/offer, asset context, and account-scoped feeds (fills, order updates, funding, ledger), plus the post method that tunnels info/exchange requests over the same socket. Drops into any agent runtime that consumes the skills format.

The socket (wss://api.hyperliquid.xyz/ws) is public and free — there is no API key, and user-scoped feeds take only a plain (public) wallet address. The skill's primary path is a direct connection. When a runtime can't open an outbound WebSocket to Hyperliquid (or the user wants a metered, managed relay), the skate-skillpay proxy can carry the stream for a per-connection-minute fee in stablecoin, matched against the brand Hyperliquid / symbol hyperliquid_ws.

What's in this folder

hyperliquid/
├── SKILL.md                agent-facing instructions (when/how to use)
├── README.md               this file (human-facing overview)
├── LICENSE
└── references/
    └── subscriptions.md    full subscription catalog, data shapes, post, limits

There is no scripts/ directory — direct connections use any WebSocket client the runtime exposes (wscat, the ws package, a browser WebSocket), and the paid path reuses the skate-skillpay client. Nothing Hyperliquid-specific to compile.

Install

npx skills add skate-org/skills --skill hyperliquid

To enable the per-minute paid relay, install skate-skillpay alongside it:

npx skills add skate-org/skills --skill skate-skillpay

Use

Ask your agent for live Hyperliquid data — "stream the BTC order book", "all-mids ticker", "1-minute ETH candles", "watch fills for 0xabc…", "get the L2 book over the socket with one post request". The agent opens the WebSocket, subscribes to the right feed(s), and relays {channel, data} messages. If direct egress isn't available and skate-skillpay is installed, it routes the stream through the paid proxy and tells you the per-minute cost first.

Environment

No environment variables. The WebSocket is public; user-scoped feeds take a public wallet address as input. The paid path draws from the local Tempo MPP wallet configured for skate-skillpay (see that skill's references/wallet-setup.md).

License

See LICENSE.