DatasetsHyperliquid
Cohort metrics
One coin's positioning across every cohort of a ladder, hourly — up to a year in one request.
One coin's positioning across every cohort of a ladder, hourly — up to a year in one request.
Coverage and cadence
Cadence. Hourly buckets
One coin, every cohort on an axis (size, tier, pnl, pnl_abs), up to 8,760 hourly buckets per request, paged by hour. axis=size and axis=tier are always point_in_time; axis=pnl takes labelBasis=point_in_time (each hour's label as it was then — point-in-time labels from 2026-04-07) or current; every response declares which in label_basis and label_computed. /segments publishes every ladder's bounds.
Fields
| Field | Type | Description |
|---|---|---|
ts | string | Hour bucket, ISO-8601 UTC |
cohort | string | Rung on the chosen axis, e.g. whale, 3x smart, $1m-$2.5m |
position_count | integer | Open positions in the cohort |
position_count_long | integer | …of which long |
total_position_value | number | Notional, USD |
total_position_value_long | number | Long notional, USD |
total_unrealized_pnl | number | Unrealized PnL, USD |
total_position_size | number | Size in coin units |
total_position_size_long | number | Long size in coin units |
bias | number | (long − short) / (long + short), by notional |
label_basis | string | point_in_time | current — the basis actually used |
grading | string | On axis=pnl rows: which PnL grading labelled the wallet (realized by default) |
How to get it
Sample call
The call the dataset explorer builds:
curl -s "https://data.vike.io/v1/hyperliquid/coins/BTC/cohort-metrics?axis=size&hours=1&labelBasis=point_in_time" \
-H "X-API-KEY: $VIKE_API_KEY"