DH
4 min read·Updated 2026-06-14

Get wallet

Full account state plus open positions for a single wallet address.

GET/networks/{network}/wallets/{address}

Wallet detail returns the directory fields plus free margin, account-level unrealized PnL, ROE, trade count, average margin used ratio, and the list of open positions. Position fields are nullable when the latest profile lacks matching per-position data.

Path Params
networkstringrequired

Network identifier. Only hyperliquid is supported.

Example: hyperliquid

addressstringrequired

Wallet address — 0x followed by 40 lowercase hex characters.

Example: 0x1111111111111111111111111111111111111111

Responses

200OK

Full wallet detail with open positions.

Schema
addressstring

Wallet address.

labelstringnullable

Human label if DexHunt has one.

tagsstring[]

Classification tags.

kolsobject[]

Linked KOL identities, empty when none.

kolProfileobjectnullable

Primary KOL profile if the wallet is a known influencer.

sizeClassstring

Derived capital class.

directionstring

Net directional exposure.

accountTotalValuestring (decimal)

Total account value in USD.

freeMarginAvailablestring (decimal)

Margin available for new positions.

totalPositionValuestring (decimal)

Sum of open position notional.

longValuestring (decimal)

Notional held long.

shortValuestring (decimal)

Notional held short.

leveragestring

Account-level leverage ratio.

positionsinteger

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

uPnlstringnullable

Account-level unrealized PnL.

roestringnullable

Return on equity percentage.

tradesintegernullable

Lifetime trade count.

avgMarginUsedRatiostringnullable

Average margin used ratio percentage.

openPositionsobject[]

Currently open positions.

symbolstring

Asset symbol of the open position.

directionstring

Position side — long or short.

positionValuestring (decimal)

Current notional value in USD.

liqPricestringnullable

Estimated liquidation price.

observedAtstring (ISO 8601)

When the position snapshot was taken.

leveragestringnullable

Position leverage multiplier.

sizestringnullable

Position size in base units.

sizeUnitstringnullable

Unit for size (the base asset).

uPnlstringnullable

Unrealized PnL in USD.

uPnlPctstringnullable

Unrealized PnL as a percentage.

entryPricestringnullable

Average entry price.

markPricestringnullable

Current mark price.

marginstringnullable

Margin allocated to the position.

fundingCoststringnullable

Cumulative funding paid (negative) or received.

400Bad Request
401Unauthorized
404Not Found
500Server Error
Request
curl -sS "https://api.dexhunt.app/v1/networks/hyperliquid/wallets/0x1111111111111111111111111111111111111111" \
  -H "X-API-Key: hlsk_your_developer_key"
Response
200 · OK
{
  "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"
    }
  ]
}