How to Get Hyperliquid Wallet PnL and Trade History

November 18, 2026
By Hyperdash
Every Hyperliquid wallet is public, so anyone can look up its PnL and trade history. The fastest way is to open the wallet on hyperdash.com, which shows its PnL, open positions, completed trades and a daily PnL calendar. For code, the public Hyperliquid API returns a wallet's current positions, recent PnL and its 10,000 most recent fills. The full history, every completed trade and many wallets at once come from a data API.
This guide covers each route, the exact requests, and where each one stops.
Published
November 18, 2026
Author
Hyperdash
Reading time
6 min read
Category
Data API
How do you check a Hyperliquid wallet's PnL?
Paste the address into the search on hyperdash.com or open https://hyperdash.com/address/<address>. The wallet page shows:
- Net, realized and unrealized PnL and ROI
- Open positions with size, entry price and unrealized PnL
- Completed trades, each position from open to close with its PnL
- A daily PnL calendar
No account or wallet connection is needed. For the difference between the two kinds of PnL, see Unrealized vs Realized PnL.
How do you get wallet PnL from the Hyperliquid API?
Three requests to Hyperliquid's info endpoint cover a wallet's PnL. None of them needs an API key.
- clearinghouseState: open positions, unrealized PnL per position, margin and account value right now.
- portfolio: account value and PnL history for the last day, week, month and all time, plus perp-only versions of each.
- userFills and userFillsByTime: the wallet's fills, each with its closed PnL and fee.
This request returns a wallet's open positions and unrealized PnL:
curl -X POST https://api.hyperliquid.xyz/info -H "Content-Type: application/json" -d '{"type": "clearinghouseState", "user": "0xADDRESS"}'
And this one returns the PnL history behind the day, week, month and all-time views:
curl -X POST https://api.hyperliquid.xyz/info -H "Content-Type: application/json" -d '{"type": "portfolio", "user": "0xADDRESS"}'
Funding payments and deposits, withdrawals and transfers come from userFunding and userNonFundingLedgerUpdates, documented on the perpetuals info page.
How much trade history does the Hyperliquid API return?
The public API is built for live state, so its trade history is capped. Requests count against a limit of 1,200 weight per minute per IP (rate limits).
| Request | What it returns | Limit |
|---|---|---|
| userFills | Most recent fills | 2,000 fills |
| userFillsByTime | Fills in a time range | 2,000 per response; only the 10,000 most recent are available |
| historicalOrders | Most recent orders | 2,000 orders |
| userFunding | Funding payments in a time range | 500 per response |
| portfolio | Account value and PnL history | Day, week, month and all-time views |
Two gaps follow from this. An active wallet can pass 10,000 fills in a few days, after which its older fills cannot be requested. And the API returns fills, not trades: to know what a position made from open to close, you have to group the fills yourself, net the fees and add the funding. The Hyperliquid API guide covers these limits in more detail.
How do you get a wallet's full trade history?
The Hyperdash Data API serves each wallet's history from Hyperdash's own nodes and history store, by time range, with no cap on how far back a wallet's fills go within the dataset's coverage. Requests use a bearer key and page with a next_cursor.
Every fill in a time range, up to 7 days per request:
curl "https://data.hyperdash.com/v1/accounts/0xADDRESS/fills?start_time=1762300800000&end_time=1762905600000&limit=1000" -H "Authorization: Bearer $HYPERDASH_API_KEY"
Add aggregate=true to merge an order's partial fills in one block, the way hyperdash.com shows them.
Completed round-trip trades, each position from flat back to flat with entry, exit, size, fees and realized PnL, up to 90 days per request:
curl "https://data.hyperdash.com/v1/accounts/0xADDRESS/trades?start_time=1755216000000&end_time=1762905600000&limit=500" -H "Authorization: Bearer $HYPERDASH_API_KEY"
| Endpoint | What it returns | Coverage from |
|---|---|---|
| /v1/accounts/{address}/fills | Every fill, by time range | March 22, 2025 |
| /v1/accounts/{address}/trades | Completed round-trip trades with realized PnL | February 26, 2023 |
| /v1/accounts/{address}/completed-trades | The whole completed-trade history, filtered by market, side, win or loss and size | March 22, 2025 |
| /v1/accounts/{address}/funding | Funding payments | February 26, 2023 |
| /v1/accounts/{address}/ledger | Deposits, withdrawals, transfers and liquidation settlements | February 26, 2023 |
How do you get a wallet's PnL summary?
Four endpoints return PnL already computed, so there is nothing to rebuild from fills.
| Endpoint | What it returns |
|---|---|
| /v1/accounts/{address}/pnl-summary | Lifetime net PnL of completed trades, win rate, trade count, fees, funding, volume and days active |
| /v1/accounts/{address}/window-stats | Net PnL, volume, wins and losses for trades closed in the last 24 hours, 7, 30 or 90 days, year to date or all time |
| /v1/accounts/{address}/pnl-calendar | Daily PnL, as on the hyperdash.com PnL calendar |
| /v1/accounts/{address}/portfolio-daily | Daily account value and PnL between closes |
For example, the 30-day result of one wallet:
curl "https://data.hyperdash.com/v1/accounts/0xADDRESS/window-stats?window=30d" -H "Authorization: Bearer $HYPERDASH_API_KEY"
Completed-trade PnL counts a trade once its position is fully closed. Open positions show up in unrealized PnL instead, which clearinghouseState on the public API or /v1/accounts/{address}/positions on the Data API returns live.
How do you track PnL for many wallets at once?
The public API takes one wallet per request, which reaches the rate limit quickly when you follow a list of traders. The Data API's batch endpoints take many wallets in one request:
curl -X POST "https://data.hyperdash.com/v1/accounts/batch/portfolio" -H "Authorization: Bearer $HYPERDASH_API_KEY" -H "Content-Type: application/json" -d '{"addresses": ["0xADDRESS1", "0xADDRESS2"]}'
A batch can hold 50 wallets on Hobby, 250 on Starter, 1,000 on Growth and 10,000 on Scale. To follow wallets live instead of polling, the account and orders stream channels push each wallet's updates as they happen; see Streams. To compare the wallets you track on risk as well as PnL, see How to Analyze Trader Performance on Hyperliquid.
FAQ
Can I see anyone's PnL on Hyperliquid?
Yes. Every Hyperliquid account is on-chain, so its positions, fills and PnL are public. Open any address on hyperdash.com or request it from the API.
Why does the Hyperliquid API only return 10,000 fills?
The public API keeps recent data for trading and live state. userFillsByTime returns at most 2,000 fills per response, and only a wallet's 10,000 most recent fills can be requested. Older fills need a data API or your own node.
What is the difference between a fill and a trade?
A fill is one match between two orders. A trade, as hyperdash.com and the Data API count it, is a position from open to fully closed, which can span many fills. Trade PnL is the result of the whole position after fees.
Does wallet PnL include funding?
On the Data API, net PnL of completed trades includes funding and is net of fees. The stats endpoint splits gross PnL, fees and funding. On the public API, funding comes from a separate userFunding request.
How do I export a Hyperliquid wallet's trade history?
Page through /v1/accounts/{address}/fills or /v1/accounts/{address}/trades by time range and write the rows to a file. Each response's next_cursor gives the next page.
Is there a free way to get wallet PnL?
The public Hyperliquid API and the wallet pages on hyperdash.com are free. The Hyperdash Data API starts at $20 a month and adds full history, completed trades and batch requests.
Get started
Look up any wallet on hyperdash.com. For full history and PnL in code, get a Hyperdash Data API key and follow the Quickstart. The launch post, Hyperdash Data API Is Live, covers plans and datasets.

