hyperliquid.constants

Documentation for eth_defi.hyperliquid.constants Python module.

Constants for the Hyperliquid integration.

Shared constants used across the Hyperliquid modules (daily_metrics, vault_data_export, etc.).

Module Attributes

`HYPERCORE_CHAIN_ID`	Synthetic in-house chain ID for Hypercore (Hyperliquid's native non-EVM layer).
`HYPERLIQUID_VAULT_PERFORMANCE_FEE`	Fixed performance fee (profit share) for Hyperliquid native vault leaders.
`HYPERLIQUID_USER_VAULT_LOCKUP`	Lockup period for user-created Hyperliquid vaults.
`HYPERLIQUID_PROTOCOL_VAULT_LOCKUP`	Lockup period for Hyperliquid protocol vaults (HLP and sub-vaults).
`HLP_VAULT_ADDRESS_MAINNET`	HLP (Hyperliquidity Provider) parent vault address on mainnet.
`HLP_VAULT_ADDRESS_TESTNET`	HLP (Hyperliquidity Provider) vault address on testnet.
`HLP_STRATEGY_A_ADDRESS`	HLP child vault: Strategy A.
`HLP_STRATEGY_B_ADDRESS`	HLP child vault: Strategy B.
`HLP_STRATEGY_X_ADDRESS`	HLP child vault: Strategy X.
`HLP_LIQUIDATOR_ADDRESS`	HLP child vault: HLP Liquidator.
`HLP_LIQUIDATOR_2_ADDRESS`	HLP child vault: HLP Liquidator 2.
`HLP_LIQUIDATOR_3_ADDRESS`	HLP child vault: HLP Liquidator 3.
`HLP_LIQUIDATOR_4_ADDRESS`	HLP child vault: HLP Liquidator 4.
`LIQUIDATOR_VAULT_ADDRESS`	Standalone Liquidator protocol vault on mainnet.
`HLP_CHILD_VAULT_ADDRESSES`	All HLP child vault addresses on mainnet.
`HYPERLIQUID_SYSTEM_VAULT_ADDRESSES`	Set of all well-known Hyperliquid system vault addresses (mainnet).

HYPERCORE_CHAIN_ID: int = 9999

Synthetic in-house chain ID for Hypercore (Hyperliquid’s native non-EVM layer).

Added to eth_defi.chain.CHAIN_NAMES as 9999: "Hypercore".

HYPERLIQUID_DAILY_METRICS_DATABASE = PosixPath('/home/runner/.tradingstrategy/vaults/hyperliquid-vaults.duckdb'): Default path for Hyperliquid daily metrics DuckDB database.

HYPERLIQUID_VAULT_PERFORMANCE_FEE: float = 0.1

Fixed performance fee (profit share) for Hyperliquid native vault leaders.

All Hyperliquid vaults use a fixed 10% profit share to the vault leader. Protocol vaults (e.g. HLP) do not have any fees or profit share.

Source: https://hyperliquid.gitbook.io/hyperliquid-docs/hypercore/vaults

HYPERLIQUID_VAULT_FEE_MODE: eth_defi.vault.fee.VaultFeeMode = VaultFeeMode.internalised_skimming

Fee mode for Hyperliquid native vaults.

The leader’s 10% profit share is deducted from depositor profits at withdrawal time. The PnL history returned by the vaultDetails API already reflects the depositor’s net returns (after the leader’s cut), so the share price we compute from portfolio history is a net-of-fees price. This matches internalised_skimming — gross and net returns are identical from the pipeline’s perspective.

Source: https://hyperliquid.gitbook.io/hyperliquid-docs/hypercore/vaults Source: https://hyperliquid.gitbook.io/hyperliquid-docs/hypercore/vaults/for-vault-leaders

HYPERLIQUID_USER_VAULT_LOCKUP: datetime.timedelta = datetime.timedelta(days=1)

Lockup period for user-created Hyperliquid vaults.

After depositing into a user vault, followers must wait 1 day before they can withdraw.

Source: https://hyperliquid.gitbook.io/hyperliquid-docs/hypercore/vaults/for-vault-depositors

HYPERLIQUID_PROTOCOL_VAULT_LOCKUP: datetime.timedelta = datetime.timedelta(days=4)

Lockup period for Hyperliquid protocol vaults (HLP and sub-vaults).

After depositing into the HLP or its child vaults, followers must wait 4 days before they can withdraw.

Source: https://hyperliquid.gitbook.io/hyperliquid-docs/hypercore/vaults/for-vault-depositors

HLP_VAULT_ADDRESS_MAINNET: eth_typing.evm.HexAddress = '0xdfc24b077bc1425ad1dea75bcb6f8158e10df303'

HLP (Hyperliquidity Provider) parent vault address on mainnet.

The HLP is the main protocol-operated market-making vault. It has relationship_type="parent" in the Hyperliquid API, with multiple child sub-vaults that handle different strategies. No performance fee (0%), 4-day lockup period. Leader: 0x677d831aef5328190852e24f13c46cac05f984e7

Source: Hyperliquid vaultDetails API, https://app.hyperliquid.xyz/vaults

HLP_VAULT_ADDRESS_TESTNET: eth_typing.evm.HexAddress = '0xa15099a30bbf2e68942d6f4c43d70d04faeab0a0'

HLP (Hyperliquidity Provider) vault address on testnet.

Testnet equivalent of HLP_VAULT_ADDRESS_MAINNET.

Source: Hyperliquid vaultDetails API (testnet)

HLP_STRATEGY_A_ADDRESS: eth_typing.evm.HexAddress = '0x010461c14e146ac35fe42271bdc1134ee31c703a'

HLP child vault: Strategy A.