/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.

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-09-03T08:05:59+00:00",
  "has_metrics": true,
  "equity": {
    "as_of": "2026-09-03T08:04:00+00:00",
    "account_value": 1661040.506568,
    "margin_used": 753469.656636,
    "cash_balance_usd": 5073036.012782,
    "total_unrealized_pnl": -127149.9813,
    "num_positions": 140
  },
  "open_positions": {
    "count": 143,
    "notional_usd": 11949787.046935001,
    "unrealized_pnl": -127250.71641500016,
    "margin_used": 1303534.4115760627,
    "as_of": "2026-09-03T07:59: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-09-02T19:38:00+00:00",
    "with_known_open_ts": 143
  },
  "cohorts": {
    "size": "3x whale",
    "pnl": "3x smart",
    "pnl_tag": "drawdown_recovery",
    "style_tag": "streak_trader"
  },
  "lifetime": {
    "cum_realized_pnl": 3917992.366811535,
    "cum_fills": 6417096,
    "last_fill_ts": "2026-09-03T08:07:48.351000+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": 457
  },
  "ledger_by_type": [
    {
      "event_type": "send",
      "amount_usd": -11658895.529263001,
      "fee_usd": 0.0,
      "count": 457,
      "first_ts": "2026-01-14T19:00:57.067000+00:00",
      "last_ts": "2026-09-03T00:31:21.150000+00:00"
    }
  ],
  "metrics": {
    "wallet": "0x25773676902085225ae5751075e4161369334897",
    "account_value": 1671052.77246,
    "total_realized_pnl": 3716145.2005327553,
    "roi": 222.38347356691327,
    "pnl_pct": 222.38347356691327,
    "total_volume": 26290176002.307007,
    "total_fee": 930945.91746686,
    "trade_count": 135740,
    "win_count": 70654,
    "loss_count": 65086,
    "win_rate": 0.5205097794532776,
    "long_win_rate": 0.5239437818527222,
    "short_win_rate": 0.5170527696609497,
    "long_pnl": 1892139.8385331659,
    "short_pnl": 1824005.3619995913,
    "profit_factor": 1.2365819215774536,
    "expectancy": 27.376935321443607,
    "max_drawdown_pct": 100.0,
    "current_drawdown_pct": 36.20000076293945,
    "calmar_ratio": 2.223834753036499,
    "recovery_factor": 2.223834753036499,
    "max_win_streak": 28,
    "max_loss_streak": 77,
    "avg_leverage": 0.0,
    "avg_duration_seconds": 4492,
    "pnl_cohort_tag": "drawdown_recovery",
    "style_cohort_tag": "streak_trader"
  }
}

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 /segments and /heatmap apply, so cohort comparisons stay like-for-like.