Recipe 17 of 33
Daily 60-second Hyperliquid brief (cohorts + liquidations + movers)
Three calls make the brief; the realized-PnL heatmap for where smart money leans, the last 24 hours of liquidations, and an hourly price panel for the coins you follow.
GET /v1/hl-cohorts/heatmap, GET /v1/hyperliquid/liquidations and GET /v1/hyperliquid/symbols/hourly answer it
in three calls. /heatmap?axis=pnl shows how each realized-PnL cohort is
positioned on every coin now; /liquidations with start set 24 hours
back lists the day's liquidations, newest first; /symbols/hourly
returns an hourly close for a basket of coins, so the day's movers are the first and last close of each.
Quick answer
Set SINCE to 24 hours ago in ISO-8601 UTC, then make the three calls.
# where each realized-PnL cohort leans on every coin, at the newest snapshot
curl -H "X-API-Key: $VIKE_API_KEY" \
"https://data.vike.io/v1/hl-cohorts/heatmap?axis=pnl"
# the last 24 hours of liquidations: SINCE is 24 hours ago, ISO-8601 UTC
curl -H "X-API-Key: $VIKE_API_KEY" \
"https://data.vike.io/v1/hyperliquid/liquidations?start=$SINCE&limit=5000"
# one day of hourly closes for the coins you follow
curl -H "X-API-Key: $VIKE_API_KEY" \
"https://data.vike.io/v1/hyperliquid/symbols/hourly?symbols=BTC,ETH,SOL,HYPE&days=1"Example response
Captured from the live API on 2026-10-24 at 17:13 UTC from the liquidations call with limit=5, trimmed to 3 rows;
label_computed shortened.
side is the side that was closed: long means a long was liquidated as price fell. size_usd is
the notional at mark_price. The movers call in the same minute put BTC 1.6% lower over the day
($81,431 to $80,103), ETH 3.6% lower, SOL 3.5% and HYPE 2.8%.
{
"liquidations": [
{
"liq_ts": "2026-10-24T17:02:00+00:00",
"wallet": "0xfd6a1efbb9292f675052f101249dd7f72ff8c313",
"symbol": "SOL",
"side": "long",
"size_token": 10.25,
"size_usd": 1025.5125,
"mark_price": 100.05,
"size_cohort": null,
"pnl_cohort": null,
"pnl_cohort_basis": null
},
{
"liq_ts": "2026-10-24T17:02:00+00:00",
"wallet": "0xfb697d3976e42df505286fde283000608c20926d",
"symbol": "BTC",
"side": "short",
"size_token": 3.01863,
"size_usd": 241149.29481,
"mark_price": 79887.0,
"size_cohort": "2x shrimp",
"pnl_cohort": "3x rekt",
"pnl_cohort_basis": "current"
},
{
"liq_ts": "2026-10-24T17:02:00+00:00",
"wallet": "0xfae9ffba1dbcaff024225812f38f613c636ce78c",
"symbol": "BTC",
"side": "short",
"size_token": 0.01534,
"size_usd": 1225.46658,
"mark_price": 79887.0,
"size_cohort": null,
"pnl_cohort": null,
"pnl_cohort_basis": null
}
],
"label_computed": {
"grading": "realized",
"when": "at the row's own hour where an hourly label exists for it; at query time for the rows it does not (see caveat)",
"lookahead": false,
"resolution": "hourly",
"source": "hourly point-in-time label set (fallback: live wallet realized-PnL ladder)"
},
"nextCursor": "eyJ0cyI6IjIwMjYtMTAtMjQgMTc6MDI6MDAuMDAwIiwidyI6IjB4ZmFjZTRhYmUwZTU1NDEyYjMxYTU2MmExNTI3NmMzZGRjNDcwNzQzZCJ9"
}Variations
Liquidations by side. Sum the day's liquidations per side in one pass.
# count and USD of longs and shorts liquidated since SINCE
curl -s -H "X-API-Key: $VIKE_API_KEY" \
"https://data.vike.io/v1/hyperliquid/liquidations?start=$SINCE&limit=5000" \
| jq '.liquidations | group_by(.side) | map({side: .[0].side, n: length, usd: (map(.size_usd) | add)})'The next page of liquidations. A busy day can pass 5000 rows. Pass nextCursor back verbatim until it is null.
# next page of the call above: NEXT is its nextCursor
curl -H "X-API-Key: $VIKE_API_KEY" \
"https://data.vike.io/v1/hyperliquid/liquidations?start=$SINCE&limit=5000&cursor=$NEXT"Smart money on the biggest coins. Keep the 3x smart cell of the ten largest coins from the heatmap.
# top-1% positioning on the ten coins with the most open notional
curl -s -H "X-API-Key: $VIKE_API_KEY" \
"https://data.vike.io/v1/hl-cohorts/heatmap?axis=pnl" \
| jq '[.heatmap[:10][] | .symbol as $s | .segments[] | select(.cohort == "3x smart") | {symbol: $s, bias, share_of_symbol}]'Before you rely on it
Movers cover only your basket, and the last hour is partial
The price panel answers only the coins you pass in symbols (up to 64), so "movers" means movers
in your basket. Its newest row is the hour in progress, so a day-change from it moves until the
hour closes. The heatmap is large (342 coins in this capture). On liquidations size_cohort and
pnl_cohort are null for wallets the labels cannot place, and pnl_cohort_basis says when a
label is today's.
Liquidations are inferred
A liquidation here is a position that was within 5% of its liquidation price at one 5-minute snapshot and is gone at the next. A position closed by hand that close to its liquidation price is counted too.
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 heatmap), with hl_liquidations for the liquidations and hl_ohlcv for the prices, at 1 credit a call each.
Give me a 60-second Hyperliquid brief: smart-money positioning, the last 24 hours of liquidations, and how BTC, ETH, SOL and HYPE moved