Struct HyperLiquidBuilder 

pub struct HyperLiquidBuilder { /* private fields */ }

Builder for creating HyperLiquid exchange instances.

Note on Market Types

HyperLiquid only supports perpetual futures (Swap). Attempting to set default_type to any other value (Spot, Futures, Margin, Option) will result in a validation error when calling build().

Example

use ccxt_exchanges::hyperliquid::HyperLiquidBuilder;

let exchange = HyperLiquidBuilder::new()
    .private_key("0x...")
    .testnet(true)
    .default_leverage(10)
    .build()
    .unwrap();

Implementations

impl HyperLiquidBuilder

pub fn new() -> Self

Creates a new HyperLiquidBuilder with default settings.

pub fn private_key(self, key: &str) -> Self

Sets the Ethereum private key for authentication.

The private key should be a 64-character hex string (32 bytes), optionally prefixed with “0x”.

Arguments

• key - The private key in hex format.

Example

use ccxt_exchanges::hyperliquid::HyperLiquidBuilder;

let builder = HyperLiquidBuilder::new()
    .private_key("0x1234567890abcdef...");

pub fn sandbox(self, enabled: bool) -> Self

Enables or disables sandbox/testnet mode.

When enabled, the exchange will connect to HyperLiquid testnet instead of mainnet.

This method is equivalent to testnet() and is provided for consistency with other exchanges.

Arguments

• enabled - Whether to use sandbox mode.

pub fn testnet(self, enabled: bool) -> Self

Enables or disables testnet mode.

When enabled, the exchange will connect to HyperLiquid testnet instead of mainnet.

This method is equivalent to sandbox() and is provided for backward compatibility.

Arguments

• enabled - Whether to use testnet.

pub fn vault_address(self, address: &str) -> Self

Sets the vault address for vault trading.

When set, orders will be placed on behalf of the vault.

Arguments

• address - The vault’s Ethereum address.

pub fn default_leverage(self, leverage: u32) -> Self

Sets the default leverage multiplier.

This leverage will be used when placing orders if not specified.

Arguments

• leverage - The leverage multiplier (1-50).

pub fn default_type(self, default_type: impl Into<DefaultType>) -> Self

Sets the default market type for trading.

Important: HyperLiquid only supports perpetual futures (Swap). Attempting to set any other value (Spot, Futures, Margin, Option) will result in a validation error when calling build().

Arguments

• default_type - The default market type. Must be Swap for HyperLiquid.

Example

use ccxt_exchanges::hyperliquid::HyperLiquidBuilder;
use ccxt_core::types::default_type::DefaultType;

// This works - HyperLiquid supports Swap (perpetuals)
let exchange = HyperLiquidBuilder::new()
    .default_type(DefaultType::Swap)
    .build()
    .unwrap();

// This will fail - HyperLiquid does not support Spot
let result = HyperLiquidBuilder::new()
    .default_type(DefaultType::Spot)
    .build();
assert!(result.is_err());

pub fn timeout(self, timeout: Duration) -> Self

Sets the request timeout.

pub fn timeout_secs(self, seconds: u64) -> Self

Sets the request timeout in seconds (convenience method).

pub fn connect_timeout(self, timeout: Duration) -> Self

Sets the TCP connection timeout.

Arguments

• timeout - Connection timeout duration.

pub fn connect_timeout_secs(self, seconds: u64) -> Self

Sets the TCP connection timeout in seconds (convenience method).

Arguments

• seconds - Connection timeout duration in seconds.

pub fn retry_policy(self, policy: RetryPolicy) -> Self

Sets the retry policy.

pub fn proxy(self, proxy: ProxyConfig) -> Self

Sets the HTTP proxy configuration.

pub fn proxy_url(self, url: impl Into<String>) -> Self

Sets the HTTP proxy URL (convenience method).

pub fn build(self) -> Result<HyperLiquid>

Builds the HyperLiquid exchange instance.

Returns

Returns a configured HyperLiquid instance.

Errors

Returns an error if:

• The private key format is invalid
• The exchange configuration fails
• The default_type is set to a value other than Swap (HyperLiquid only supports perpetuals)

Trait Implementations

impl Debug for HyperLiquidBuilder

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

Formats the value using the given formatter.

impl Default for HyperLiquidBuilder

fn default() -> HyperLiquidBuilder

Returns the “default value” for a type.