What one cohort holds right now

The cohort summary returns one cohort's long and short notional, bias, wallet and position counts, margin, equity and unrealized PnL across every coin at the newest snapshot.

GET /v1/hl-cohorts/segments/{cohort}/summary answers it in one call: everything one cohort holds at the newest 5-minute snapshot, summed across all coins. It returns long and short notional, bias, how many wallets and positions, how many wallets are in profit, margin used, equity, leverage ratios and a split by side. The full parameter list is on Cohort summary.

Quick answer

axis names the ladder the cohort is on, here pnl, the realized-PnL rank.

cURL

# what the top 1% by realized PnL hold right now, across every coin
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hl-cohorts/segments/3x_smart/summary?axis=pnl"

Example response

Captured from the live API on 2026-10-24 at 17:12 UTC. At 17:07 UTC the 2,291 3x smart wallets with open positions held $8.02B, 45% of it long (bias -0.10), with $15.3M of unrealized profit. exposure_ratio is notional over margin used (3.35x). pct_wallets_in_profit is a fraction: 38% of these wallets were net in profit on open positions.

Example response

{
  "axis": "pnl",
  "cohort": "3x smart",
  "opened_within": "all",
  "snapshot_ts": "2026-10-24T17:07:00Z",
  "total_long_usd": 3598828488.0,
  "total_short_usd": 4419173416.0,
  "total_value": 8018001904.0,
  "bias": -0.1023128876,
  "n_positions": 21917,
  "n_wallets": 2291,
  "n_wallets_in_profit": 861,
  "pct_wallets_in_profit": 0.3758184199,
  "total_margin_used": 2394589104.0,
  "total_equity": 1263398538.0,
  "n_wallets_with_equity": 1932,
  "exposure_ratio": 3.34838319,
  "perp_bias": -0.3981933204,
  "equity_exposure": 4.75302209,
  "equity_covered_share": 0.9990680188,
  "total_unrealized_pnl": 15292247.28,
  "by_side": {
    "long": {
      "value_usd": 3598828488.0,
      "share": 0.4488435562,
      "n_positions": 11597,
      "n_wallets": 1845,
      "margin_used": 1093588609.0,
      "unrealized_pnl": -66925466.67
    },
    "short": {
      "value_usd": 4419173416.0,
      "share": 0.5511564438,
      "n_positions": 10320,
      "n_wallets": 1221,
      "margin_used": 1301000495.0,
      "unrealized_pnl": 82217713.94
    }
  }
}

Variations

A size cohort. The size ladder needs axis=size, which is also the default.

cURL — 4x whale

# what accounts of $10m and up hold right now
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hl-cohorts/segments/4x_whale/summary?axis=size"

Only new positions. openedWithin=24h keeps the positions first seen in the last 24 hours.

cURL — last 24 h

# what the top 1% opened in the last day
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hl-cohorts/segments/3x_smart/summary?axis=pnl&openedWithin=24h"

Per coin instead of across the book. The heatmap splits the same cohort by coin.

cURL — by coin

# the top 1% by realized PnL, coin by coin
curl -s -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hl-cohorts/heatmap?axis=pnl" \
  | jq '[.heatmap[] | .symbol as $s | .segments[] | select(.cohort == "3x smart") | {symbol: $s, total_value, bias}] | .[:10]'

Before you rely on it

Two biases, two equities

bias is (long - short) / (long + short) over all positions. perp_bias and equity_exposure divide by equity instead, count only main-dex positions of wallets with a known positive equity, and can exceed 1. That equity is not total_equity, so the two do not reconcile. n_wallets counts only wallets holding a position, and a pnl cohort here is today's grading.

Ask your agent

Connected to the Vike MCP server (https://vike.io/mcp) in Claude, ChatGPT or Cursor, ask it in plain words. The hl_segments tool answers (view summary), at 1 credit a call.

Ask your agent

What do the top 1% of Hyperliquid traders by realized PnL hold right now?

What one cohort holds right now

Quick answer

Example response

Variations

Before you rely on it

Ask your agent

Related