The Trader & Wallet Data endpoints provide comprehensive access to wallet information, user accounts, favorite tracking, and liquidation risk data. These endpoints allow you to retrieve detailed wallet analytics, manage claimed accounts, track favorite positions and accounts, and monitor liquidation risks across different market segments.
Unique to HyperTracker Users
This endpoint is exclusive to HyperTracker, which independently aggregates and delivers this data beyond what’s available in the standard Hyperliquid API.
Get Wallets
/external/api/wallets
Retrieves a paginated list of all wallets with flexible filtering and sorting options. You can filter by individual wallet addresses, segment (cohort), open positions, favorites, vault ownership and claimed status, and view key metrics such as perp equity, bias, open value, exposure, and unrealized PnL. Results also include earliest activity, liquidation proximity, display settings, and verification details.
The endpoint can return up to 500 results per request. Lower limits usually result in faster response times.
Query Parameters
Parameter
Type
Description
offset
number
The number of items to skip before starting to collect the result set
limit
number
The maximum number of items to return
order
array
Order direction (options: asc/desc, default: desc)
orderBy
string
Field to order results by. Options: address, totalEquity, earliestActivityAt, perpPnl, perpEquity, perpBias, openValue, sumUpnl, closestLiqProgress, countOpenPositions, exposureRatio
segmentIds
array
Filter by specific cohort IDs (e.g., Shrimp, Whale, etc.) See Legend.
This endpoint is exclusive to HyperTracker, which independently aggregates and delivers this data beyond what’s available in the standard Hyperliquid API.
Get User Fills
/api/external/fills
Returns trade fills (executions) within a selected time window for the requested filters. Each fill represents a single matched execution and includes the wallet address, traded symbol, execution price and size, side (B buy or A sell), execution timestamp, and position impact (the position before the fill and whether it opened or closed long or short exposure). It also provides execution identifiers (order id and trade id), whether the execution crossed the spread, the transaction hash when available, and all fee attribution including fee amount, fee token, optional builder address, and builder fee.
This endpoint can only be queried one day at a time: end must be within the same calendar day as start. All data fully available from July 2025. TWAPs are listed with the address "0x0000000000000000000000000000000000000000000000000000000000000000".
Query Parameters
Parameter
Type
Description
limit
number
Maximum number of metric rows to return in one response.
coin
string
Filter by one or more coin symbols (for example ETH, BTC).
nextCursor
string
Cursor for pagination. Use the nextCursor value from the previous response to fetch the next page.
address
string
Filter by one or more wallet addresses.
builder
string
Filter by one or more builder addresses.
start
string
Start of the time window (ISO8601).
end
string
End of the time window (ISO 8601, UTC). If omitted, the API uses “now”.
side
string
Filter by fill side. Allowed values: A, B.
Request Examples
Response
200 Success: Returns a list of fills that match the provided filters.
Response Example
Unique to HyperTracker Users
This endpoint is exclusive to HyperTracker, which independently aggregates and delivers this data beyond what’s available in the standard Hyperliquid API.
Returns a 302 redirect to a short-lived download link so you can fetch an export file directly from S3. The export includes wallet equity chart data with the all-time-high breakdown, the same breakdown from 24 hours earlier, and historical values over time across total, perp, spot, staking, and vault equity. The columns field tells you what each value in the data rows represents, so the file can be used easily in charts or reports. The download link expires quickly (about 120 seconds), so it should be used shortly after it is returned.
Also found on the Downloadable Files subpage here.
Request Examples
Response
200 Success: Redirects to a temporary pre-signed S3 URL for the requested export file.
