Build on Hyperliquid: the developer hub
The four ways to talk to Hyperliquid, their limits, the SDKs worth using, and our tested guides.
Hyperliquid has four public interfaces: the info endpoint (POST api.hyperliquid.xyz/info, free, no key), the signed exchange endpoint for trading, a WebSocket at wss://api.hyperliquid.xyz/ws, and HyperEVM JSON-RPC (chain ID 999). Each IP gets 1,200 request weight per minute; most reads cost 2 or 20. The official SDK is hyperliquid-python-sdk, and Hyperliquid's docs also list community SDKs for TypeScript and Rust, plus CCXT.
The four APIs
- Info endpoint
POST https://api.hyperliquid.xyz/infoRead markets, prices, order books, candles, funding and any address's positions, orders and fills. - Exchange endpoint
POST https://api.hyperliquid.xyz/exchangePlace, modify and cancel orders; transfers, withdrawals, approvals, staking. - WebSocket
wss://api.hyperliquid.xyz/wsStream trades, books, candles and per-address fills and orders. Can also carry info requests and signed actions. - HyperEVM JSON-RPC
https://rpc.hyperliquid.xyz/evmStandard Ethereum JSON-RPC for the HyperEVM, chain ID 999. Latest-block state only on the public node.
Everything on HyperCore (the exchange) goes through the first three. The HyperEVM is the smart-contract side of the same chain; contracts there can read and trade HyperCore through precompiles and CoreWriter. The info endpoint allows cross-origin calls (access-control-allow-origin: *, checked 4 November 2026), so browser apps can call it directly. Hyperliquid also publishes bulk historical data in S3 buckets, such as the daily builder-fills files; the docs recommend those over the explorer API for large backfills.
Guides
Each guide was written against the live API on 4 November 2026. The responses shown are real.
- Hyperliquid API: a beginner's guideSix read-only info requests you can paste into a terminal (meta, allMids, l2Book, clearinghouseState, candleSnapshot, fundingHistory), with real responses.
- Hyperliquid WebSocket APISubscribe to trades, order books and a user's fills, keep the connection alive, and stay inside the connection and subscription limits.
- Hyperliquid API wallets (agent keys)What an API wallet can sign (orders, cancels) and can't (withdrawals, transfers out, builder approvals), plus nonces and pruning.
- HyperEVM RPC and chain settingsChain ID 999, the public RPC and its 100 requests/minute limit, explorers, HYPE gas, big and small blocks, testnet 998.
- Builder codes for developersCharge a fee on the orders your app sends: approveBuilderFee, the order builder field, the 0.1% perps / 1% spot caps and how to audit your fills.
Rate limits
Hyperliquid limits by IP address and, for trading actions, by address. These are the documented values (rate limits and user limits, read 4 November 2026).
Per IP address
| Limit | Value |
|---|---|
| HTTP requests (info + exchange) | 1,200 weight per minute |
| Weight 2 | l2Book, allMids, clearinghouseState, orderStatus, spotClearinghouseState, exchangeStatus |
| Weight 60 | userRole |
| Weight 20 | every other documented info request |
| Extra weight | +1 per 20 items returned by history requests (recentTrades, userFills, fundingHistory…); +1 per 60 candles |
| Exchange actions | 1 + floor(batch length / 40), so a 79-order batch weighs 2 |
| Explorer requests | 40 each |
| WebSocket | 10 connections, 30 new per minute, 1,000 subscriptions, 10 unique users, 2,000 messages sent per minute, 100 in-flight posts |
| HyperEVM RPC (rpc.hyperliquid.xyz/evm) | 100 requests per minute |
So one IP can poll allMids about 600 times a minute, but a weight-20 request only 60 times. If you need to watch many markets or accounts, use the WebSocket.
Per address (trading actions)
| Rule | Value |
|---|---|
| Action budget | 1 request per 1 USDC traded since the address was created, plus a starting buffer of 10,000 requests |
| When rate limited | One request every 10 seconds |
| Cancels | A higher cap, min(limit + 100,000, limit × 2), so you can always pull orders |
| Open orders | 1,000, plus 1 per $5M of volume, up to 5,000 |
| Batches | One request for the IP limit, n requests for the address limit |
| Applies to | Actions only, not info requests. Sub-accounts count as separate users. |
During congestion, each address may use at most twice its previous day's share of maker volume in block space. Batching orders and cancels reduces your weight. Check how much of an address's budget is used with {"type":"userRateLimit","user":"0x…"}.
SDKs
Hyperliquid recommends using an SDK for anything that signs, because hand-rolled signatures fail in confusing ways (signing). "Listed" means the SDK appears on Hyperliquid's API docs page. Versions and licenses were checked on GitHub, PyPI and npm on 4 November 2026.
| Language | SDK | Maintainer | Install | Version | License | Listed |
|---|---|---|---|---|---|---|
| Python | hyperliquid-python-sdk | Hyperliquid (official, hyperliquid-dex org) | pip install hyperliquid-python-sdk | 0.24.0 (PyPI) | MIT | Yes, official |
| TypeScript | nktkas/hyperliquid | nktkas (community) | npm i @nktkas/hyperliquid | 0.33.3 (npm) | MIT | Yes |
| TypeScript | nomeida/hyperliquid | nomeida (community) | npm i hyperliquid | 1.7.7 (npm) | None stated on GitHub | Yes |
| Rust | hypersdk | Infinite Field (community) | see repo | pushed 2026-11-03 | MPL-2.0 | Yes |
| Many | CCXT | CCXT | ccxt (JS, Python, PHP, C#, Go) | standard CCXT API | MIT | Yes |
| Go | go-hyperliquid | sonirico (community, "unofficial") | go get github.com/sonirico/go-hyperliquid | v0.46.3 | MIT | No |
The hyperliquid-dex GitHub organization also hosts a Rust SDK, hyperliquid-rust-sdk, last updated in October 2025. Hyperliquid's API page now points Rust users to Infinite Field's hypersdk instead. We haven't audited any of these libraries. Pin versions, read the code that signs, and test on testnet before you trust any SDK with funds.
Testnet
- API:
https://api.hyperliquid-testnet.xyz(same/infoand/exchangepaths). WebSocket:wss://api.hyperliquid-testnet.xyz/ws. App: app.hyperliquid-testnet.xyz. - HyperEVM testnet: chain ID 998, RPC
https://rpc.hyperliquid-testnet.xyz/evm. - Mock USDC: 1,000 from the official faucet, only for addresses that have deposited on mainnet. If you sign in with email, your testnet address differs from mainnet (testnet faucet).
- IDs differ. HYPE is token 150 and spot pair 107 on mainnet, but token 1105 and spot pair 1035 on testnet (asset IDs).
Free data from UnderHyper
If you only need clean numbers, you may not need the API at all. Every UnderHyper dataset is rebuilt from the Hyperliquid info API about every 2 hours. Each carries its as-of time and downloads as JSON or CSV under CC BY 4.0:
- Perp markets & liquidity JSON · CSV
- Funding vs Binance & Bybit JSON · CSV
- HIP-3 dexes & market share JSON · CSV
- HIP-4 outcome markets JSON · CSV
- Vaults & HLP JSON · CSV
- Staking & validators JSON · CSV
- Spot tokens & pairs JSON · CSV
- Fees & builder economics JSON · CSV
- Top traders (30d) JSON · CSV
- Volume & perp DEX share JSON · CSV
AI agents can query the same numbers through our read-only MCP server at https://underhyper.com/mcp. It needs no key and has 5 tools, including market snapshots, funding and HIP-3 dexes. Looking for a block explorer or an analytics site instead? See Hyperliquid explorers compared.
Before you trade from code
- Keep your main key off servers. Trade with an API wallet. It can't withdraw, but it can still trade the account to zero.
- No one legitimate needs your seed phrase. Fake "API key generators", airdrop checkers and support DMs are common (scams to avoid).
- Leverage cuts both ways. Bots fail in ways people don't: stale data, a retry loop, a price in the wrong units. Start on testnet, then small, with a scheduled cancel (dead man's switch) set.
- Where you may trade. Hyperliquid's terms restrict users in the United States, Ontario and other places. Trading through code doesn't change that (details).
Questions people ask
Does Hyperliquid have an API?
Yes. A free public HTTP API at api.hyperliquid.xyz (POST /info to read, POST /exchange for signed trading actions), a WebSocket at wss://api.hyperliquid.xyz/ws, and JSON-RPC for the HyperEVM at rpc.hyperliquid.xyz/evm. Reading needs no key.
What is the Hyperliquid API rate limit?
1,200 weight per minute per IP for HTTP requests. l2Book, allMids and clearinghouseState weigh 2, userRole 60, and other info requests 20. Trading actions are also limited per address: 1 request per 1 USDC traded, after a starting buffer of 10,000.
Is there an official Hyperliquid SDK?
The official SDK is hyperliquid-python-sdk (pip install hyperliquid-python-sdk, version 0.24.0 on 4 November 2026). Hyperliquid's docs also link community SDKs: nktkas/hyperliquid and nomeida/hyperliquid for TypeScript, Infinite Field's hypersdk for Rust, and CCXT.
Does Hyperliquid have a testnet?
Yes. The API is at https://api.hyperliquid-testnet.xyz, the app at app.hyperliquid-testnet.xyz and the HyperEVM is chain ID 998. The faucet gives 1,000 mock USDC to addresses that have deposited on mainnet.
Sources
- Hyperliquid Docs — API (SDK list, mainnet and testnet URLs)
- Hyperliquid Docs — Rate limits and user limits
- Hyperliquid Docs — Info endpoint
- Hyperliquid Docs — Exchange endpoint
- Hyperliquid Docs — WebSocket
- Hyperliquid Docs — HyperEVM
- Hyperliquid Docs — HyperCore tools (SDKs, data providers, explorers)
- Hyperliquid Docs — Testnet faucet
- hyperliquid-python-sdk on PyPI
- @nktkas/hyperliquid on npm