API EndpointsHyperliquid
/segments
The detailed catalogue: every bucket on every axis with its boundaries, slug, rank, basis and a groupable flag.
GET https://data.vike.io/v1/hyperliquid/segmentsThe detailed catalogue: every bucket on every axis with its boundaries, slug, rank, basis and a
groupable flag. Takes no parameters.
# the whole cohort catalogue: every bucket on every axis, with bounds, slug and rank
curl -s "https://data.vike.io/v1/hyperliquid/segments" \
-H "X-API-KEY: $VIKE_API_KEY"
# which axes can be passed as axis= to /heatmap and /segments/{cohort}/summary
curl -s "https://data.vike.io/v1/hyperliquid/segments" \
-H "X-API-KEY: $VIKE_API_KEY" \
| jq '[.[] | select(.groupable) | .axis] | unique'
# the dollar-banded ladder with its bounds, for porting an absolute-dollar PnL scheme
curl -s "https://data.vike.io/v1/hyperliquid/segments" \
-H "X-API-KEY: $VIKE_API_KEY" \
| jq '[.[] | select(.axis == "pnl_abs") | {cohort, slug, min_usd, max_usd}]'
# pnl and pnl_abs band one number two ways: compare their basis strings before comparing buckets
curl -s "https://data.vike.io/v1/hyperliquid/segments" \
-H "X-API-KEY: $VIKE_API_KEY" \
| jq '[.[] | {axis, basis}] | unique'Truncated: the array holds 44 rows — every bucket on all four axes (size, pnl, pnl_abs,
trade_size); the first 3 are shown.
[
{
"axis": "size",
"cohort": "4x whale",
"slug": "4x_whale",
"rank": 1,
"basis": "account_value_usd",
"applies_to": "wallet",
"groupable": true,
"min_usd": 10000000.0,
"max_usd": null,
"percentile_min": null,
"percentile_max": null,
"min_closed_trades": null
},
{
"axis": "size",
"cohort": "3x whale",
"slug": "3x_whale",
"rank": 2,
"basis": "account_value_usd",
"applies_to": "wallet",
"groupable": true,
"min_usd": 5000000.0,
"max_usd": 10000000.0,
"percentile_min": null,
"percentile_max": null,
"min_closed_trades": null
},
{
"axis": "size",
"cohort": "2x whale",
"slug": "2x_whale",
"rank": 3,
"basis": "account_value_usd",
"applies_to": "wallet",
"groupable": true,
"min_usd": 2500000.0,
"max_usd": 5000000.0,
"percentile_min": null,
"percentile_max": null,
"min_closed_trades": null
}
]groupable is false for trade_size, so filter on it before generating calls from this catalogue: Cohorts and axes.