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