fetch_perp_clearinghouse_state

Documentation for eth_defi.hyperliquid.api.fetch_perp_clearinghouse_state function.

fetch_perp_clearinghouse_state(session, user, timeout=10.0)

Fetch a user’s perpetual account state on HyperCore.

Calls the clearinghouseState info endpoint to retrieve margin summary, withdrawable balance, and open positions.

Parameters

• session (eth_defi.hyperliquid.session.HyperliquidSession) – Session from create_hyperliquid_session().

• user (Union[eth_typing.evm.HexAddress, str]) – On-chain address.

• timeout (float) – HTTP request timeout in seconds.

Returns

Perpetual clearinghouse state with margin info and positions.

Return type

eth_defi.hyperliquid.api.PerpClearinghouseState