fetch_account_trade_history
Documentation for eth_defi.hyperliquid.trade_history.fetch_account_trade_history function.
- fetch_account_trade_history(session, address, start_time=None, end_time=None, timeout=30.0)
Fetch and reconstruct complete trade history for a Hyperliquid account.
Orchestrates fetching fills, funding payments, and current positions, then reconstructs round-trip trades with full PnL accounting.
Example:
from eth_defi.hyperliquid.session import create_hyperliquid_session from eth_defi.hyperliquid.trade_history import fetch_account_trade_history session = create_hyperliquid_session() address = "0x1e37a337ed460039d1b15bd3bc489de789768d5e" history = fetch_account_trade_history(session, address) for trade in history.closed_trades: print(f"{trade.coin} {trade.direction.value}: entry={trade.entry_price} exit={trade.exit_price} PnL={trade.net_pnl}")- Parameters
session (eth_defi.hyperliquid.session.HyperliquidSession) – Session from
create_hyperliquid_session().address (eth_typing.evm.HexAddress) – Account address (vault or user).
start_time (datetime.datetime | None) – Start of time range. Defaults to 30 days ago.
end_time (datetime.datetime | None) – End of time range. Defaults to now.
timeout (float) – HTTP request timeout in seconds.
- Returns
Complete trade history snapshot.
- Return type