DH
4 min read·Updated 2026-06-14

List wallets

Browse and sort the tracked-wallet directory.

GET/networks/{network}/wallets

Filter the wallet directory for trader discovery. The analytics filters (profitSize, style, minWinRate, and the rest) only match wallets that have profile analytics. Send nextCursor back as cursor to page.

Path Params
networkstringrequired

Network identifier. Only hyperliquid is supported.

Example: hyperliquid

Query Params
sizestring

Filter by capital class: shrimp, shark, whale. Repeatable.

directionstring

Filter by directional exposure: long, short, neutral. Repeatable.

minAccountValuenumber

Minimum total account value in USD.

Example: 1000000

maxAccountValuenumber

Maximum total account value in USD.

profitSizestring

Filter by profit-size tag. Repeatable. Needs profile analytics.

Example: large

profitStatusstring

Filter by profit-status tag. Repeatable. Needs profile analytics.

Example: sustained

pacestring

Filter by trading pace. Repeatable. Needs profile analytics.

Example: swinger

stylestring

Filter by strategy style. Repeatable. Needs profile analytics.

Example: lowDd

strategystring

Filter by derived strategy. Repeatable. Needs profile analytics.

Example: lowDd

minWinRatenumber

Minimum win rate percentage. Needs profile analytics.

Example: 60

maxDrawdownnumber

Maximum drawdown percentage. Needs profile analytics.

Example: 10

changedInHoursinteger

Return only wallets re-scanned within the last N hours.

Example: 1

sortstring

Sort field — accountTotalValue, netPnl, roi, volume, winRate, sharpe, maxDrawdown.

Example: roi

orderstring

Sort direction — desc (default) or asc.

Example: desc

limitinteger

Maximum results per page. Default 25, hard cap 200.

Example: 25

cursorstring

Cursor value from the previous page's nextCursor field.

Responses

200OK

Paginated list of wallets matching the filters.

Schema
itemsobject[]

Matching wallets for this page.

addressstring

Wallet address.

labelstringnullable

Human label if DexHunt has one.

tagsstring[]

Classification tags (capital and quality tiers).

kolsobject[]

Linked KOL identities, empty when none.

kolProfileobjectnullable

Primary KOL profile if the wallet is a known influencer.

sizeClassstring

Derived capital class — shrimp, shark, or whale.

directionstring

Net directional exposure — long, short, or neutral.

accountTotalValuestring (decimal)

Total account value in USD.

totalPositionValuestring (decimal)

Sum of open position notional in USD.

longValuestring (decimal)

Notional held long.

shortValuestring (decimal)

Notional held short.

leveragestring

Account-level leverage ratio.

positionsinteger

Number of currently open positions.

observedAtstring (ISO 8601)

Snapshot timestamp.

netPnlstringnullable

Net PnL from profile analytics.

totalPnlstringnullable

Total PnL from profile analytics.

roistringnullable

Return on investment percentage.

volumestringnullable

Traded volume in USD.

closedPositionsintegernullable

Number of closed positions.

winRatestringnullable

Win rate percentage.

spotValuestringnullable

Spot balances value in USD.

perpValuestringnullable

Perpetual account value in USD.

sharpestringnullable

Sharpe ratio.

maxDrawdownstringnullable

Maximum drawdown percentage.

profitSizestringnullable

Profit-size tag.

profitStatusstringnullable

Profit-status tag.

pacestringnullable

Trading pace tag.

stylestringnullable

Strategy style tag.

strategystringnullable

Derived strategy style.

strategyConfidencestringnullable

Confidence score for the strategy label (0–1).

nextCursorstringnullable

Cursor for the next page, or null at the end.

totalinteger

Total wallets matching the filters.

coveragestring

Always scanned_wallets for this endpoint.

400Bad Request
401Unauthorized
404Not Found
500Server Error
Request
curl -sS "https://api.dexhunt.app/v1/networks/hyperliquid/wallets?size=whale&direction=long&sort=roi&order=desc&limit=2" \
  -H "X-API-Key: hlsk_your_developer_key"
Response
200 · OK
{
  "items": [
    {
      "address": "0x1111111111111111111111111111111111111111",
      "label": null,
      "tags": ["whale", "high_quality"],
      "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",
      "roi": "7.12",
      "volume": "98100000.50",
      "winRate": "63.50",
      "sharpe": "1.48",
      "maxDrawdown": "8.20",
      "strategy": "lowDd",
      "strategyConfidence": "0.82"
    }
  ],
  "nextCursor": "2",
  "total": 14,
  "coverage": "scanned_wallets"
}