---
id: hyperliquid-python-sdk
version: "0.24.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# hyperliquid-python-sdk — SDK for Hyperliquid API trading with Python.

License: permissive · Maintenance: active · Downloads: 596.9K/mo

## What it is and what it does

This is a Python client library for the Hyperliquid decentralized exchange, enabling developers to interact with trading APIs programmatically. It wraps HTTP and WebSocket communication to the Hyperliquid platform, handling authentication via private keys and providing methods to query account state, place orders, and retrieve market data. The SDK depends on eth-utils, eth-account, websocket-client, requests, and msgpack for Ethereum key management, network communication, and data serialization.

The package is designed for traders and developers building bots or applications on top of Hyperliquid. Configuration is file-based (JSON), and the SDK supports both mainnet and testnet environments. It is currently classified as Alpha, meaning the API surface may change; the repository is actively maintained with recent commits and a growing user base.

Use it for:

- Build automated trading bots that place orders and monitor positions on Hyperliquid without manual intervention
- Query real-time account state, balances, and open orders programmatically for portfolio tracking
- Integrate Hyperliquid trading into larger financial applications or risk-management systems
- Test trading strategies on testnet before deploying to production with live capital

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python SDK for trading on the Hyperliquid decentralized exchange API, providing programmatic access to order placement, account state queries, and market data.

Yes, if you are actively trading on Hyperliquid or building applications around it. The package has low install friction, active maintenance, permissive licensing, and no known vulnerabilities. The Alpha status means the API may change between releases, so pin your version and monitor releases. Not suitable if you need a stable, long-term-guaranteed API contract.

## Install

pip install hyperliquid-python-sdk
uv add hyperliquid-python-sdk
poetry add hyperliquid-python-sdk

## Installing hyperliquid-python-sdk

Before you install: Low install friction with a pure-Python wheel distribution. Active maintenance with recent releases; last commit 2026-06-04 and 1783 repository stars indicate ongoing development.

License in practice: MIT license is permissive; you can use this package freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install hyperliquid-python-sdk

from hyperliquid.info import Info
from hyperliquid.utils import constants

info = Info(constants.TESTNET_API_URL, skip_ws=True)
user_state = info.user_state("0xcd5051944f780a621ee62e39e493c489668acf4d")
print(user_state)

Requires Python 3.9 or higher; development is tested on Python 3.10 specifically. Private key configuration required for trading operations.

Verify before relying:

- Production readiness and stability guarantees beyond 'Alpha' development status classifier
- Performance characteristics under high-frequency or high-volume trading scenarios
- Completeness of API coverage relative to the full Hyperliquid exchange feature set

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 596.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

hyperliquid trading api python, dex trading sdk python, hyperliquid order placement, cryptocurrency exchange api client, decentralized exchange python sdk, trading-api, ethereum, dex

[View on SkillFed](https://skillfed.io/packages/hyperliquid-python-sdk) · [View on PyPI](https://pypi.org/project/hyperliquid-python-sdk/)