userPnlSummary | Hyperliquid Info API
Info API
userPnlSummary | Hyperliquid Info API
Hyperliquid userPnlSummary: fetch one aggregate PnL summary for a wallet - realized PnL, win/loss rate, volume, fees, funding, active days, and traded pairs.
POST
userPnlSummary | Hyperliquid Info API
Credit Cost
10 per call
Processing
Realtime
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.
- GoldRush custom analytics product. Not available on the public Hyperliquid node - there is no
POST api.hyperliquid.xyz/infoequivalent. Served only fromPOST 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/endTimeare optional. When supplied they window the realized metrics;accountAgeDaysandtradedPairsare always lifetime.dexscopes the trade aggregates andtradedPairs;volumeTraded,daysActive, andaccountAgeDaysare computed across all DEXes.- For the underlying per-trade rows behind these totals, use
userCompletedTradesoruserCompletedTradesByTime.
/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).Related endpoints
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.