apex.constants
Documentation for eth_defi.apex.constants Python module.
Constants for the ApeX Omni vault reader.
Module Attributes
Synthetic chain identifier for ApeX native vaults. |
|
ApeX Omni public REST API base URL. |
|
Public destination URL template for one ApeX Omni vault. |
|
Default ranking observation cadence. |
|
Default historical refresh cadence. |
|
Default process-wide public API request rate. |
|
Default number of history reader workers. |
|
Default TCP connection timeout. |
|
Default socket inactivity timeout. |
|
Monotonic request-attempt budget used to clamp blocking phases. |
|
Monotonic budget shared by the complete two-pass ranking read. |
|
Monotonic budget shared by one vault's history operation. |
|
Maximum retry sleep. |
|
Maximum JSON response size. |
|
Number of HTTP retries after the initial request. |
|
Number of complete ranking stabilisation retries. |
|
Ranking page size verified against the public endpoint. |
|
Explicitly verified terminal status. |
|
Public endpoint returning ApeX Omni official (protocol-operated) vaults. |
|
Batched net-asset-value history endpoint used for the official vaults. |
|
Curated metadata for the ApeX Omni official vaults. |
Classes
Curated metadata for one ApeX Omni official, protocol-operated vault. |
- APEX_VAULT_URL_TEMPLATE: str = 'https://omni.apex.exchange/vaultInfo/{vault_id}/1'
Public destination URL template for one ApeX Omni vault. See https://www.apex.exchange/blog/detail/weekly-update-11may2026.
- APEX_METRICS_DATABASE: pathlib.Path = PosixPath('/home/runner/.tradingstrategy/vaults/apex-vaults.duckdb')
Default local metrics database.
- APEX_DEFAULT_SCAN_INTERVAL: datetime.timedelta = datetime.timedelta(seconds=14400)
Default ranking observation cadence.
- APEX_DEFAULT_HISTORY_INTERVAL: datetime.timedelta = datetime.timedelta(days=1)
Default historical refresh cadence.
- APEX_DEFAULT_REQUEST_DEADLINE: float = 60.0
Monotonic request-attempt budget used to clamp blocking phases.
- APEX_DEFAULT_RANKING_DEADLINE: float = 300.0
Monotonic budget shared by the complete two-pass ranking read.
- APEX_DEFAULT_HISTORY_DEADLINE: float = 120.0
Monotonic budget shared by one vault’s history operation.
- APEX_OFFICIAL_VAULTS_PATH: str = 'vault/official-vaults'
Public endpoint returning ApeX Omni official (protocol-operated) vaults.
Unlike the user copy-trading vaults served by
/vault/ranking, the official vaults are listed by/vault/official-vaultsand carry small integervaultIdvalues with distinct StarkEx L2 addresses.
- APEX_FUND_NET_VALUE_BATCH_PATH: str = 'vault/fund-net-value-batch'
Batched net-asset-value history endpoint used for the official vaults.
Called as
/vault/fund-net-value-batch?vaultIds=10000,10001and returns a dailynetValueandtotalValueseries per official vault.
- class ApexOfficialVault
Bases:
objectCurated metadata for one ApeX Omni official, protocol-operated vault.
ApeX Omni runs a small number of official vaults built and operated by the ApeX team itself, as opposed to the user-created copy-trading vaults. These are the ApeX equivalent of a protocol market-making / liquidity-provider vault such as Hyperliquid’s HLP or Lighter’s LLP, and they hold the vast majority of real ApeX vault TVL.
The ApeX ranking API only exposes placeholder
desctext for these vaults, so the short and long descriptions here are curated from ApeX’s official documentation and announcements. See the Protocol Vaults announcement.- reported_ethereum_address: eth_typing.evm.HexAddress
Distinct StarkEx L2 vault address reported by ApeX.
- APEX_OFFICIAL_VAULTS: tuple[eth_defi.apex.constants.ApexOfficialVault, ...] = (ApexOfficialVault(vault_id='10000', name='Protocol Vault', reported_ethereum_address='0x83F0e6dC9C352F9156a3a06B512B58012629D05C', short_description="ApeX Omni's flagship protocol-operated vault, earning steady USDT yield from perpetual liquidation fees with no lock-up.", long_description="The Protocol Vault is ApeX Omni's flagship official vault, built and operated by the ApeX team itself rather than a third-party strategy manager. It is the ApeX equivalent of a protocol market-making or liquidity-provider vault such as Hyperliquid's HLP or Lighter's LLP, and it holds the large majority of all ApeX vault TVL.\n\nDepositors pool USDT and earn a proportional share of the perpetual-futures liquidation fees collected across the ApeX Omni exchange. ApeX totals these fees daily and distributes them to vault holders through a net asset value (NAV) update at 08:00 UTC, so returns come from real exchange activity rather than directional trading. The product is positioned as low-risk, steady growth with no exposure to high-risk strategies, and is designed to avoid negative yield.\n\nKey parameters published by ApeX:\n\n- Denominated in USDT\n- Minimum deposit of 10 USDT\n- Total vault cap raised over time to around 20,000,000 USDT, with a per-user cap raised from 200,000 USDT up to around 1,000,000 USDT\n- Daily NAV update at 08:00 UTC; shares are issued at the next NAV after a deposit\n- No lock-up: principal and accrued yield are redeemable back to the depositing account\n\nRealised yield varies with exchange liquidation activity. ApeX has run promotional campaigns advertising rates in the region of 22-32% APY, but the vault does not guarantee any fixed rate."), ApexOfficialVault(vault_id='10001', name='New Vault', reported_ethereum_address='0xf33561bA75bE787bA53914C2bfE9A7A7DD320B8a', short_description="ApeX Omni's new-user protocol vault: a simplified, lower-capacity entry point earning the same liquidation-fee yield.", long_description="The New Vault (New User Vault) is a second official ApeX Omni vault, also built and operated by the ApeX team, aimed at newcomers to the platform. It offers a simplified, direct entry point so users can start earning from their first day without navigating the full ApeX product suite.\n\nLike the flagship Protocol Vault, it pays USDT yield from ApeX Omni perpetual liquidation fees, distributed to holders through daily NAV updates, and carries no lock-up: principal and yield are redeemable back to the depositing account.\n\nIt differs from the flagship Protocol Vault mainly in scope. It is an onboarding product with a smaller total capacity of around 300,000 USDT targeted at new and smaller depositors, rather than the exchange's primary, higher-capacity protocol vault. As with all ApeX Protocol Vaults, realised yield depends on exchange liquidation activity and no fixed rate is guaranteed."))
Curated metadata for the ApeX Omni official vaults.
Addresses, IDs and total caps were captured live from
/vault/official-vaultson 2026-07-25. Descriptions are sourced from the ApeX Protocol Vaults announcement and the New User Vault weekly update.