Hyperliquid perpetual exchange data endpoints, plus API documentation and monitoring.

Resources & endpoints

Hyperliquid Users

User Lookup

PREVIEW

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 (a paginated list sorted by sort_by). Provide user for profile mode (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 empty.

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.

GET

https://api.pinax.network/v1/hyperliquid/users

Requires bearer token — sign in to inject your team’s key.

Optional parameters

Name	Type	Description
user query	string · evm-address	Filter by address Single value or array of values* (separate multiple values with `,`) *Plan restricted. e.g. 0xd8da6bf26964af9d7eed9e03e53415d37aa96045
interval query	Enum · 4	Lookback window for user statistics (1 hour, 1 day, 1 week, 30 days). Omit for all-time. 1h1d1w30d
sort_by query	Enum · 6	total_volumetransactionstotal_feesrealized_pnltotal_fundingliquidation_fills
coin query	string	Hyperliquid coin id. Perps: `BTC`. Spot: `@N` (`@107`). Builder DEXs: `xyz:SILVER`. Outcome coins (`#N`) are rejected — use `/v1/hyperliquid/outcomes/`. Single value or array of values (separate multiple values with `,`) *Plan restricted. e.g. BTC
dex query	Enum · 9	DEX identifier. `perps` for core perps, `spot` for `@N` spot pairs, or a builder DEX name (`xyz`, `cash`, …). Outcome markets are served separately under `/v1/hyperliquid/outcomes/`. Single value or array of values (separate multiple values with `,`) *Plan restricted. perpsspotxyzcashkmhynaflxvntlpara
limit query	integer	Number of items* returned in a single request. *Plan restricted.
page query	integer	Page number to fetch. Empty `data` array signifies end of results.

Response

200 OK

{
  "data": [
    {
      "user": "0x3029df6146509f4bd9bc39d85dd01fc9e9639a2f",
      "coin": null,
      "dex": null,
      "interval": null,
      "transactions": 969,
      "buys": 488,
      "sells": 481,
      "volume_bought": 102292.57,
      "volume_sold": 107984.47,
      "total_volume": 210277.03,
      "total_fees": 11.88,
      "realized_pnl": 153.34,
      "total_funding": 0.14,
      "liquidation_fills": 0,
      "coins_traded": 6,
      "first_trade": "2026-02-22 02:01:26",
      "last_trade": "2026-04-30 05:39:27"
    }
  ]
}