Learn/Data API

How to Get Hyperliquid Wallet PnL and Trade History

Hyperliquid wallet PnL

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).

Trade history limits in the Hyperliquid API
RequestWhat it returnsLimit
userFillsMost recent fills2,000 fills
userFillsByTimeFills in a time range2,000 per response; only the 10,000 most recent are available
historicalOrdersMost recent orders2,000 orders
userFundingFunding payments in a time range500 per response
portfolioAccount value and PnL historyDay, week, month and all-time views
Source: Hyperliquid info endpoint documentation.

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"

Wallet history endpoints in the Hyperdash Data API
EndpointWhat it returnsCoverage from
/v1/accounts/{address}/fillsEvery fill, by time rangeMarch 22, 2025
/v1/accounts/{address}/tradesCompleted round-trip trades with realized PnLFebruary 26, 2023
/v1/accounts/{address}/completed-tradesThe whole completed-trade history, filtered by market, side, win or loss and sizeMarch 22, 2025
/v1/accounts/{address}/fundingFunding paymentsFebruary 26, 2023
/v1/accounts/{address}/ledgerDeposits, withdrawals, transfers and liquidation settlementsFebruary 26, 2023
How far back a request can reach also depends on the plan's history depth: 90 days on Hobby and Starter, 180 on Growth, 365 on Scale and full history on Enterprise.

How do you get a wallet's PnL summary?

Four endpoints return PnL already computed, so there is nothing to rebuild from fills.

Wallet PnL endpoints in the Hyperdash Data API
EndpointWhat it returns
/v1/accounts/{address}/pnl-summaryLifetime net PnL of completed trades, win rate, trade count, fees, funding, volume and days active
/v1/accounts/{address}/window-statsNet 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-calendarDaily PnL, as on the hyperdash.com PnL calendar
/v1/accounts/{address}/portfolio-dailyDaily account value and PnL between closes
Source: Hyperdash Data API endpoint index.

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.

Trade Smarter