Docs
⌘ K

User Lookup

GET/v1/hyperliquid/users

Returns trading aggregates per user: fill count, volume broken down by side, total fees (negative values represent net maker rebates), realized PnL, net funding paid or received, liquidation-fill count, distinct coins traded, and first/last trade timestamps.

Omit user for leaderboard mode — returns a paginated list sorted by sort_by. Provide user for profile mode — returns a single row. Filters coin and dex compose additively — pass either or both to narrow the scope (coin=BTC for one market, dex=xyz for one venue, both together for redundancy). A mismatched combination (e.g. coin=cash:TSLA&dex=xyz) returns an empty result.

Aggregation windows are fixed via the interval parameter — 1h, 1d, 1w, 30d, or omit for all-time. Data is refreshed hourly, so 1h lags up to 1h.

Vaults trade as normal accounts, so passing a vault address as user returns its trading performance — pair with /v1/hyperliquid/vaults for depositor-side stats.

Query Parameters

ParameterDescriptionValue
user
string

Filter by address

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

Lookback window for user statistics (1 hour, 1 day, 1 week, 30 days). Omit for all-time.

  • Accepted values: 1h, 1d, 1w, 30d
sort_by
string
  • Default value: total_volume
  • Accepted values: total_volume, transactions, total_fees, realized_pnl, total_funding, liquidation_fills
total_volume
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.

      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