API 下单示例

市价单

代码结构

✅ config.json

{

  "keystore_path": "",
  "secret_key": "api key 私钥, 非钱包私钥!",
  "account_address": "钱包地址, 非 api key 地址!",
  "multi_sig": {
      "authorized_users": [
          {
              "comment": "signer 1",
              "secret_key": "",
              "account_address": ""
          },
          {
              "comment": "signer 2",
              "secret_key": "",
              "account_address": ""
          }
      ]
  }
}

✅ market_order.py: 市价单代码.

import time

import utils as example_utils
from hyperliquid.utils import constants


def main():
    address, info, exchange = example_utils.setup(
        constants.TESTNET_API_URL, skip_ws=True
    )

    coin = "ETH"
    is_buy = False
    sz = 0.05

    print(f"We try to Market {'Buy' if is_buy else 'Sell'} {sz} {coin}.")

    order_result = exchange.market_open(coin, is_buy, sz, None, 0.01)
    if order_result["status"] == "ok":
        for status in order_result["response"]["data"]["statuses"]:
            try:
                filled = status["filled"]
                print(
                    f"Order #{filled['oid']} filled {filled['totalSz']} @{filled['avgPx']}"
                )
            except KeyError:
                print(f"Error: {status['error']}")

        print("We wait for 2s before closing")
        time.sleep(2)

        print(f"We try to Market Close all {coin}.")
        order_result = exchange.market_close(coin)
        if order_result["status"] == "ok":
            for status in order_result["response"]["data"]["statuses"]:
                try:
                    filled = status["filled"]
                    print(
                        f"Order #{filled['oid']} filled {filled['totalSz']} @{filled['avgPx']}"
                    )
                except KeyError:
                    print(f"Error: {status['error']}")


if __name__ == "__main__":
    main()

✅ utils.py

import getpass
import json
import os

import eth_account
from eth_account.signers.local import LocalAccount
from hyperliquid.exchange import Exchange
from hyperliquid.info import Info

#
# https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/a1fca2a8a1e6ef3d6f7070b7b7eed6de6a826e44/examples/example_utils.py#L36
#


def setup(base_url=None, skip_ws=False, perp_dexs=None):
    config_path = os.path.join(os.path.dirname(__file__), "config.json")

    print(f"config_path: {config_path}")

    with open(config_path) as f:
        config = json.load(f)
    account: LocalAccount = eth_account.Account.from_key(get_secret_key(config))

    address = config["account_address"]

    if address == "":
        address = account.address
    print("Running with account address:", address)

    if address != account.address:
        print("Running with agent address:", account.address)
    info = Info(base_url, skip_ws, perp_dexs=perp_dexs)
    user_state = info.user_state(address)
    spot_user_state = info.spot_user_state(address)
    margin_summary = user_state["marginSummary"]
    if (
        float(margin_summary["accountValue"]) == 0
        and len(spot_user_state["balances"]) == 0
    ):
        print("Not running the example because the provided account has no equity.")
        url = info.base_url.split(".", 1)[1]
        error_string = f"No accountValue:\nIf you think this is a mistake, make sure that {address} has a balance on {url}.\nIf address shown is your API wallet address, update the config to specify the address of your account, not the address of the API wallet."
        raise Exception(error_string)
    exchange = Exchange(account, base_url, account_address=address, perp_dexs=perp_dexs)
    return address, info, exchange


def get_secret_key(config):
    if config["secret_key"]:
        secret_key = config["secret_key"]
    else:
        keystore_path = config["keystore_path"]
        keystore_path = os.path.expanduser(keystore_path)
        if not os.path.isabs(keystore_path):
            keystore_path = os.path.join(os.path.dirname(__file__), keystore_path)
        if not os.path.exists(keystore_path):
            raise FileNotFoundError(f"Keystore file not found: {keystore_path}")
        if not os.path.isfile(keystore_path):
            raise ValueError(f"Keystore path is not a file: {keystore_path}")
        with open(keystore_path) as f:
            keystore = json.load(f)
        password = getpass.getpass("Enter keystore password: ")
        secret_key = eth_account.Account.decrypt(keystore, password)
    return secret_key


def setup_multi_sig_wallets():
    config_path = os.path.join(os.path.dirname(__file__), "config.json")
    with open(config_path) as f:
        config = json.load(f)

    authorized_user_wallets = []
    for wallet_config in config["multi_sig"]["authorized_users"]:
        account: LocalAccount = eth_account.Account.from_key(
            wallet_config["secret_key"]
        )
        address = wallet_config["account_address"]
        if account.address != address:
            raise Exception(
                f"provided authorized user address {address} does not match private key"
            )
        print("loaded authorized user for multi-sig", address)
        authorized_user_wallets.append(account)
    return authorized_user_wallets

✅ DEX 交易所, 查看 API 下单记录:

✅ DEX ETH-USD 交易对, 成交历史:
- https://app.hyperliquid-testnet.xyz/trade/ETH
- K 线上, 对应一条 买 和 卖 记录标记.

Uh oh!

DEX - Hyperliquid #441

Description

📖 Abstract:

💯 Related:

Metadata

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue actions