fetch_vault_fills_iterator

Documentation for eth_defi.hyperliquid.position.fetch_vault_fills_iterator function.

fetch_vault_fills_iterator(session, vault_address, start_time=None, end_time=None, server_url='https://api.hyperliquid.xyz', timeout=30.0, aggregate_by_time=False)

Iterate over fills for a vault with automatic pagination.

Memory-efficient version of fetch_vault_fills() that yields fills one at a time instead of loading all into memory.

Note that fills are yielded in API order (newest first per batch), not chronological order. Use fetch_vault_fills() if you need chronological ordering.

Parameters
  • session (requests.sessions.Session) – HTTP session with retry logic

  • vault_address (eth_typing.evm.HexAddress) – Vault address to fetch fills for

  • start_time (datetime.datetime | None) – Start of time range (inclusive)

  • end_time (datetime.datetime | None) – End of time range (inclusive)

  • server_url (str) – Hyperliquid API URL

  • timeout (float) – HTTP request timeout in seconds

  • aggregate_by_time (bool) – When True, partial fills are combined

Returns

Iterator yielding Fill objects

Return type

Iterator[eth_defi.hyperliquid.position.Fill]