Struct HyperliquidRawHttpClient 

pub struct HyperliquidRawHttpClient { /* private fields */ }

Provides a raw HTTP client for low-level Hyperliquid REST API operations.

This client handles HTTP infrastructure, request signing, and raw API calls that closely match Hyperliquid endpoint specifications.

Implementations

impl HyperliquidRawHttpClient

pub fn new( environment: HyperliquidEnvironment, timeout_secs: u64, proxy_url: Option<String>, ) -> Result<Self, HttpClientError>

Creates a new HyperliquidRawHttpClient for public endpoints only.

Errors

Returns an error if the HTTP client cannot be created.

pub fn with_credentials( secrets: &Secrets, timeout_secs: u64, proxy_url: Option<String>, ) -> Result<Self, HttpClientError>

Creates a new HyperliquidRawHttpClient configured with credentials for authenticated requests.

Errors

Returns an error if the HTTP client cannot be created.

pub fn set_base_info_url(&mut self, url: String)

Overrides the base info URL (for testing with mock servers).

pub fn set_base_exchange_url(&mut self, url: String)

Overrides the base exchange URL (for testing with mock servers).

pub fn from_env(environment: HyperliquidEnvironment) -> Result<Self>

Creates an authenticated client from environment variables for the specified network.

Errors

Returns Error::Auth if required environment variables are not set.

pub fn from_credentials( private_key: &str, vault_address: Option<&str>, environment: HyperliquidEnvironment, timeout_secs: u64, proxy_url: Option<String>, ) -> Result<Self>

Creates a new HyperliquidRawHttpClient configured with explicit credentials.

Errors

Returns Error::Auth if the private key is invalid or cannot be parsed.

pub fn with_rate_limits(self) -> Self

Configure rate limiting parameters (chainable).

pub fn environment(&self) -> HyperliquidEnvironment

Returns the configured environment.

pub fn is_testnet(&self) -> bool

Returns whether this client is configured for testnet.

pub fn get_user_address(&self) -> Result<String>

Gets the user address derived from the private key (if client has credentials).

Errors

Returns Error::Auth if the client has no signer configured.

pub fn has_vault_address(&self) -> bool

Returns true if a vault address is configured.

pub fn get_account_address(&self) -> Result<String>

Gets the account address for queries: vault address if configured, otherwise the user (EOA) address.

Errors

Returns Error::Auth if the client has no signer configured.

pub async fn info_meta(&self) -> Result<HyperliquidMeta>

Get metadata about available markets.

pub async fn get_spot_meta(&self) -> Result<SpotMeta>

Get complete spot metadata (tokens and pairs).

pub async fn get_perp_meta_and_ctxs(&self) -> Result<PerpMetaAndCtxs>

Get perpetuals metadata with asset contexts (for price precision refinement).

pub async fn get_spot_meta_and_ctxs(&self) -> Result<SpotMetaAndCtxs>

Get spot metadata with asset contexts (for price precision refinement).

pub async fn get_outcome_meta(&self) -> Result<OutcomeMeta>

Get outcome metadata.

pub async fn info_l2_book(&self, coin: &str) -> Result<HyperliquidL2Book>

Get L2 order book for a coin.

pub async fn info_recent_trades( &self, coin: &str, ) -> Result<Vec<HyperliquidRecentTrade>>

Get recent public trades for a coin.

Returns a recent snapshot (newest first) with no time range. Depends on the Hyperliquid indexer: self-hosted /info nodes return HTTP 422.

pub async fn info_user_fills(&self, user: &str) -> Result<HyperliquidFills>

Get user fills (trading history).

pub async fn info_order_status( &self, user: &str, oid: u64, ) -> Result<HyperliquidOrderStatus>

Get order status for a user.

pub async fn info_open_orders(&self, user: &str) -> Result<Value>

Get all open orders for a user.

pub async fn info_frontend_open_orders(&self, user: &str) -> Result<Value>

Get frontend open orders (includes more detail) for a user.

pub async fn info_clearinghouse_state(&self, user: &str) -> Result<Value>

Get clearinghouse state (balances, positions, margin) for a user.

pub async fn info_spot_clearinghouse_state(&self, user: &str) -> Result<Value>

Get spot clearinghouse state (per-token spot balances) for a user.

pub async fn info_user_fees(&self, user: &str) -> Result<Value>

Get user fee schedule and effective rates.

pub async fn info_candle_snapshot( &self, coin: &str, interval: HyperliquidBarInterval, start_time: u64, end_time: u64, ) -> Result<HyperliquidCandleSnapshot>

Get candle/bar data for a coin.

pub async fn info_funding_history( &self, coin: &str, start_time: u64, end_time: Option<u64>, ) -> Result<Vec<HyperliquidFundingHistoryEntry>>

Get historical funding rates for a coin.

start_time and end_time are Unix milliseconds. end_time is optional; if omitted, the venue returns entries up to the most recent funding.

pub async fn send_info_request_raw( &self, request: &InfoRequest, ) -> Result<Value>

Generic info request method that returns raw JSON (useful for new endpoints and testing).

pub async fn post_action( &self, action: &ExchangeAction, ) -> Result<HyperliquidExchangeResponse>

Send a signed action to the exchange.

pub fn sign_action_exec_request( &self, action: &HyperliquidExecAction, expires_after: Option<u64>, ) -> Result<HyperliquidExchangeRequest<HyperliquidExecAction>>

Build a signed exchange request using the typed HyperliquidExecAction enum.

pub async fn post_action_exec( &self, action: &HyperliquidExecAction, ) -> Result<HyperliquidExchangeResponse>

Send a signed action to the exchange using the typed HyperliquidExecAction enum.

This is the preferred method for placing orders as it uses properly typed structures that match Hyperliquid’s API expectations exactly.

pub async fn rest_limiter_snapshot(&self) -> RateLimitSnapshot

Submit a single order to the Hyperliquid exchange.

Trait Implementations

impl Clone for HyperliquidRawHttpClient

fn clone(&self) -> HyperliquidRawHttpClient

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HyperliquidRawHttpClient

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.