
Hyperliquid trade aggregates
GET/gateway/v1/hyperliquid/trades/aggregate
$0.02616per call
Every call costs the same.
You aren't charged for failed calls. A wallet payment for a failed call is refunded.
About this endpoint
Closed Trades Aggregate: Returns a wallet's closed trades rolled up server-side into one row per group — so the P&L calendar, per-symbol / direction / size attribution, and the realized equity curve are one call each instead of paging the whole trade history.
`group_by`: day (UTC calendar day — the calendar and equity-curve source), symbol (per market), direction (long vs short), size_bucket (notional-USD tiers: <1k, 1k-10k, 10k-100k, 100k-1m, 1m+), or hold_bucket (holding-time tiers: <5m, 5m-1h, 1h-1d, 1d-1w, 1w+). Tiers with no trades are omitted — render the full ladder client-side and zero-fill. One dimension per call.
Per group: trade_count, gross_pnl, net_pnl (funding-excluded — gross − fees, matching /trades and /performance), fees, funding_pnl (live tail only), win_rate, volume_usd (notional), avg_win, avg_loss.
from/to (Unix seconds or a date) bound close_time; omit for full history. Totals reconcile to /trades and `/performan
Query parameters
Response types
More from Surf API
- KOL rankingGET/gateway/v1/smart-money/kol/ranking$0.01308 per callFixed
- Liquidation chartGET/gateway/v1/market/liquidation/chart$0.01308 per callFixed
- Blockchain SQL queryPOST/gateway/v1/onchain/sql$0.02616 per callFixed
- KOL call historyGET/gateway/v1/smart-money/kol/history$0.01308 per callFixed
- Order book depthGET/gateway/v1/exchange/depth$0.00654 per callFixed
- Latest company financialsGET/gateway/v1/equity/latest-financialsUp to $0.03924 per callResponse-based
- Web page fetchGET/gateway/v1/web/fetch$0.00654 per callFixed
- Matched market pairsGET/gateway/v1/prediction-market/matching/pairs$0.02616 per callFixed
- Polymarket wallet positionsGET/gateway/v1/prediction-market/polymarket/positions$0.02616 per callFixed
- Hyperliquid trader leaderboardGET/gateway/v1/hyperliquid/leaderboard$0.02616 per callFixed
- Perpetual contract snapshotGET/gateway/v1/exchange/perp$0.00654 per callFixed
- KOL activityGET/gateway/v1/smart-money/kol/activity$0.01308 per callFixed