aggregate_daily_flows

Documentation for eth_defi.hyperliquid.deposit.aggregate_daily_flows function.

aggregate_daily_flows(events)

Aggregate vault events into daily deposit/withdrawal flow metrics.

Groups events by calendar date and computes:

  • Number of deposit events

  • Number of withdrawal events

  • Total USD deposited (positive)

  • Total USD withdrawn (positive, absolute value)

Only vault_deposit and vault_withdraw events are counted. Other event types (vault_create, vault_distribution, vault_leader_commission) are excluded.

Parameters

events (list[eth_defi.hyperliquid.deposit.VaultDepositEvent]) – List of vault events from fetch_vault_deposits().

Returns

Dict mapping date to (deposit_count, withdrawal_count, deposit_usd, withdrawal_usd).

Return type

dict[datetime.date, tuple[int, int, float, float]]