# hyperliquid-dex/hyperliquid-python-sdk architecture

> Architecture diagram of the GitHub repository hyperliquid-dex/hyperliquid-python-sdk, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hyperliquid-dex/hyperliquid-python-sdk
- Repository: https://github.com/hyperliquid-dex/hyperliquid-python-sdk

## Overview

This is a Python SDK for trading and account data on Hyperliquid. A typical workflow creates an Info client to retrieve market or user data, then uses Exchange to construct and sign an action and submit it through the shared HTTP API; callers can also subscribe to streaming updates. Exchange covers the documented example domains, including orders, transfers, staking, vaults, and deployment actions. The graph reflects the sampled source and README; unsampled method details are represented at the Exchange subsystem level.

Main entry points: [`hyperliquid/api.py`](https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/hyperliquid/api.py) (HTTP transport), [`hyperliquid/exchange.py`](https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/hyperliquid/exchange.py) (Trading and actions), [`hyperliquid/info.py`](https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/hyperliquid/info.py) (Market and account data), [`hyperliquid/websocket_manager.py`](https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/hyperliquid/websocket_manager.py) (Subscription manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["SDK clients"]
  node_info["Market and account data<br/>[info.py]"]
  node_exchange["Trading and actions<br/>[exchange.py]"]
end

subgraph group_protocol["Protocol layer"]
  node_http["HTTP transport<br/>[api.py]"]
  node_signing["Action signing<br/>[signing.py]"]
  node_types["API data types<br/>[types.py]"]
  node_errors["HTTP errors<br/>[error.py]"]
  node_constants["Endpoint constants<br/>[constants.py]"]
end

subgraph group_streaming["Streaming data"]
  node_ws_manager["Subscription manager"]
end

node_user(("SDK caller"))
node_hyperliquid_http["Hyperliquid HTTP API"]
node_hyperliquid_ws["Hyperliquid WebSocket"]

node_user -->|"requests data"| node_info
node_user -->|"submits actions"| node_exchange
node_info -->|"queries through"| node_http
node_exchange -->|"submits through"| node_http
node_exchange -->|"reads market data"| node_info
node_exchange -->|"signs actions"| node_signing
node_http -->|"sends requests"| node_hyperliquid_http
node_http -->|"raises errors"| node_errors
node_http -->|"uses endpoint"| node_constants
node_info -->|"starts subscriptions"| node_ws_manager
node_ws_manager -->|"connects and subscribes"| node_hyperliquid_ws

click node_info "https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/hyperliquid/info.py"
click node_exchange "https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/hyperliquid/exchange.py"
click node_http "https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/hyperliquid/api.py"
click node_signing "https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/hyperliquid/utils/signing.py"
click node_types "https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/hyperliquid/utils/types.py"
click node_errors "https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/hyperliquid/utils/error.py"
click node_constants "https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/hyperliquid/utils/constants.py"
click node_ws_manager "https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/hyperliquid/websocket_manager.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_info,node_exchange toneBlue
class node_http,node_signing,node_types,node_errors,node_constants toneAmber
class node_ws_manager,node_hyperliquid_http toneMint
class node_user,node_hyperliquid_ws toneIndigo
```

## Components

### SDK clients

- [Market and account data](https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/hyperliquid/info.py): `hyperliquid/info.py`
- [Trading and actions](https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/hyperliquid/exchange.py): `hyperliquid/exchange.py`

### Protocol layer

- [HTTP transport](https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/hyperliquid/api.py): `hyperliquid/api.py`
- [Action signing](https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/hyperliquid/utils/signing.py): `hyperliquid/utils/signing.py`
- [API data types](https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/hyperliquid/utils/types.py): `hyperliquid/utils/types.py`
- [HTTP errors](https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/hyperliquid/utils/error.py): `hyperliquid/utils/error.py`
- [Endpoint constants](https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/hyperliquid/utils/constants.py): `hyperliquid/utils/constants.py`

### Streaming data

- [Subscription manager](https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/hyperliquid/websocket_manager.py): `hyperliquid/websocket_manager.py`

### Other components

- **SDK caller**
- **Hyperliquid HTTP API**
- **Hyperliquid WebSocket**

## Connections

- SDK caller → Market and account data: requests data (evidence: `README.md`)
- SDK caller → Trading and actions: submits actions (evidence: `README.md`)
- Market and account data → HTTP transport: queries through (evidence: `hyperliquid/info.py`)
- Trading and actions → HTTP transport: submits through (evidence: `hyperliquid/exchange.py`)
- Trading and actions → Market and account data: reads market data (evidence: `hyperliquid/exchange.py`)
- Trading and actions → Action signing: signs actions (evidence: `hyperliquid/exchange.py`)
- HTTP transport → Hyperliquid HTTP API: sends requests (evidence: `hyperliquid/api.py`)
- HTTP transport → HTTP errors: raises errors (evidence: `hyperliquid/api.py`)
- HTTP transport → Endpoint constants: uses endpoint (evidence: `hyperliquid/api.py`)
- Market and account data → Subscription manager: starts subscriptions (evidence: `hyperliquid/info.py`)
- Subscription manager → Hyperliquid WebSocket: connects and subscribes (evidence: `hyperliquid/websocket_manager.py`)
