3 min read·Updated 2026-06-14

Wallet portfolio

One-call account snapshot with open positions and unrealized PnL.

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

A single-call snapshot of the wallet's current account state plus all open positions, including unrealized PnL — without separate wallet-detail and position lookups.

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

Account snapshot with all open positions and unrealized PnL.

Schema

networkstring

Network identifier.

walletAddressstring

Wallet address.

accountTotalValueUsdstring

Total account value in USD.

perpEquityUsdstring

Perpetual account equity.

spotValueUsdstring

Spot balances value.

totalPositionValueUsdstring

Sum of open position notional.

longPositionValueUsdstring

Notional held long.

shortPositionValueUsdstring

Notional held short.

leverageRatiostring

Account leverage ratio.

tradingPerformance1wstringnullable

7-day performance percentage.

tagsstring[]

Classification tags.

observedAtstring (ISO 8601)

Snapshot timestamp.

positionsobject[]

Open positions.

canonicalAssetstring

Canonical asset symbol.

networkAssetSymbolstring

Network asset symbol.

sidestring

Position side.

amountUsdstring

Position notional in USD.

liquidationPricestringnullable

Liquidation price.

unrealizedPnlUsdstringnullable

Unrealized PnL in USD.

observedAtstring (ISO 8601)

Position snapshot timestamp.

400Bad Request

401Unauthorized

404Not Found

500Server Error

Request

curl -sS "https://api.dexhunt.app/v1/networks/hyperliquid/wallets/0x1111111111111111111111111111111111111111/portfolio" \
  -H "X-API-Key: hlsk_your_developer_key"

Response

200 · OK

{
  "network": "hyperliquid",
  "walletAddress": "0x1111111111111111111111111111111111111111",
  "accountTotalValueUsd": "12500000.42",
  "perpEquityUsd": "12250000.42",
  "spotValueUsd": "250000.00",
  "totalPositionValueUsd": "4200000.00",
  "longPositionValueUsd": "4200000.00",
  "shortPositionValueUsd": "0",
  "leverageRatio": "0.34",
  "tradingPerformance1w": "2.4",
  "tags": ["whale", "high_quality"],
  "observedAt": "2026-06-12T12:00:00Z",
  "positions": [
    {
      "canonicalAsset": "BTC",
      "networkAssetSymbol": "BTC",
      "side": "long",
      "amountUsd": "3000000.00",
      "liquidationPrice": "60350.5",
      "unrealizedPnlUsd": "38000.10",
      "observedAt": "2026-06-12T12:00:00Z"
    }
  ]
}

Wallets

Get wallet

Directory fields plus free margin, account-level unrealized PnL, ROE, and trade count for one wallet.

Wallets

Wallet profile

Indexed analytics stored apart from current state: daily PnL series, fills summary, and balances.