Wallets
Trader discovery, wallet detail, profile analytics, and live wallet activity endpoints.
Use the wallet model
Wallet endpoints are scoped by network and currently use hyperliquid. The directory and detail endpoints are served from DexHunt current state and wallet-profile analytics. The activity endpoints read live wallet activity from Hyperliquid through the DexHunt backend.
Coverage
Directory and detail responses describe wallets discovered and scanned by DexHunt.
coverage = scanned_wallets
Analytics
PnL, ROI, volume, win rate, Sharpe, drawdown, and strategy fields are nullable when profile enrichment is unavailable.
profile-derived
Open orders and fills
Activity endpoints cap limit at 500 and can return 503 when live upstream reads are unavailable.
live passthrough
Address format
Wallet addresses are normalized to lowercase and must be 0x plus 40 hex characters.
0x...
List wallets
Use the wallet directory for trader discovery and filtering. The default limit is 25 and the hard cap is 200. Send nextCursor back as cursor to continue.
Capital filter
Filter by derived capital class. Values are shrimp, shark, and whale on the external directory surface.
size
Direction filter
Filter by long, short, or neutral directional exposure. Direction is derived from longValue and shortValue.
direction
Profile filters
Filter by profitSize, profitStatus, pace, style, strategy, minWinRate, and maxDrawdown when profile analytics exist.
analytics filters
Sorting
Sort by accountTotalValue for current account state or by netPnl, totalPnl, roi, volume, winRate, sharpe, maxDrawdown for profile analytics.
sort + order
curl -sS "https://api.dexhunt.app/api/developer/v1/networks/hyperliquid/wallets?size=whale&direction=long&sort=roi&order=desc&limit=2" \
-H "X-API-Key: hlsk_your_developer_key"{
"items": [
{
"address": "0x1111111111111111111111111111111111111111",
"label": null,
"tags": ["whale", "high_quality"],
"kols": [],
"kolProfile": null,
"sizeClass": "whale",
"direction": "long",
"accountTotalValue": "12500000.42",
"totalPositionValue": "4200000.00",
"longValue": "4200000.00",
"shortValue": "0",
"leverage": "0.34",
"positions": 3,
"observedAt": "2026-06-12T12:00:00Z",
"netPnl": "820000.12",
"totalPnl": "820000.12",
"roi": "7.12",
"volume": "98100000.50",
"closedPositions": 240,
"winRate": "63.50",
"spotValue": "250000.00",
"perpValue": "12250000.42",
"sharpe": "1.48",
"maxDrawdown": "8.20",
"profitSize": "large",
"profitStatus": "sustained",
"pace": "swinger",
"style": "lowDd",
"strategy": "lowDd",
"strategyConfidence": "0.82"
}
],
"nextCursor": "2",
"total": 14,
"coverage": "scanned_wallets"
}Open wallet detail
Wallet detail returns the directory fields plus free margin, account-level unrealized PnL, ROE, trade count, average margin used ratio, and open positions. Position detail fields are nullable when the latest profile does not contain matching per-position data.
curl -sS "https://api.dexhunt.app/api/developer/v1/networks/hyperliquid/wallets/0x1111111111111111111111111111111111111111" \
-H "X-API-Key: hlsk_your_developer_key"{
"address": "0x1111111111111111111111111111111111111111",
"tags": ["whale", "high_quality"],
"sizeClass": "whale",
"direction": "long",
"accountTotalValue": "12500000.42",
"freeMarginAvailable": "8300000.00",
"totalPositionValue": "4200000.00",
"longValue": "4200000.00",
"shortValue": "0",
"leverage": "0.34",
"positions": 3,
"observedAt": "2026-06-12T12:00:00Z",
"netPnl": "820000.12",
"roi": "7.12",
"uPnl": "42000.40",
"roe": "4.80",
"trades": 240,
"avgMarginUsedRatio": "12.40",
"openPositions": [
{
"symbol": "BTC",
"direction": "long",
"positionValue": "3000000.00",
"liqPrice": "60350.5",
"observedAt": "2026-06-12T12:00:00Z",
"leverage": "5",
"size": "44.75",
"sizeUnit": "BTC",
"uPnl": "38000.10",
"uPnlPct": "6.33",
"entryPrice": "66150.2",
"markPrice": "67000.5",
"margin": "600000.00",
"fundingCost": "-1200.45"
}
]
}Read profile analytics
Profile analytics are stored separately from current account state. If no profile has been indexed for a wallet, the endpoint returns available: false with empty arrays.
curl -sS "https://api.dexhunt.app/api/developer/v1/networks/hyperliquid/wallets/0x1111111111111111111111111111111111111111/profile" \
-H "X-API-Key: hlsk_your_developer_key"{
"available": true,
"observedAt": "2026-06-12T12:00:00Z",
"tradingPerformance1w": "2.4",
"totalRawUsd": "12500000.42",
"totalMarginUsedUsd": "600000.00",
"crossMaintenanceMarginUsedUsd": "120000.00",
"dailyPnl": [
{
"date": "2026-06-11",
"pnlUsd": "18000.44",
"cumulativePnlUsd": "820000.12",
"accountValueUsd": "12500000.42"
}
],
"pnlSeries": [
{
"kind": "daily",
"t": "2026-06-11T00:00:00Z",
"realizedPnlUsd": "14000.00",
"dailyPnlUsd": "18000.44",
"cumulativePnlUsd": "820000.12",
"unrealizedPnlUsd": "42000.40",
"totalPnlUsd": "862000.52",
"accountValueUsd": "12500000.42"
}
],
"pnlSummary": [
{
"window": "7d",
"pnlUsd": "96000.12",
"volumeUsd": "12500000.00"
}
],
"fills": {
"count": 240,
"realizedPnlUsd": "778000.00",
"feesUsd": "9200.11",
"volumeUsd": "98100000.50",
"lastFillAt": "2026-06-12T11:55:00Z"
},
"spotBalances": [
{
"coin": "USDC",
"token": 0,
"total": "250000.00",
"hold": "0",
"entryNotionalUsd": null,
"valueUsd": "250000.00"
}
]
}Read open orders
Open orders are live activity, not cached profile history. Use a conservative timeout and handle 503 as a temporary upstream-read failure.
curl -sS "https://api.dexhunt.app/api/developer/v1/networks/hyperliquid/wallets/0x1111111111111111111111111111111111111111/open-orders?limit=2" \
-H "X-API-Key: hlsk_your_developer_key"{
"items": [
{
"coin": "BTC",
"side": "B",
"orderType": "Limit",
"price": "65000",
"size": "0.25",
"originalSize": "0.25",
"reduceOnly": false,
"isTrigger": false,
"triggerPrice": null,
"triggerCondition": null,
"tif": "Gtc",
"orderId": "912345678",
"createdAt": "2026-06-12T11:50:00Z"
}
]
}Read fills
Fills return recent trade executions with price, size, realized PnL, fee, and transaction hash.
curl -sS "https://api.dexhunt.app/api/developer/v1/networks/hyperliquid/wallets/0x1111111111111111111111111111111111111111/fills?limit=2" \
-H "X-API-Key: hlsk_your_developer_key"{
"items": [
{
"coin": "ETH",
"side": "A",
"direction": "Close Long",
"price": "3580.4",
"size": "12.5",
"closedPnl": "4200.15",
"fee": "17.91",
"feeToken": "USDC",
"crossed": true,
"orderId": "912345679",
"time": "2026-06-12T11:52:00Z",
"hash": "0xabc123"
}
]
}Read funding
Funding entries show per-coin funding payments and the funding rate observed for the position.
curl -sS "https://api.dexhunt.app/api/developer/v1/networks/hyperliquid/wallets/0x1111111111111111111111111111111111111111/funding?limit=2" \
-H "X-API-Key: hlsk_your_developer_key"{
"items": [
{
"coin": "BTC",
"paymentUsd": "-120.45",
"positionSize": "44.75",
"fundingRate": "0.0000125",
"time": "2026-06-12T08:00:00Z"
}
]
}Read transfers
Transfers return account transfer activity with amount, asset, fee, destination, and hash when available from the upstream source.
curl -sS "https://api.dexhunt.app/api/developer/v1/networks/hyperliquid/wallets/0x1111111111111111111111111111111111111111/transfers?limit=2" \
-H "X-API-Key: hlsk_your_developer_key"{
"items": [
{
"type": "withdrawal",
"direction": "out",
"asset": "USDC",
"amountUsd": "50000.00",
"tokenAmount": "50000.00",
"fee": "1.00",
"destination": "0x2222222222222222222222222222222222222222",
"time": "2026-06-12T09:30:00Z",
"hash": "0xdef456"
}
]
}What to do next
Markets
Use market endpoints to connect wallet positions to market-wide positioning and liquidation aggregates.
Timeseries
Query candle, open-interest, and positioning series for assets held by a wallet.
Rankings and activity
Build leaderboard and activity-feed experiences from ranking and news endpoints.
Related pages
Start
API Conventions
Shared DexHunt external API conventions for auth, decimal precision, coverage, pagination, validation, errors, and limits.
API Reference
Markets
Market snapshots, market detail, scanned wallet positions, and liquidation-level aggregates in the DexHunt external API.
API Reference
Rankings and Activity
Overview, trader rankings, asset rankings, whale activity, and market news endpoints in the DexHunt external API.