How many wallets are in each tier (wallet and PnL distribution)

Call the cohort summary once per tier and read n_wallets; it counts the wallets with at least one open position, and the heatmap's totals give the denominator.

GET /v1/hl-cohorts/segments/{cohort}/summary answers it one tier per call: its n_wallets is the wallets of that tier holding at least one open position at the newest snapshot. Call it once per tier, 12 times for the size ladder or 13 for the realized-PnL ladder; /segments lists the tiers and their bounds, and the heatmap's totals.n_wallets is the number of wallets with any open position. The full parameter list is on Cohort summary.

Quick answer

shrimp is the smallest account tier.

cURL

# how many wallets in the smallest account tier hold an open position now
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hl-cohorts/segments/shrimp/summary?axis=size"

Example response

Captured from the live API on 2026-10-24 at 17:12 UTC. 104,095 shrimp wallets (accounts under $1k) held 224,878 positions. The same call for whale returned 231 wallets, and the heatmap's totals.n_wallets was 137,770 wallets with any open position, so shrimp were 76% of them. pct_wallets_in_profit is a fraction: 38% of shrimp wallets were net in profit on their open positions.

Example response

{
  "axis": "size",
  "cohort": "shrimp",
  "opened_within": "all",
  "snapshot_ts": "2026-10-24T17:07:00Z",
  "total_long_usd": 88013317.54,
  "total_short_usd": 31288566.96,
  "total_value": 119301884.5,
  "bias": 0.4754723768,
  "n_positions": 224878,
  "n_wallets": 104095,
  "n_wallets_in_profit": 39754,
  "pct_wallets_in_profit": 0.381901148,
  "total_margin_used": 29690105.2,
  "total_equity": 11125032.56,
  "n_wallets_with_equity": 77670,
  "exposure_ratio": 4.018237177,
  "perp_bias": 3.544865877,
  "equity_exposure": 6.335663049,
  "equity_covered_share": 0.8675102586,
  "total_unrealized_pnl": -4326114.098,
  "by_side": {
    "long": {
      "value_usd": 88013317.54,
      "share": 0.7377361884,
      "n_positions": 153829,
      "n_wallets": 83054,
      "margin_used": 20648336.83,
      "unrealized_pnl": -4562912.632
    },
    "short": {
      "value_usd": 31288566.96,
      "share": 0.2622638116,
      "n_positions": 71049,
      "n_wallets": 30718,
      "margin_used": 9041768.371,
      "unrealized_pnl": 236798.5333
    }
  }
}

Variations

The tier list to loop over. /segments returns every tier with its bounds and slug; the size tiers are the 12 rows with axis size.

cURL — tiers

# the size tiers, largest first, with their account-value bounds
curl -s -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hl-cohorts/segments" \
  | jq '[.[] | select(.axis == "size") | {slug, min_usd, max_usd}]'

Another tier. Each tier is its own call; the slug stands in for a label with a space.

cURL — whale

# wallets in the $1m to $2.5m tier holding a position
curl -s -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hl-cohorts/segments/whale/summary?axis=size" \
  | jq '{cohort, n_wallets, n_positions}'

The PnL distribution. On axis=pnl the same call counts a realized-PnL tier; unknown is the wallets under 10 closed trades.

cURL — pnl tier

# wallets in the top 1% by realized PnL holding a position
curl -s -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hl-cohorts/segments/3x_smart/summary?axis=pnl" \
  | jq '{cohort, n_wallets, n_positions}'

The denominator. totals.n_wallets counts each wallet once across all coins.

cURL — total

# every wallet with an open position, once
curl -s -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hl-cohorts/heatmap?axis=size" \
  | jq '.totals | {n_wallets, n_wallets_source}'

Before you rely on it

Counts cover open positions only, one call per tier

/segments is a fixed catalogue of tiers and bounds and carries no counts. n_wallets on the summary counts only wallets holding an open position at the newest snapshot, so an idle account is in no tier. A full distribution is 12 calls (size) or 13 (pnl). The heatmap's total comes from a precomputed figure that can trail the summaries by a few minutes, so the tiers may not add up to it exactly.

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

How many Hyperliquid wallets with open positions are in each account-size tier?

How many wallets are in each tier (wallet and PnL distribution)

Quick answer

Example response

Variations

Before you rely on it

Ask your agent

Related