rhyperliquid

A Rust SDK for Hyperliquid, the high-performance perpetuals decentralized exchange. Built with type safety in mind and async-first architecture.

⚠️ Please test all desired operations on Testnet before operating on Mainnet

Features

Market data queries (spot & perpetuals)
Account information retrieval
Order book snapshots
Historical candle data
User fills and funding history
Order placement and cancellation
Position management
Vault operations

Project Status

Complete REST Info API (market data)
EIP-712 authentication & message signing
Exchange API (order placement, cancellation)
WebSocket streaming (real-time data feeds)
CLI

Quick Start

use rhyperliquid::HyperliquidClient;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = HyperliquidClient::builder()
        .testnet()
        .build()?;

    // Get real-time mid prices for all assets
    let mids = client.info().get_all_mids().await?;
    println!("BTC: ${}", mids.get("BTC").unwrap());

    // Fetch L2 orderbook snapshot
    let book = client.info().get_l2_book("ETH").await?;
    println!("Best bid: ${}", book.levels[0].px);

    Ok(())
}

Trading

For order placement and cancellation examples, see examples/basic_order.rs.

For account transfer examples, see examples/account_transfer.rs.

For position leverage and managing an isolated position see examples/leverage_position.rs.

For advanced order examples see examples/advanced_order.rs.

For TWAP order placement see examples/twap_order.rs.

Stability and API Guarantees

This crate is under active development.

Breaking changes may occur between minor versions (0.1 -> 0.2).

Public API is subject to refinement based on usage feedback.

Testnet testing is strongly recommended before mainnet use.

Installation

As a Library Dependency

Add to your Cargo.toml:

[dependencies]
rhyperliquid = "0.1"
tokio = { version = "1.41", features = ["full"] }

From Source

Clone and build the repository:

# Clone the repository
git clone https://github.com/elijahhampton/rhyperliquid.git
cd rhyperliquid

# Build the library
cargo build --release

# Run tests
cargo test --all-features

# Build documentation
cargo doc --open

Getting Help

If you have any questions, first see if the answer to your question can be found in the Hyperliquid Docs.

If the answer is not there:

Open a discussion with your question, or Open an issue with the bug

Minimum Supported Rust Version (MSRV)

Rust 1.75.0 or higher is required.

# Verify your Rust version
rustc --version

rustup update stable

rhyperliquid 0.1.0