hyperliquid-api-reference

Featured

Compact reference for the Hyperliquid API as the desk uses it - endpoints and envelopes, every /info request type, every /exchange action with its signing scheme, order and status vocabularies, asset ids, tick and lot rules, rate limits, WebSocket subscription list, error strings, and where the official docs are. Use to look up an exact field, request type or limit before writing a call, and to map an error string to its cause.

Web & Frontend 60 stars 11 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 88/100

Stars 20%
59
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Hyperliquid API reference (desk edition) Verified against the official docs on 2026-08-16. When in doubt, fetch the page: append `.md` to any docs URL for raw markdown, for example `https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint.md`. ## Endpoints | | Mainnet | Testnet | | --- | --- | --- | | REST | `https://api.hyperliquid.xyz` | `https://api.hyperliquid-testnet.xyz` | | WebSocket | `wss://api.hyperliquid.xyz/ws` | `wss://api.hyperliquid-testnet.xyz/ws` | | HyperEVM RPC | `https://rpc.hyperliquid.xyz/evm` (chain 999) | `https://rpc.hyperliquid-testnet.xyz/evm` (chain 998) | - `POST /info` body `{"type": "<request>", ...}`, unsigned; response is the bare payload. Unknown `type` or missing field: HTTP 422; invalid JSON: HTTP 400. - `POST /exchange` body `{"action": {...}, "nonce": <ms>, "signature": {"r","s","v"}, "vaultAddress"?: "0x...", "expiresAfter"?: <ms>}`; response `{"status":"ok","response":{"type":"order"|"cancel"|"default"|..., "data"?: {...}}}` or `{"status":"err","response":"<string>"}`, both HTTP 200. - Header `Content-Type: application/json`. ## /info request types | type | params | returns | | --- | --- | --- | | `allMids` | `dex?` | `{coin: midPx}` | | `meta` | `dex?` | `{universe:[{name, szDecimals, maxLeverage, marginTableId?, onlyIsolated?, marginMode?, isDelisted?}], marginTables:[[id,{description, marginTiers:[{lowerBound, maxLeverage}]}]]}` | | `metaAndAssetCtxs` | `dex?` | `[meta, [{funding, openInterest, pre...

Details

Author
galleonlabs
Repository
galleonlabs/hypergrok-trading-desk
Created
3 weeks ago
Last Updated
yesterday
Language
Python
License
MIT

Integrates with

WebSocket · API

Bundled in these plugins

hypergrok

Similar Skills

Semantically similar based on skill content — not just same category

Data & Documents Featured

hyperliquid-market-data

Read live Hyperliquid market data from the desk computer with curl or the Python SDK - mid, mark and oracle prices, order book depth, funding (current, predicted, historical), open interest, volume, candles, perp and spot metadata, margin tiers, and how to save datasets for the strategy lab. Read-only, no key. Use for any market brief, depth read, funding question or data pull.

60 Updated yesterday
galleonlabs
Web & Frontend Featured

hyperliquid-websocket

Subscribe to live Hyperliquid data over WebSocket from the desk computer - mids, order book, trades, candles, best bid/offer, and per-account fills, order updates and events - with raw JSON, Python SDK and TypeScript examples, plus how to run a supervised watch that logs to a file and alerts. Read-only. Use for monitoring, fill notifications and any watch that polling would make expensive.

60 Updated yesterday
galleonlabs
AI & Automation Featured

hyperliquid-account

Read a Hyperliquid account from the desk computer - positions and margin, spot balances, open orders including trigger details, fills, funding paid, ledger updates, order status by oid or cloid, historical orders, portfolio history, fee tier and rate-limit budget - with curl and Python SDK examples. Read-only, needs only the account address. Use for sizing inputs, book checks, reconciliation and reviews.

60 Updated yesterday
galleonlabs