取引 API と SDK · 注文を出す · 4/8

Exchange クラス

認証の準備

Exchange クラスは、署名が要る(書き込みの)操作をすべて受け持ちます。署名に使う wallet が必要です。

テストネットだけで使ってください。 この回のサンプルは、どれも実際に注文を出したり、取り消したり、変えたりします。TESTNET_API_URL に向けて、テストネットの API wallet で動かしてください。

import os
import eth_account
from hyperliquid.exchange import Exchange
from hyperliquid.info import Info
from hyperliquid.utils import constants

# Load the API (agent) wallet key from an environment variable
wallet = eth_account.Account.from_key(os.environ["HL_API_WALLET_KEY"])
account_address = os.environ["HL_ACCOUNT_ADDRESS"]  # your main account

exchange = Exchange(
    wallet,
    base_url=constants.TESTNET_API_URL,
    account_address=account_address,
)
info = Info(constants.TESTNET_API_URL, skip_ws=True)

署名付きの操作は2種類

SDK は2つの方式のどちらかで署名します(署名)。

• L1 action(注文、取り消し、変更、レバレッジの変更)は sign_l1_action で署名します。承認済みの API wallet が、口座の代わりに署名できます。
• ユーザー署名の action(USDC の送金、引き出しなど)は sign_user_signed_action で、口座そのものの鍵が署名します。

どのリクエストにも nonce が付きます。SDK は現在時刻のミリ秒を使います。nonce は署名する鍵ごとに管理されます。そのため、bot のプロセスごとに別の API wallet を用意してください(nonce)。

成行注文を出す

API には成行注文という種類がありません。market_open は仲値を読み、slippage(初期値は5%)の分だけ価格をずらして、すぐ約定させる IOC の指値注文 を出します。

# Buy 0.01 BTC at market price (testnet)
result = exchange.market_open(
    name="BTC",
    is_buy=True,
    sz=0.01,       # Size in base asset (BTC)
    slippage=0.01  # Limit price set 1% through the mid
)

print(result)
# {'status': 'ok', 'response': {'type': 'order', 'data': {'statuses': [{'filled': {'totalSz': '0.01', 'avgPx': '...', 'oid': ...}}]}}}

注文の金額は $10 以上にする必要があります。

指値注文を出す

# Place a limit buy for 0.01 BTC at $90,000 (testnet)
result = exchange.order(
    name="BTC",
    is_buy=True,
    sz=0.01,
    limit_px=90000.0,
    order_type={"limit": {"tif": "Gtc"}}  # Good-til-cancelled
)

# The response includes the order ID (oid)
if result["status"] == "ok":
    statuses = result["response"]["data"]["statuses"]
    for s in statuses:
        if "resting" in s:
            print(f"Order placed: oid={s['resting']['oid']}")

有効期間(Time-in-Force)の種類

order_type で、注文がどれだけ有効かを決めます。

order_type のもう1つの形は {"trigger": {"triggerPx": ..., "isMarket": bool, "tpsl": "tp" | "sl"}} です。利確と損切りの注文に使います。

# Post-only order (canceled if it would take liquidity)
exchange.order(
    name="ETH",
    is_buy=True,
    sz=0.1,
    limit_px=3000.0,
    order_type={"limit": {"tif": "Alo"}}
)

# IOC order (fill immediately or cancel)
exchange.order(
    name="ETH",
    is_buy=True,
    sz=0.1,
    limit_px=3100.0,
    order_type={"limit": {"tif": "Ioc"}}
)

注文を取り消す

# Cancel a specific order
exchange.cancel(name="BTC", oid=12345)

# Cancel all open orders for a coin (query the main account, not the API wallet)
open_orders = info.open_orders(account_address)
for order in open_orders:
    if order["coin"] == "BTC":
        exchange.cancel(name="BTC", oid=order["oid"])

レバレッジを設定する

# Set leverage for BTC to 10x cross margin
exchange.update_leverage(
    leverage=10,
    name="BTC",
    is_cross=True
)

# Set isolated margin at 5x
exchange.update_leverage(
    leverage=5,
    name="ETH",
    is_cross=False
)