Docs
⌘ K

User Activity

GET/v1/hyperliquid/users/activity

Returns a chronological feed of balance-changing events for a user — bridge deposits/withdrawals, on-chain account deposits/withdrawals, vault deposits/withdrawals, liquidations, and funding payments. Each row carries an event_type discriminator and a notes field with type-specific extras (e.g. funding rate and position size for funding events).

For trade fills, use /v1/hyperliquid/markets/activity instead.

Supply event_types (comma-separated) to filter to a subset. Defaults to the last 30 days when no time range is specified — provide start_time and end_time to query older data.

Query Parameters

ParameterDescriptionValue
user
string

Filter by address

  • Accepted pattern: ^(0[xX])?[0-9a-fA-F]{40}$
  • Format: evm-address
Required
event_types
string

Filter by balance-event type.
Single value or array of values* (separate multiple values with ,)
*Plan restricted.

  • Accepted values: bridge_deposit, bridge_withdraw_pending, bridge_withdraw_finalized, deposit, withdraw, vault_deposit, vault_withdraw, liquidation, funding
start_time
string

UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

    end_time
    string

    UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

      limit
      integer

      Number of items* returned in a single request.
      *Plan restricted.

      • Default value: 10
      • Minimum value: 1
      • Maximum value: 1000
      page
      integer

      Page number to fetch.
      Empty data array signifies end of results.

      • Default value: 1
      • Minimum value: 1
      • Maximum value: 767465558638

      Potential Responses

      StatusDescription
      200

      Successful Response

      400

      Client side error

      401

      Authentication failed

      403

      Forbidden

      404

      Not found

      500

      Server side error