HL Cohorts
How whales, small accounts and profitable traders are positioned on Hyperliquid, per coin and per hour, with labels that can be read without lookahead.
How whales, small accounts and profitable traders are positioned on Hyperliquid: the cohort ladders, one cohort's
long, short and bias over time, a coin by cohort heatmap and per-coin cohort series, over
the /v1/hl-cohorts routes. A label can be read as it stood at each hour, which is what a backtest needs.
What it answers
Each recipe answers one question with a call you can copy and a real response. All recipes lists every one by number.
The data behind it
| Dataset | Kind | What it holds |
|---|---|---|
| Cohort metrics | data | One coin's positioning across every cohort of a ladder, hourly — up to a year in one request. |
| Cohort positioning | analytics | What one cohort holds across every symbol: long and short notional, bias, wallets in profit and leverage over native perp equity at the latest snapshot, or long, short and bias hour by hour from 2026-04-07 (axis=size or pnl), with the leverage ratios on request. |
| Cohort heatmap | analytics | Every symbol against every cohort of one ladder (size, pnl or pnl_abs) at the latest 5-minute snapshot: the whole positioning board in one call. |
| Symbol cohort series | analytics | One symbol's hourly open interest, position count and bias (all cohorts or one), its current split by position-size bucket, and the Smart Money and Whale-vs-Shrimp indices as ratios. |
| Large fills | analytics | One symbol's fills of $50,000 or more from the last 24 hours, newest first, with the wallet's size and PnL cohort; the feed keeps the newest 200 per symbol, so on a busy symbol it reaches back minutes. |
Endpoints
| Endpoint | Request | What it returns |
|---|---|---|
| Cohort ladders | GET /v1/hl-cohorts/cohorts | The canonical cohort ladders — label sets only, in axis order. |
| Cohort catalogue | GET /v1/hl-cohorts/segments | The cohort catalogue: every bucket on every axis, with its boundaries. |
| Cohort summary | GET /v1/hl-cohorts/segments/{cohort}/summary | Aggregate positioning for one cohort at the latest snapshot. |
| Cohort history | GET /v1/hl-cohorts/segments/{cohort}/history | One cohort's long / short / bias per hour, summed over every symbol. |
| Coin by cohort heatmap | GET /v1/hl-cohorts/heatmap | Coin x cohort positioning matrix — the whole board in one call. |
| Coin metrics | GET /v1/hl-cohorts/symbols/{symbol}/metrics | Hourly open-interest / position-count / bias series for one coin, optionally sliced to a single cohort. |
| Coin indices | GET /v1/hl-cohorts/symbols/{symbol}/indices | Smart Money Index, Whale-vs-Shrimp Index, whale / smart bias: the website's numbers as RATIOS in [-1, +1] (the site multiplies by 100). |
| Large fills | GET /v1/hl-cohorts/symbols/{symbol}/large-fills | The asset page's Whale Activity feed: a symbol's large fills, newest first. |
| Coin cohort metrics | GET /v1/hl-cohorts/symbols/{symbol}/cohort-metrics | The full cohort matrix for one coin — every bucket on an axis, hourly. |
| Coin size breakdown | GET /v1/hl-cohorts/symbols/{symbol}/size-breakdown | Positioning split by canonical position-size bucket for one coin. |
What every route in this namespace shares is on HL Cohorts endpoints.
Before you rely on it
Before you rely on it lists what the field names do not tell you. Cohorts and axes defines the ladders, and Label basis says when a label was computed.