HyperCore Trade

Zero-custody builder API for HyperLiquid.
Sign locally, we forward. Your keys never leave your machine.

Zero custody

Perps & Spot

HIP-3 Markets

How it works

Every trade follows the same three-step pattern. Use hl_openOrders and hl_orderStatus to discover orders and get pre-built cancel actions.

Build

hl_build*

We compute the hash with the builder fee injected

Sign

Your key

Sign the hash locally. Your private key never leaves

Send

hl_send*

We forward the signed transaction to HyperLiquid

Quickstart

Clone the repo. Set your key. Run.

Endpointhttps://send.hypercoretrade.xyz

hypercore-trade-examples

Clone and run. Full working examples in Python, TypeScript, and Rust.

bash

1git clone https://github.com/quiknode-labs/hypercore-trade-examples.git
2cd hypercore-trade-examples/python
3pip install -r requirements.txt
4export PRIVATE_KEY="0xYOUR_PRIVATE_KEY"
5 
6python3 approve.py          # one-time builder fee approval
7python3 check_status.py     # check approval status
8python3 list_markets.py     # list all available markets
9python3 open_orders.py      # view open orders + cancel actions
10python3 order_status.py     # check what happened to an order
11python3 place_order.py      # place a perp order
12python3 cancel_order.py     # place + cancel
13python3 modify_order.py     # place + modify
14python3 roundtrip.py        # buy then sell (full cycle)
15python3 hip3_order.py       # HIP-3 market order by name
16python3 revoke.py           # revoke approval

Try it now

bash

1curl -s -X POST https://send.hypercoretrade.xyz \
2  -H "Content-Type: application/json" \
3  -d '{
4    "jsonrpc": "2.0",
5    "id": 1,
6    "method": "hl_getMaxBuilderFee",
7    "params": { "user": "0xYOUR_ADDRESS" }
8  }'

API Reference

16 methods, all JSON-RPC 2.0. Click any method to expand.

Approval

Orders

Utility

Error Codes

Every error includes code, message, and data.guidance with exactly what to do next.

Code	Meaning	What to do
-32001	Not approved / fee too low	Run approval flow or visit /approve
-32002	Builder mismatch	Use hl_buildOrder -- it injects the correct builder
-32003	Invalid signature	Sign the exact hash from hl_build*. r/s: 0x hex, v: 27 or 28
-32010	Exchange rejection	See errorCode and actionRequired in response. MAX_ORDERS_EXCEEDED includes hl_openOrders call template.
-32602	Invalid params	Check required fields and types
-32603	Internal error	Retry in a few seconds
-32700	Parse error	Send valid JSON-RPC 2.0

Fees

Two fees apply per trade: our builder fee (injected into your order) and HyperLiquid's exchange fee (maker/taker, charged by the protocol).

Builder Fee— charged by us, injected into each order

Market	Fee	Protocol Max
Perpetuals	0.04%	0.1%
Spot	0.5%	1%

Exchange Fee— charged by HyperLiquid, based on your volume tier

Market	Taker	Maker
Perpetuals	0.045%	0.015%
Spot	0.070%	0.040%

You approve a maxFeeRate ceiling (e.g. "1%") for the builder fee. The actual builder fee is always within your approved limit. You can revoke at any time.