/segments/{cohort}/summary

GET https://data.vike.io/v1/hl-cohorts/segments/{cohort}/summary

Aggregate positioning for one cohort at the latest snapshot.

# aggregate positioning of the smallest account tier
curl -s "https://data.vike.io/v1/hl-cohorts/segments/shrimp/summary?axis=size" \
  -H "X-API-KEY: $VIKE_API_KEY"

# smart-money positioning: a pnl label needs axis=pnl, or the size ladder is assumed and the label is refused
curl -s "https://data.vike.io/v1/hl-cohorts/segments/3x_smart/summary?axis=pnl" \
  -H "X-API-KEY: $VIKE_API_KEY"

# everyone banded at $1m+ of cumulative realized PnL, in dollars
curl -s "https://data.vike.io/v1/hl-cohorts/segments/1m_plus/summary?axis=pnl_abs" \
  -H "X-API-KEY: $VIKE_API_KEY"

# what the largest accounts opened in the last day
curl -s "https://data.vike.io/v1/hl-cohorts/segments/4x_whale/summary?axis=size&openedWithin=24h" \
  -H "X-API-KEY: $VIKE_API_KEY"

# wallets the realized-PnL ladder cannot place (under 10 closed trades) are a bucket of their own
curl -s "https://data.vike.io/v1/hl-cohorts/segments/unknown/summary?axis=pnl" \
  -H "X-API-KEY: $VIKE_API_KEY"

{
  "axis": "size",
  "cohort": "shrimp",
  "opened_within": "all",
  "snapshot_ts": "2026-09-03T07:59:00Z",
  "total_long_usd": 65653615.07,
  "total_short_usd": 36290036.09,
  "total_value": 101943651.2,
  "bias": 0.2880373485,
  "n_positions": 177573,
  "n_wallets": 90696,
  "n_wallets_in_profit": 47253,
  "pct_wallets_in_profit": 0.5210042339,
  "total_margin_used": 24105649.81,
  "total_equity": 9911731.106,
  "n_wallets_with_equity": 68060,
  "exposure_ratio": 4.229035597,
  "total_unrealized_pnl": -994085.9799,
  "by_side": {
    "long": {
      "value_usd": 65653615.07,
      "share": 0.6440186743,
      "n_positions": 125103,
      "n_wallets": 68812,
      "margin_used": 14244413.93,
      "unrealized_pnl": -370747.1081
    },
    "short": {
      "value_usd": 36290036.09,
      "share": 0.3559813257,
      "n_positions": 52470,
      "n_wallets": 29885,
      "margin_used": 9861235.882,
      "unrealized_pnl": -623338.8718
    }
  }
}

The captured example does not show the next three fields, which were added after it. Beside bias and exposure_ratio the response carries three native-equity ratios:

They are the native perp account only. A wallet is counted when it holds a main-dex position and has a known, positive native perp equity; long and short are the counted wallets' main-dex notional, and equity is their native perp account value, each wallet once. Builder-DEX positions are not included. The ratios are unbounded: above 1 means more than 1x of equity. equity_covered_share says how much of the cohort's main-dex notional the counted wallets hold, so how much of the cohort the other two describe.

• perp_bias and equity_exposure are null when that equity is not above 0; equity_covered_share is null when the cohort holds no main-dex notional.
• That equity is not total_equity: perp_bias × total_equity is not total_long_usd − total_short_usd.
• Under openedWithin, long and short are the qualifying positions and the equity is the whole native account of every wallet holding one.
• exposure_ratio is unchanged: notional / margin used.

The same three ratios per hour are include=leverage on /segments/{cohort}/history.