Wallet summary

One wallet in one call — equity, its cohort labels on each ladder, the risk-metric set, lifetime external flow and the open-positions block.

GET https://data.vike.io/v1/hyperliquid/wallets/{address}

One wallet in one call: equity, its cohort labels on each ladder, the risk-metric set, lifetime external flow and the open-positions block. The entry point for any per-wallet investigation.

cURL

# one wallet in one call: equity, cohort labels, risk metrics, lifetime flow, open positions
curl -s "https://data.vike.io/v1/hyperliquid/wallets/0x25773676902085225ae5751075e4161369334897?window=all&openedWithin=all" \
  -H "X-API-KEY: $VIKE_API_KEY"

# this week's metrics
curl -s "https://data.vike.io/v1/hyperliquid/wallets/0x25773676902085225ae5751075e4161369334897?window=7d" \
  -H "X-API-KEY: $VIKE_API_KEY"

# this week's trading, and only what the wallet opened today
curl -s "https://data.vike.io/v1/hyperliquid/wallets/0x25773676902085225ae5751075e4161369334897?window=7d&openedWithin=24h" \
  -H "X-API-KEY: $VIKE_API_KEY"

# is the PnL trading or deposits: lifetime realized PnL beside net deposits, with the cohort labels
curl -s "https://data.vike.io/v1/hyperliquid/wallets/0x25773676902085225ae5751075e4161369334897?window=30d" \
  -H "X-API-KEY: $VIKE_API_KEY" \
  | jq '{cohorts, cum_realized_pnl: .lifetime.cum_realized_pnl, net_deposit_usd: .lifetime.net_deposit_usd}'

# the full list behind open_positions
curl -s "https://data.vike.io/v1/hyperliquid/positions?wallet=0x25773676902085225ae5751075e4161369334897&limit=200" \
  -H "X-API-KEY: $VIKE_API_KEY"

# then how it got there
curl -s "https://data.vike.io/v1/hyperliquid/wallets/0x25773676902085225ae5751075e4161369334897/trades?limit=100" \
  -H "X-API-KEY: $VIKE_API_KEY"

addresspathrequired

The wallet

windowqueryoptional

1d | 7d | 30d | all. Default all

openedWithinqueryoptional

24h | 7d | 30d | all. Default all

Example response

{
  "wallet": "0x25773676902085225ae5751075e4161369334897",
  "window": "all",
  "metrics_updated_at": "2026-10-19T19:39:15+00:00",
  "has_metrics": true,
  "equity": {
    "as_of": "2026-10-19T20:09:00+00:00",
    "account_value": 4009506.757818,
    "margin_used": 998624.330594,
    "cash_balance_usd": 6869066.793963,
    "total_unrealized_pnl": -37106.26492,
    "num_positions": 173
  },
  "open_positions": {
    "count": 200,
    "notional_usd": 18933972.554169,
    "unrealized_pnl": -36260.42855399965,
    "margin_used": 2805265.761242886,
    "as_of": "2026-10-19T20:09:00+00:00",
    "dexes": [
      "HL",
      "IO",
      "XYZ",
      "PARA"
    ],
    "opened_within": "all",
    "oldest_opened_at": "2026-04-02T08:36:00+00:00",
    "newest_opened_at": "2026-10-16T17:58:00+00:00",
    "with_known_open_ts": 200
  },
  "cohorts": {
    "size": "3x whale",
    "pnl": "3x smart",
    "pnl_tag": "drawdown_recovery",
    "style_tag": "streak_trader"
  },
  "lifetime": {
    "cum_realized_pnl": 6029570.422678711,
    "cum_fills": 8499542,
    "last_fill_ts": "2026-10-19T20:22:00.854000+00:00",
    "deposit_usd": 0.0,
    "withdraw_usd": 0.0,
    "net_deposit_usd": 0.0,
    "vault_deposit_usd": 0.0,
    "vault_withdraw_usd": 0.0,
    "ledger_events": 1433
  },
  "ledger_by_type": [
    {
      "event_type": "send",
      "amount_usd": -11748907.675369,
      "fee_usd": 0.0,
      "count": 1407,
      "first_ts": "2026-01-14T19:00:57.067000+00:00",
      "last_ts": "2026-10-19T10:53:49.500000+00:00"
    },
    {
      "event_type": "spotTransfer",
      "amount_usd": 385.384404,
      "fee_usd": 0.0,
      "count": 26,
      "first_ts": "2026-10-19T17:25:19.437000+00:00",
      "last_ts": "2026-10-19T18:14:28.551000+00:00"
    }
  ],
  "metrics": {
    "wallet": "0x25773676902085225ae5751075e4161369334897",
    "account_value": 4007982.070391,
    "total_realized_pnl": 6183770.150411563,
    "roi": 154.28637258869534,
    "pnl_pct": 154.28637258869531,
    "total_volume": 40390857889.104065,
    "total_fee": 1191187.99296527,
    "trade_count": 147687,
    "win_count": 77849,
    "loss_count": 69838,
    "win_rate": 0.5271215438842773,
    "long_win_rate": 0.5270586609840393,
    "short_win_rate": 0.5271876454353333,
    "long_pnl": 4039629.372061321,
    "short_pnl": 2144140.7783502433,
    "profit_factor": 1.1816807985305786,
    "expectancy": 41.87078179129892,
    "max_drawdown_pct": 84.0999984741211,
    "current_drawdown_pct": 3.700000047683716,
    "calmar_ratio": 1.8345584869384766,
    "recovery_factor": 1.8345584869384766,
    "max_win_streak": 29,
    "max_loss_streak": 92,
    "avg_leverage": 0.0,
    "avg_duration_seconds": 11814,
    "pnl_cohort_tag": "drawdown_recovery",
    "style_cohort_tag": "streak_trader"
  }
}

A wallet we hold nothing for is a 400, not zeros

An address with no equity snapshot, open position, trade, fill or ledger event answers 400 naming it, where it used to answer 200 with every figure 0 and last_fill_ts at 1970-01-01. A wallet that has only ledger events (it deposited and never traded) is answered, with last_fill_ts null.

openedWithin bounds the open-positions block only

openedWithin bounds the open-positions block only. The equity, lifetime and metrics blocks are wallet-level totals with nothing per-position to filter, and bounding them would return a number that looks bounded and is not. Positions with no known open time are excluded from every bounded bucket — the same rule /v1/hl-cohorts/segments and /v1/hl-cohorts/heatmap apply, so cohort comparisons stay like-for-like.