Hyperliquid-Python-SDK完全指南：从安装到首笔交易的快速上手教程

【免费下载链接】hyperliquid-python-sdk SDK for Hyperliquid API trading with Python. 项目地址: https://gitcode.com/gh_mirrors/hy/hyperliquid-python-sdk

Hyperliquid-Python-SDK是一款专为Hyperliquid API交易设计的Python开发工具包，它提供了简洁易用的接口，帮助开发者快速接入Hyperliquid交易平台，实现自动化交易策略。无论是加密货币交易新手还是有经验的开发者，都能通过本指南快速掌握SDK的使用方法，轻松开启你的量化交易之旅。

一、Hyperliquid-Python-SDK简介 📚

Hyperliquid-Python-SDK是Hyperliquid交易平台官方推出的Python开发工具包，旨在简化开发者与Hyperliquid API的交互过程。通过该SDK，你可以轻松实现账户管理、订单提交、市场数据获取等功能，为你的量化交易策略开发提供强大支持。

该SDK具有以下特点：

• 简洁易用的API接口
• 全面支持Hyperliquid交易功能
• 丰富的示例代码
• 完善的错误处理机制

二、快速安装Hyperliquid-Python-SDK ⚡

安装Hyperliquid-Python-SDK非常简单，你可以通过pip命令一键安装：

pip install hyperliquid-python-sdk

如果你需要从源码安装，可以按照以下步骤操作：

1. 克隆仓库：

git clone https://gitcode.com/gh_mirrors/hy/hyperliquid-python-sdk

2. 进入项目目录：

cd hyperliquid-python-sdk

3. 使用Makefile安装：

make install

三、环境配置与准备工作 🔧

在使用Hyperliquid-Python-SDK之前，你需要完成以下准备工作：

3.1 获取API密钥

1. 访问Hyperliquid官方网站，注册并登录你的账户。
2. 在API设置页面生成新的API密钥。
3. 保存好你的API密钥，稍后会用到。

3.2 配置API密钥

1. 复制示例配置文件：

cp examples/config.json.example examples/config.json

2. 编辑配置文件，填入你的API信息：

vim examples/config.json

3. 在配置文件中设置以下参数：
   • account_address: 你的公钥
   • secret_key: 你的API私钥

注意：account_address应设置为主钱包的公钥，而不是API钱包的公钥。

四、SDK核心功能与使用示例 🚀

4.1 初始化SDK

在使用SDK之前，你需要先初始化API客户端。以下是初始化的基本示例：

from hyperliquid.utils.constants import TESTNET_API_URL
from examples import example_utils

address, info, exchange = example_utils.setup(TESTNET_API_URL, skip_ws=True)

这段代码会从配置文件中加载你的API密钥，并初始化一个连接到测试网的客户端。如果你需要连接主网，可以使用MAINNET_API_URL。

4.2 获取市场数据

Hyperliquid-Python-SDK提供了丰富的市场数据获取功能。例如，你可以获取交易对的最新价格、深度数据等：

# 获取交易对信息
symbol = "BTC-USDC"
ticker = info.ticker(symbol)
print(f"{symbol} 最新价格: {ticker['last']}")

4.3 提交订单

使用SDK提交订单非常简单。以下是一个限价单的示例：

# 提交限价买单
order_result = exchange.order(symbol, True, 0.001, 30000)
print("订单提交结果:", order_result)

其中，参数含义如下：

• symbol: 交易对
• is_buy: 是否为买单（True为买，False为卖）
• quantity: 数量
• price: 价格

4.4 查看订单状态

你可以通过以下代码查看当前未成交的订单：

# 获取未成交订单
open_orders = info.open_orders(address)
print("未成交订单:", open_orders)

4.5 取消订单

如果需要取消订单，可以使用以下代码：

# 取消订单
cancel_result = exchange.cancel(symbol, order_id)
print("取消订单结果:", cancel_result)

五、完整交易示例：从下单到平仓 🔄

以下是一个完整的交易示例，展示了如何使用Hyperliquid-Python-SDK进行下单、查看订单状态和取消订单的全过程：

from hyperliquid.utils.constants import TESTNET_API_URL
from examples import example_utils

def main():
    # 初始化客户端
    address, info, exchange = example_utils.setup(TESTNET_API_URL, skip_ws=True)
    print(f"已连接到Hyperliquid测试网，账户地址: {address}")
    
    # 交易参数
    symbol = "BTC-USDC"
    quantity = 0.001
    price = 30000
    
    # 提交限价买单
    print(f"提交 {symbol} 限价买单: {quantity} @ {price}")
    order_result = exchange.order(symbol, True, quantity, price)
    print("订单提交结果:", order_result)
    
    # 获取订单ID
    order_id = order_result["response"]["data"]["orderId"]
    print(f"订单ID: {order_id}")
    
    # 查看未成交订单
    open_orders = info.open_orders(address)
    print("当前未成交订单:", open_orders)
    
    # 取消订单
    print(f"取消订单 {order_id}")
    cancel_result = exchange.cancel(symbol, order_id)
    print("取消订单结果:", cancel_result)

if __name__ == "__main__":
    main()

你可以在examples/basic_order.py文件中找到更多类似的示例代码。

六、进阶使用：探索更多功能 🌟

Hyperliquid-Python-SDK提供了丰富的功能，除了基本的交易操作外，还支持以下高级功能：

6.1 现货交易

你可以使用basic_spot_order.py示例来进行现货交易：

python examples/basic_spot_order.py

6.2 杠杆调整

通过basic_leverage_adjustment.py示例，你可以调整杠杆倍数：

python examples/basic_leverage_adjustment.py

6.3 止损止盈订单

使用basic_tpsl.py示例，你可以设置止损止盈订单：

python examples/basic_tpsl.py

6.4 批量取消订单

如果需要取消所有未成交订单，可以使用cancel_open_orders.py示例：

python examples/cancel_open_orders.py

七、常见问题与解决方案 ❓

7.1 安装问题

如果在安装过程中遇到问题，可以尝试以下解决方案：

• 确保使用Python 3.10或更高版本
• 使用Poetry安装依赖：poetry install
• 对于macOS用户，可能需要指定Python版本：brew install python@3.10 && poetry env use /opt/homebrew/Cellar/python@3.10/3.10.16/bin/python3.10

7.2 API连接问题

如果无法连接到API，检查以下几点：

• 确保API密钥正确配置
• 检查网络连接
• 确认使用了正确的API URL（测试网或主网）

7.3 订单提交失败

订单提交失败可能有多种原因：

• 余额不足
• 价格超出允许范围
• 数量过小或过大
• API密钥权限不足

八、总结 📝

通过本指南，你已经了解了Hyperliquid-Python-SDK的基本安装、配置和使用方法。从简单的市场数据获取到复杂的交易策略实现，Hyperliquid-Python-SDK都能为你提供强大的支持。

无论你是量化交易新手还是经验丰富的开发者，Hyperliquid-Python-SDK都能帮助你快速接入Hyperliquid交易平台，实现你的交易策略。现在就开始探索吧，开启你的量化交易之旅！

如果你需要更多帮助，可以查阅项目中的示例代码，或参考SDK的源代码文件，如hyperliquid/exchange.py和hyperliquid/info.py。祝你交易顺利！

【免费下载链接】hyperliquid-python-sdk SDK for Hyperliquid API trading with Python. 项目地址: https://gitcode.com/gh_mirrors/hy/hyperliquid-python-sdk