Quickstart

python3 -m venv .venv
. .venv/bin/activate
pip install hyperliquid-python-sdk==0.24.0

import os
from eth_account import Account
from hyperliquid.exchange import Exchange

exchange = Exchange(
    Account.from_key(os.environ["MM_PRIVATE_KEY"]),
    os.environ["MM_BASE_URL"],
    account_address=os.environ["MM_MASTER_ADDRESS"],
)

response, agent_private_key = exchange.approve_agent("quoting")
assert response["status"] == "ok", response

import time
from hyperliquid.utils.types import Cloid

# Arm the account-wide deadline before placing fresh quotes.
response = exchange.schedule_cancel(int(time.time() * 1000) + 30_000)
assert response["status"] == "ok", response

# Allocate a unique client ID in your own order store.
cloid = Cloid.from_str("0x0123456789abcdef0123456789abcdef")
result = exchange.order(
    "WETH/USDC", True, 0.001, 2000.00,
    {"limit": {"tif": "Alo"}}, cloid=cloid,
)
status = result["response"]["data"]["statuses"][0]
if "error" in status:
    raise RuntimeError(status["error"])
oid = status["resting"]["oid"]

result = exchange.modify_order(
    oid, "WETH/USDC", True, 0.002, 1999.00,
    {"limit": {"tif": "Alo"}}, cloid=cloid,
)
status = result["response"]["data"]["statuses"][0]
if "error" in status:
    raise RuntimeError(status["error"])
oid = status["resting"]["oid"]  # Save the new ID; old fills keep the old ID.

print(exchange.info.open_orders(os.environ["MM_MASTER_ADDRESS"]))
print(exchange.cancel("WETH/USDC", oid))
# Alternatively: exchange.cancel_by_cloid("WETH/USDC", cloid)

import time

# Renew only with a fresh pricing decision, before updating your orders.
response = exchange.schedule_cancel(int(time.time() * 1000) + 30_000)
assert response["status"] == "ok", response
# exchange.schedule_cancel(None) disarms it.

fills = exchange.info.user_fills(os.environ["MM_MASTER_ADDRESS"])