In testing. The trading engine is not live; the console shows sample data and places no orders. Product features described here are planned.
Read an address beyond its headline result
Keep the address, observation time and date range together. A single large closing trade says little about the exposure still open.
On this page
Start with the account address
- Copy the full public address of the main account or sub-account you want to inspect. An API-wallet address is a signing identity and can show empty account data.
- Open the official Explorer from More, paste the address into search and press Enter. Check the full address on the result page, then inspect each action and its timestamp.
- For your own connected account, Portfolio separates Positions, Trade History and Funding History. Explorer actions are useful evidence, but an order action alone does not prove a fill.
Query fills for any public address
For a direct read-only lookup, replace YOUR_ADDRESS below with the full address and run the command in a terminal. It queries public information, requires no wallet connection and sends no order.
curl --request POST https://api.hyperliquid.xyz/info --header 'Content-Type: application/json' --data '{"type": "userFills", "user": "YOUR_ADDRESS"}'
This query supplies at most the latest 2,000 fills. An empty response does not establish that an address has never traded. For time windows, see userFillsByTime in the linked documentation; its available history is also limited.
Separate exposure from completed trades
To include HIP-3, query {"type": "perpDexs"}, take each non-null entry’s name and add it as dex to each clearinghouseState request. Check every relevant DEX; an empty first-DEX result does not mean there are no positions elsewhere. Account balances also depend on account mode.
- Open exposure
- For standard perpetual accounts, use clearinghouseState and inspect assetPositions: szi is signed size; leverage contains the margin mode and setting. Without dex, this covers only the first perpetual DEX.
- Fills
- In the fills response, compare time, coin, dir, sz and px. Keep the trade ID with each row so duplicated exports do not become extra trades.
- Costs
- Read fee and feeToken alongside the fill. The fee field includes builderFee when present; adding builderFee again would count it twice. Funding is a separate ledger.
Check funding and the chart’s coverage
Hyperliquid settles perpetual funding hourly between the long and short sides. Check the actual funding payments over the same period as the fills, rather than extrapolating one current rate.
For any public address, replace the command’s --data body with the JSON below. The sample range is 1 September 2026 00:00 UTC through 2 September 00:00 UTC; replace both millisecond timestamps for your period. Read time, delta.coin and signed delta.usdc. Positive is a receipt, negative is a payment; record the collateral asset before combining DEX totals. Follow the documented pagination for a larger range.
{"type": "userFunding", "user": "YOUR_ADDRESS", "startTime": 1788220800000, "endTime": 1788307200000}
Portfolio graphs are sampled, including at 15-minute intervals. A short-lived drawdown can sit between samples. A chart is useful for orientation; detailed accounting needs the underlying records.
Three ways a comparison can mislead
- Largest trade
- Remove the largest positive closing trade from a copy of your worksheet. Does the rest of the period tell the same story? Keep open losses and costs visible.
- Sample bias
- A list built from visible successful addresses omits failed or abandoned ones. Treat that missing sample as a limitation, even when every displayed figure is correct.
- Leverage and deposits
- Compare position value with the capital supporting it. For example, $10,000 of exposure against $1,000 is 10×; against $5,000 it is 2×. Balance changes alone mix trading and transfers.
Keep a small inspection record
- Save the address, account mode, UTC time range and where the data came from.
- Note the largest open exposure, the deepest observed loss and any gaps in the history.
- Separate fills, funding and deposits or withdrawals. Check each field’s accounting definition before combining it.
- Use this to describe what happened. It cannot establish what the address will do next, and it is not investment advice.
Protocol referenceHyperliquid: account queries and fillsHyperliquid: perpetual account fieldsHyperliquid: fundingHyperliquid: portfolio graph samplingHyperliquid: account modes