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_HIGH_FREQ_DEFAULT_INTERVAL`	Default scan interval for high-frequency mode.
`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_HIGH_FREQ_METRICS_DATABASE = PosixPath('/home/runner/.tradingstrategy/vaults/hyperliquid-vaults-hf.duckdb'): Default path for Hyperliquid high-frequency metrics DuckDB database.

HYPERLIQUID_HIGH_FREQ_DEFAULT_INTERVAL: datetime.timedelta = datetime.timedelta(seconds=14400)

Default scan interval for high-frequency mode.

This is the scan trigger cadence (how often the cron job polls the vaultDetails API), not the data resolution. The API serves the day period at a fixed ~20 min resolution and downsamples older points as they age (week ~3h, month ~10.5h, allTime ~weekly). ~20 min is therefore a hard floor — polling faster than this yields no finer data. The 4h default only needs to stay <= 24h so each run snapshots the day window before its points age out and get coarsened; 4h is a 6x safety margin against missed runs. See scripts/hyperliquid/README-hyperliquid-vaults-high-frequency.md.

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

HYPERCORE_BRIDGE_FEE_MARGIN: decimal.Decimal = Decimal('0.01')

Fee margin reserved when bridging the full HyperCore spot balance back to HyperEVM via sendAsset (CoreWriter action ID 13).

Hyperliquid charges a bridge fee on HyperCore spot before the linked token settles on HyperEVM. The fee equals 200k gas at the base gas price of the next HyperEVM block. HYPE is consumed first if available; otherwise the fee is taken in USDC.

Source: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/hyperevm/hypercore-less-than-greater-than-hyperevm-transfers

In manual mainnet verification (2026-03-23), bridging 9 USDC in tx 0x82c7ca18fed4952dfdfdffb4e7565cc768c2ab14fe7533bb42a0734cfdf36b16 returned 9 USDC to HyperEVM while reducing spot by ~9.000783 USDC (fee ~0.000783 USDC at 0.1 Gwei base gas price).

When withdrawing the entire spot balance, this margin must be subtracted from the withdrawal amount so enough USDC remains on spot to cover the fee. Without it the withdrawal silently fails (no error, no event — USDC stays in spot). The value (0.01 USDC) provides ~12× headroom over the observed fee.

See compute_spot_to_evm_withdrawal_amount().

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.