如何用hyperliquid-python-sdk构建你的第一个DEX交易应用？

Hyperliquid Python SDK是专为与Hyperliquid DEX交互设计的Python库，核心功能包括链上资产交换、订单管理、账户状态查询等，助力开发者快速集成去中心化交易功能。

核心价值：为什么选择Hyperliquid Python SDK？

1. 一站式DEX交互解决方案

提供从账户管理到订单执行的全流程API，无需手动处理底层区块链交互细节。

2. 完善的错误处理机制

通过hyperliquid/utils/error.py定义的自定义异常类，可精准捕获API调用中的各类错误。

3. 丰富的示例代码库

examples/目录下包含20+实用案例，覆盖从基础订单到多签钱包等复杂场景。

📌 重点总结：该SDK通过封装底层复杂性，让开发者专注于业务逻辑，显著降低去中心化交易应用的开发门槛。

快速上手：5分钟启动指南

1. 环境准备

git clone https://gitcode.com/gh_mirrors/hy/hyperliquid-python-sdk
cd hyperliquid-python-sdk
pip install poetry
poetry install

2. 初始化API客户端

from hyperliquid.api import API

# 初始化主网API（默认）
api = API()
# 测试网环境
# api = API("testnet")

3. 首次查询市场信息

# 获取所有交易对信息
mids = api.all_mids()
print(f"当前交易对数量: {len(mids)}")

📌 重点总结：通过3步即可完成环境搭建和基础API调用，examples/basic_order.py提供完整的订单创建示例。

深度探索：核心能力解析

手把手教你调用核心模块

1. 市场数据查询（hyperliquid/info.py）

当你需要获取实时行情时：

from hyperliquid.info import Info

info = Info()
# 获取BTC-USDC最新价格
btc_price = info.price("BTC-USDC")

2. 订单管理（hyperliquid/exchange.py）

当你需要下单交易时：

from hyperliquid.exchange import Exchange
from hyperliquid.utils.types import Order

exchange = Exchange("your_private_key")
order = Order(coin="BTC-USDC", is_buy=True, sz=0.001, limit_px=30000)
result = exchange.order(order)

3. WebSocket实时数据（hyperliquid/websocket_manager.py）

当你需要监听市场变化时：

from hyperliquid.websocket_manager import WebsocketManager

def handle_update(update):
    print("收到市场更新:", update)

ws = WebsocketManager()
ws.subscribe("BTC-USDC", handle_update)

避坑指南：3个必知配置技巧

配置方式	优点	缺点	适用场景
环境变量	安全性高，易于部署	需要额外依赖管理	生产环境
配置文件	集中管理，易于版本控制	敏感信息暴露风险	开发环境
硬编码	快速测试，无需额外配置	安全性差，不便于维护	临时调试

💡 推荐做法：使用环境变量存储API密钥等敏感信息，配合python-dotenv库加载：

import os
from dotenv import load_dotenv

load_dotenv()
private_key = os.getenv("HYPERLIQUID_PRIVATE_KEY")

📌 重点总结：核心模块覆盖市场数据、订单操作和实时推送三大功能，配置时遵循"环境变量>配置文件>硬编码"的优先级原则。

高级应用：场景化案例实践

场景1：批量取消订单

from hyperliquid.exchange import Exchange

exchange = Exchange("your_private_key")
# 取消所有BTC-USDC的挂单
exchange.cancel_all_orders("BTC-USDC")

场景2：现货转永续合约

from hyperliquid.exchange import Exchange

exchange = Exchange("your_private_key")
# 将10 USDC从现货账户转到永续合约账户
exchange.spot_to_perp(10, "USDC")

场景3：多签钱包订单

from hyperliquid.exchange import Exchange
from hyperliquid.utils.signing import MultiSig

# 初始化多签签名器
multisig = MultiSig([key1, key2, key3], 2)  # 2/3签名
exchange = Exchange(multisig)
# 创建多签订单
order = Order(coin="ETH-USDC", is_buy=True, sz=0.1, limit_px=2000)
exchange.order(order)

📌 重点总结：通过examples/目录下的multi_sig_order.py、basic_spot_to_perp.py等文件，可快速实现复杂交易场景。

总结与进阶

Hyperliquid Python SDK提供了从基础到高级的完整DEX交互能力，通过本文介绍的核心模块和配置最佳实践，你可以快速构建功能完善的去中心化交易应用。建议进一步阅读：

• 官方示例：examples/目录下的20+实用案例
• 测试代码：tests/info_test.py了解API调用的边界情况
• 类型定义：hyperliquid/utils/types.py掌握数据结构规范

持续关注项目更新，获取更多高级功能和性能优化技巧。