Skip to main content
POST
userPnlSummary | Hyperliquid Info API

Credit Cost

10 per call

Processing

Realtime
The Hyperliquid info endpoint with type: "userPnlSummary" is used to fetch one aggregate PnL summary for a wallet - realized PnL, win/loss rate, volume, fees, funding, active days, and traded pairs.
Estimate your monthly cost for this API using the Pricing Calculator.
  • GoldRush custom analytics product. Not available on the public Hyperliquid node - there is no POST api.hyperliquid.xyz/info equivalent. Served only from POST hypercore.goldrushdata.com/info.
  • Returns a single aggregate object for one wallet (not an array), rolled up from the wallet’s fully-closed round-trip trades and trading activity.
  • startTime / endTime are optional. When supplied they window the realized metrics; accountAgeDays and tradedPairs are always lifetime.
  • dex scopes the trade aggregates and tradedPairs; volumeTraded, daysActive, and accountAgeDays are computed across all DEXes.
  • For the underlying per-trade rows behind these totals, use userCompletedTrades or userCompletedTradesByTime.
Returns a single aggregate object summarizing a wallet’s realized trading performance - net PnL, win and loss rates, trade count, notional volume, fees, funding, active-day count, account age, and the list of coins it has traded. Use this for leaderboard tiles, wallet profile headers, or a one-call PnL read instead of paging through completed trades. User-keyed. GoldRush-native, so there is no upstream Hyperliquid /info equivalent.

Endpoint

Request

string
required
Always "userPnlSummary".
string
required
The wallet address (lowercase 0x-prefixed hex).
int
Optional. Unix timestamp in milliseconds. Inclusive lower bound on close_time for the realized metrics. Omit for a lifetime summary.
int
Optional. Unix timestamp in milliseconds. Inclusive upper bound on close_time for the realized metrics. Defaults to current server time when a window is otherwise in play.
string
Optional perp-DEX scope for the trade aggregates and tradedPairs. main_dex for the canonical Hyperliquid perp DEX, or a HIP-3 DEX identifier. Omit to aggregate across every DEX.

Example

Response

A single aggregate object for the wallet.

Field descriptions

totalPnl, totalFees, and totalFunding are decimal strings (full precision); volumeTraded is a fixed 2-decimal string. winRate and lossRate are JSON floats (4 decimals). totalTrades, daysActive, and accountAgeDays are JSON numbers. Do not parse the decimal strings as floats - keep them as strings or use a fixed-precision decimal type.
string
The wallet address the summary belongs to (lowercase 0x-prefixed hex), echoing the request.
string
Net realized PnL in USDC across the completed trades in scope - trading PnL minus fees plus funding (the sum of per-trade net_pnl).
number
Fraction of completed trades with positive net PnL (net_pnl > 0), rounded to 4 decimals. 0.0 when the wallet has no completed trades.
number
Fraction of completed trades with non-positive net PnL (net_pnl <= 0), rounded to 4 decimals. Equal to 1 - winRate; break-even trades count as losses.
int
Number of fully-closed round-trip trades in scope.
string
Total notional traded in USDC as a fixed 2-decimal string (e.g. "1095452.80"). Computed across all DEXes.
string
Total trading fees paid in USDC across the completed trades in scope.
string
Total funding in USDC across the completed trades in scope (negative = net paid, positive = net received).
int
Number of distinct UTC calendar days on which the wallet traded, within the window. Computed across all DEXes.
int | null
Whole days since the wallet’s first-ever fill, counted inclusively (first day = 1). Lifetime and all-DEX - never windowed. null when the wallet has no recorded fills. A wallet whose first fill predates GoldRush’s HyperCore coverage reads younger than its true age.
string[]
Coin symbols the wallet has traded, in chronological order of first fill. Scoped to dex when supplied, otherwise all DEXes. Lifetime (not windowed).

userCompletedTrades

fetch a wallet’s most recent fully-closed round-trip trades, newest-first, with realized PnL, funding, and fees.

userCompletedTradesByTime

fetch a wallet’s fully-closed round-trip trades within a time window, oldest-first with a keyset cursor for forward paging.

userFills

fetch a user’s most recent trade fills without specifying a time window.

userFunding

fetch a user’s per-coin funding payment history within a time window for funding-only P&L attribution.
See all Hyperliquid endpoints: Overview hub · Info API reference Last reviewed: 2026-08-17