For bot builders and coding agents
Hyperliquid Bot Builder Reference
Short guides to the Hyperliquid API rules that break most first bots. Each guide is checked against the Hyperliquid docs and the live API, names its sources, and links to code that runs.
Guides
- Place a Hyperliquid Order in PythonConnect the Hyperliquid Python SDK, round price and size correctly, place a limit or market order, read the result and cancel. Runs on testnet first.Last verified: November 17, 2026
- Hyperliquid API Wallets (Agent Wallets)What a Hyperliquid API wallet can and cannot do, how to create and use one, which address to query, nonce rules and why a wallet stops working.Last verified: November 17, 2026
- Hyperliquid API Rate LimitsThe Hyperliquid IP limit of 1200 weight each minute, the weight of each request, the address limit of 1 request for each 1 USDC traded, and WebSocket and open-order limits.Last verified: November 17, 2026
- Trade HIP-3 Markets Through the Hyperliquid APIHow HIP-3 market names such as xyz:NVDA work in the Hyperliquid API: the dex field, perp dex list, asset ids, SDK setup, isolated margin and collateral.Last verified: November 17, 2026
- Hyperliquid API Errors and FixesEach Hyperliquid API error message with its cause and fix: tick size, minimum order value, insufficient margin, API wallet does not exist, open interest cap and more.Last verified: November 17, 2026
Runnable examples
The code for these guides is in an open-source repository with three complete bots, four short examples and unit tests.
- examples/01_market_data.pyPrice, funding, open interest and order book for one market. Needs no key.
- examples/02_hip3_markets.pyPerp dexs, HIP-3 market names and asset ids. Needs no key.
- examples/03_place_order.pyPlace a post-only order on testnet, read each status, cancel.
- examples/04_rate_limit.pyThe request budget of any account address. Needs no key.
For AI assistants and coding agents
- Each guide is also plain markdown. Add
.mdto its URL, for example /build/hyperliquid-api-errors.md. - /llms.txt lists every guide and the JSON data endpoints.
- Live prices, funding and open interest for Hyperliquid markets are on the screener and as JSON at /api/screener/live.
HIPERWIRE is independent and is not affiliated with Hyperliquid. The official API documentation is at hyperliquid.gitbook.io. Trading bots can lose money. Test on testnet first.