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( is_testnet: bool, timeout_secs: Option<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: Option<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 from_env() -> Result<Self>

Creates an authenticated client from environment variables.

Errors

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

pub fn from_credentials( private_key: &str, vault_address: Option<&str>, is_testnet: bool, timeout_secs: Option<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 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 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 info_l2_book(&self, coin: &str) -> Result<HyperliquidL2Book>

Get L2 order book for a coin.

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_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 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 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.

impl<'py> IntoPyObject<'py> for HyperliquidRawHttpClient

type Target = HyperliquidRawHttpClient

The Python output type

type Output = Bound<'py, <HyperliquidRawHttpClient as IntoPyObject<'py>>::Target>

The smart pointer type to use.

type Error = PyErr

The type returned in the event of a conversion error.

fn into_pyobject( self, py: Python<'py>, ) -> Result<<Self as IntoPyObject<'_>>::Output, <Self as IntoPyObject<'_>>::Error>

Performs the conversion.

impl PyClass for HyperliquidRawHttpClient

type Frozen = False

Whether the pyclass is frozen.

impl PyClassImpl for HyperliquidRawHttpClient

const IS_BASETYPE: bool = false

#[pyclass(subclass)]

const IS_SUBCLASS: bool = false

#[pyclass(extends=…)]

const IS_MAPPING: bool = false

#[pyclass(mapping)]

const IS_SEQUENCE: bool = false

#[pyclass(sequence)]

const IS_IMMUTABLE_TYPE: bool = false

#[pyclass(immutable_type)]

const RAW_DOC: &'static CStr = /// 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.

Docstring for the class provided on the struct or enum.

const DOC: &'static CStr

Fully rendered class doc, including the text_signature if a constructor is defined.

type BaseType = PyAny

Base class

type ThreadChecker = SendablePyClass<HyperliquidRawHttpClient>

This handles following two situations:

type PyClassMutability = <<PyAny as PyClassBaseType>::PyClassMutability as PyClassMutability>::MutableChild

Immutable or mutable

type Dict = PyClassDummySlot

Specify this class has #[pyclass(dict)] or not.

type WeakRef = PyClassDummySlot

Specify this class has #[pyclass(weakref)] or not.

type BaseNativeType = PyAny

The closest native ancestor. This is PyAny by default, and when you declare #[pyclass(extends=PyDict)], it’s PyDict.

fn items_iter() -> PyClassItemsIter

fn lazy_type_object() -> &'static LazyTypeObject<Self>

fn dict_offset() -> Option<isize>

fn weaklist_offset() -> Option<isize>

impl PyTypeInfo for HyperliquidRawHttpClient

const NAME: &'static str = "HyperliquidRawHttpClient"

Class name.

const MODULE: Option<&'static str>

Module name, if any.

fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject

Returns the PyTypeObject instance for this type.

fn type_object(py: Python<'_>) -> Bound<'_, PyType>

Returns the safe abstraction over the type object.

fn is_type_of(object: &Bound<'_, PyAny>) -> bool

Checks if object is an instance of this type or a subclass of this type.

fn is_exact_type_of(object: &Bound<'_, PyAny>) -> bool

Checks if object is an instance of this type.

impl DerefToPyAny for HyperliquidRawHttpClient

impl ExtractPyClassWithClone for HyperliquidRawHttpClient