Docs
⌘ K

Market Activity

GET/v1/hyperliquid/markets/activity

Returns a chronological fill feed, filterable by coin, dex, and/or user. Each row is a single fill carrying price, size, side (BID or ASK), directional intent (OPEN_LONG, CLOSE_SHORT, LIQUIDATED_CROSS_LONG, AUTO_DELEVERAGING, and others), closed PnL, fees (negative values represent maker rebates), and order-level metadata (order_id, client_order_id, twap_id, crossed).

For balance-changing events on a user (deposits, withdrawals, funding payments, vault flows), use /v1/hyperliquid/users/activity.

At least one of coin, dex, or user is required. Filters compose additively — pass any combination to narrow further; a mismatched pair (e.g. coin=cash:TSLA&dex=xyz) returns empty.

Defaults to the last 24 hours when no time range is specified — provide start_time and end_time to query older data.

Query Parameters

ParameterDescriptionValue
coin
string

Hyperliquid coin identifier. Core perps have no prefix (BTC, HYPE); spot pairs use @N (@107); builder DEXs prefix the symbol with the DEX name (xyz:SILVER).

    dex
    string

    DEX identifier. perps for core perps, spot for @N spot pairs, or a builder DEX name (e.g. xyz, cash). New builder DEXs are added on Hyperliquid permissionlessly — call /v1/hyperliquid/dexes for the live set.

      user
      string

      Filter by address

      • Accepted pattern: ^(0[xX])?[0-9a-fA-F]{40}$
      • Format: evm-address
      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