Struct HyperliquidClient 

pub struct HyperliquidClient { /* private fields */ }

Implementations

impl HyperliquidClient

pub fn new() -> Self

pub fn with_auth(user_address: impl Into<String>, private_key: String) -> Self

Examples found in repository

examples/check_balance.rs (line 8)

async fn main() {
    let addr = std::env::var("HYPERLIQUID_WALLET_ADDRESS").expect("missing addr");
    let key = std::env::var("HYPERLIQUID_WALLET_KEY").expect("missing key");
    let client = HyperliquidClient::with_auth(addr, key);

    match client.get_balance().await {
        Ok(balances) => {
            println!("{} balances returned:", balances.len());
            for b in &balances {
                println!("\n--- {} ---", b.token);
                println!("  equity:     {}", b.equity);
                println!("  free:       {}", b.free);
                println!("  hold:       {}", b.hold);
                println!("  safe:       {:?}", b.safe);
                println!("  usable:     {}", b.usable);
                println!("  maintenance:{:?}", b.maintenance);
                println!("  margin_used:{:?}", b.margin_used);
            }
        }
        Err(e) => eprintln!("ERROR: {e}"),
    }
}

pub fn with_budgets(self, rest_weight: u32, addr_budget: u64) -> Self

Configure rate limit budgets (rest_weight/min, address_requests). Defaults: 1200 rest weight/min, 10000 address requests.

Trait Implementations

impl Default for HyperliquidClient

fn default() -> Self

Returns the “default value” for a type.

impl GetAccountSnapshot for HyperliquidClient

async fn get_positions(&self) -> Result<Vec<Position>, String>

Returns open positions from clearinghouseState. Requires with_auth. Zero-size positions are filtered out. Positive szi = long, negative = short.

async fn get_open_orders(&self) -> Result<Vec<OpenOrder>, String>

Returns resting orders from Hyperliquid’s openOrders endpoint. Requires with_auth. filled_quantity is derived as origSz - sz (original size minus remaining size).

async fn get_balance(&self) -> Result<Vec<AccountBalance>, String>

Returns all per-asset balances from spotClearinghouseState with margin health. Requires with_auth.

async fn get_user_rate_limit(&self) -> Result<UserRateLimit, String>

Returns the user’s address-level API rate limit budget. Queries Hyperliquid’s userRateLimit info endpoint for authoritative server-side counts.

impl GetMarketData for HyperliquidClient

async fn get_symbol(&self) -> Result<Vec<String>, String>

Returns all perpetual asset names from Hyperliquid’s meta endpoint.

async fn get_open_interest(&self, symbol: String) -> Result<Decimal, String>

Returns the current open interest for symbol from metaAndAssetCtxs.

async fn get_asset_context( &self, symbol: String, ) -> Result<AssetContext, String>

Returns a full AssetContext snapshot for symbol from metaAndAssetCtxs.

async fn get_all_asset_contexts(&self) -> Result<Vec<AssetContext>, String>

Fetches metaAndAssetCtxs once and returns all asset contexts in universe order. Prefer this over repeated get_asset_context calls to avoid rate-limiting.

async fn get_sz_decimals(&self, symbol: String) -> Result<i32, String>

Returns the number of decimal places for order size for a symbol.

async fn get_all_sz_decimals(&self) -> Result<HashMap<String, i32>, String>

Returns sz_decimals for all symbols from the meta universe.

async fn get_l2_orderbook(&self, symbol: String) -> Result<L2Snapshot, String>

Returns a full L2 orderbook snapshot for symbol from the l2Book REST endpoint.

async fn get_price(&self, symbol: String) -> Result<Decimal, String>

Returns the mid-price of symbol (e.g. “BTC”) from allMids.

async fn get_predicted_fundings(&self) -> Result<Vec<PredictedFunding>, String>

Returns predicted funding rates for all symbols across all venues. Null venue entries (unsupported coins) are silently skipped.

impl ManageOrder for HyperliquidClient

async fn place_order( &self, symbol: String, side: OrderSide, price: Decimal, volume: Decimal, order_type: OrderType, time_in_force: TimeInForce, trigger_price: Option<Decimal>, reduce_only: bool, cloid: Option<String>, ) -> Result<OrderPlacement, String>

Places an order on Hyperliquid. Requires with_auth. Returns an OrderPlacement with the exchange-assigned order ID. Market orders are submitted as aggressive limit orders (IOC).

If cloid is provided, Hyperliquid attaches it to the order lifecycle — fills and order updates will carry the same cloid back, enabling end-to-end intent tracing without a separate order_id mapping.

Trigger orders (TakeProfit / StopLoss) require trigger_price to be set. The order activates when the mark price reaches triggerPx, then executes as a market or limit order depending on time_in_force (Ioc = market, Gtc = limit).

async fn change_order_by_cloid( &self, cloid: i64, price: Decimal, volume: Decimal, ) -> Result<i64, String>

Modifies price and size of an existing order by its order ID. Requires with_auth. Fetches the order’s current coin and side before submitting the modify action.

async fn cancel_order_by_cloid(&self, cloid: String) -> Result<(), String>

Cancels a single order by its client order ID (cloid). Requires with_auth. Fetches open orders to resolve the order ID for the matching cloid, then submits a cancel action using the order ID — this works for all order types including trigger orders (TakeProfit/StopLoss).

async fn cancel_all_order(&self) -> Result<bool, String>

Cancels all open orders. Requires with_auth. Fetches all open orders and submits a batch cancel in a single signed request.

impl SubscribeMarketData for HyperliquidClient

async fn unsubscribe_all(&self)

Gracefully shut down all market data subscriptions. Closes all broadcast channels so subscribers exit without reconnecting.

fn subscribe_l2_update( &self, symbol: String, ) -> BoxStream<Result<L2Update, String>>

subscribe to L2 orderbook updates for a symbol

fn subscribe_l2_snapshot( &self, symbol: String, ) -> BoxStream<Result<L2Snapshot, String>>

subscribe to full L2 orderbook snapshots for a symbol

fn subscribe_asset_context( &self, symbol: String, ) -> BoxStream<Result<AssetContext, String>>

subscribe to asset context updates (OI, funding rate, mark price, 24h volume)

fn subscribe_liquidation( &self, user: String, ) -> BoxStream<Result<Liquidation, String>>

subscribe to liquidation events for a user address

fn subscribe_fill(&self, symbol: String) -> BoxStream<Result<Fill, String>>

subscribe to market fill events for a symbol

impl SubscribeMarketDataOps for HyperliquidClient

async fn unsubscribe_market_data(&self, symbol: String)

unsubscribe from market data streams for a symbol

impl SubscribeUserEvents for HyperliquidClient

fn subscribe_spot_balance( &self, ) -> BoxStream<Result<Vec<AccountBalance>, String>>

Subscribe to spot wallet balance updates for the registered user address.

fn subscribe_spot_balance_with_address( &self, address: String, ) -> BoxStream<Result<Vec<AccountBalance>, String>>

Subscribe to spot wallet balance updates for a specific address.

fn subscribe_user_fills(&self) -> BoxStream<Result<UserFill, String>>

stream executions of the user’s own orders

fn subscribe_order_updates(&self) -> BoxStream<Result<OrderUpdate, String>>

stream order lifecycle updates

fn subscribe_funding_payments( &self, ) -> BoxStream<Result<FundingPayment, String>>

stream funding payments applied to positions

fn subscribe_deposits(&self) -> BoxStream<Result<Deposit, String>>

stream account deposit events

fn subscribe_withdrawals(&self) -> BoxStream<Result<Withdrawal, String>>

stream account withdrawal events

async fn unsubscribe_user_events(&self)

unsubscribe from all user event streams

impl TestServer for HyperliquidClient

async fn ping(&self) -> Result<bool, String>

Sends a lightweight allMids request; returns true if the server responds 200 OK.

async fn get_server_time(&self) -> Result<i64, String>

Hyperliquid has no dedicated server-time endpoint; returns local UTC ms.