Get a free key
HL Cohorts · Long/short ratio

Hyperliquid long/short ratio — whales, smart money and retail, every hour

Who is long and who is short on Hyperliquid, split by cohort: whales and shrimp by account size, smart money and rekt traders by realized PnL. The long/short ratio of BTC, ETH, SOL and HYPE live, what each of 25 cohorts holds, the Smart Money and Whale-vs-Shrimp indices and the large fills, with every number on one free key: ask Claude or ChatGPT, or call the API.

Ask your AI · Claude, ChatGPT, CursorConnect in a minute →

“Are Hyperliquid whales long or short BTC right now?”

hl_cohort_metrics

“Which Hyperliquid cohorts hold the most right now, and is each net long or net short?”

hl_segments

“Is the Smart Money Index for HYPE rising or falling over the last 24 hours?”

hl_market
Live

Hyperliquid long/short ratio: BTC, ETH, SOL and HYPE by cohort

The coin's long/short ratio at the latest hour, and each cohort's bias beside it. Switch the coin and the ladder: size (whales to shrimp), tier (position size) or pnl (smart money to rekt).

Long/short by cohort · /symbols/{symbol}/cohort-metrics

GET/v1/hl-cohorts/symbols/BTC/cohort-metrics?axis=size&hours=1
Open this side to see the captured response.

    
GEThttps://data.vike.io/v1/hl-cohorts/symbols/BTC/cohort-metrics?axis=size&hours=1
25 cohorts

Whales, smart money and retail: what each cohort holds now

Every cohort of the account-size and realized-PnL ladders at the latest 5-minute snapshot, summed over every coin: long and short, bias, wallets, how many are in profit, leverage on equity and unrealized PnL. Each card opens that cohort on vike.io.

Account size: whales to shrimp

4x Whales4x whale

account value $10M or more

Bias
leans short · −0.41
Long / short
$1.2B / $2.8B
Wallets
79
In profit
71%
Exposure on equity
2.1×
Unrealized PnL
$353M
Open the cohort →
3x Whales3x whale

account value $5M to $10M

Bias
balanced · −0.01
Long / short
$810M / $826M
Wallets
111
In profit
50%
Exposure on equity
1.8×
Unrealized PnL
−$31.4M
Open the cohort →
2x Whales2x whale

account value $2.5M to $5M

Bias
slightly long · +0.06
Long / short
$724M / $643M
Wallets
196
In profit
52%
Exposure on equity
1.9×
Unrealized PnL
−$28.4M
Open the cohort →
Whaleswhale

account value $1M to $2.5M

Bias
slightly long · +0.11
Long / short
$852M / $686M
Wallets
438
In profit
53%
Exposure on equity
2.1×
Unrealized PnL
−$18.0M
Open the cohort →
2x Sharks2x shark

account value $500k to $1M

Bias
leans long · +0.23
Long / short
$564M / $357M
Wallets
573
In profit
47%
Exposure on equity
2.1×
Unrealized PnL
−$36.3M
Open the cohort →
Sharksshark

account value $250k to $500k

Bias
leans long · +0.27
Long / short
$466M / $269M
Wallets
892
In profit
46%
Exposure on equity
2.1×
Unrealized PnL
−$26.3M
Open the cohort →
2x Dolphins2x dolphin

account value $100k to $250k

Bias
leans long · +0.36
Long / short
$526M / $246M
Wallets
2,004
In profit
43%
Exposure on equity
2.2×
Unrealized PnL
−$42.1M
Open the cohort →
Dolphinsdolphin

account value $50k to $100k

Bias
leans long · +0.44
Long / short
$317M / $123M
Wallets
2,402
In profit
37%
Exposure on equity
2.4×
Unrealized PnL
−$27.6M
Open the cohort →
2x Fish2x fish

account value $25k to $50k

Bias
leans long · +0.47
Long / short
$242M / $86.5M
Wallets
3,239
In profit
35%
Exposure on equity
2.6×
Unrealized PnL
−$25.8M
Open the cohort →
Fishfish

account value $10k to $25k

Bias
leans long · +0.49
Long / short
$222M / $76.5M
Wallets
6,407
In profit
36%
Exposure on equity
2.6×
Unrealized PnL
−$22.0M
Open the cohort →
2x Shrimp2x shrimp

account value $1k to $10k

Bias
leans long · +0.57
Long / short
$256M / $69.3M
Wallets
25,967
In profit
33%
Exposure on equity
3.3×
Unrealized PnL
−$26.1M
Open the cohort →
Shrimpshrimp

account value under $1k

Bias
leans long · +0.53
Long / short
$57.2M / $17.7M
Wallets
93,801
In profit
36%
Exposure on equity
4.3×
Unrealized PnL
−$4.6M
Open the cohort →

Realized PnL: smart money to rekt

3x Smart Money3x smart

the top 1% of traders by cumulative realized PnL (10+ closed trades)

Bias
slightly short · −0.15
Long / short
$2.9B / $3.9B
Wallets
2,358
In profit
41%
Exposure on equity
2.3×
Unrealized PnL
$136M
Open the cohort →
2x Smart Money2x smart

traders ranked 1% to 5% from the top by cumulative realized PnL (10+ closed trades)

Bias
leans long · +0.34
Long / short
$511M / $249M
Wallets
6,796
In profit
30%
Exposure on equity
1.9×
Unrealized PnL
−$36.4M
Open the cohort →
Smart Moneysmart

traders ranked 5% to 10% from the top by cumulative realized PnL (10+ closed trades)

Bias
leans long · +0.31
Long / short
$110M / $57.2M
Wallets
7,600
In profit
30%
Exposure on equity
1.8×
Unrealized PnL
−$6.9M
Open the cohort →
3x Winners3x winner

traders ranked 10% to 20% from the top by cumulative realized PnL (10+ closed trades)

Bias
leans long · +0.28
Long / short
$50.8M / $28.4M
Wallets
11,653
In profit
32%
Exposure on equity
1.7×
Unrealized PnL
−$7.6M
Open the cohort →
2x Winners2x winner

traders ranked 20% to 30% from the top by cumulative realized PnL (10+ closed trades)

Bias
slightly long · +0.13
Long / short
$7.0M / $5.4M
Wallets
8,147
In profit
35%
Exposure on equity
1.4×
Unrealized PnL
−$91.1k
Open the cohort →
Winnerswinner

traders ranked 30% to 40% from the top by cumulative realized PnL (10+ closed trades)

Bias
leans long · +0.50
Long / short
$1.4M / $476k
Wallets
4,225
In profit
40%
Exposure on equity
1.4×
Unrealized PnL
−$50.6k
Open the cohort →
Losersloser

traders ranked 40% to 60% from the top by cumulative realized PnL (10+ closed trades)

Bias
slightly short · −0.02
Long / short
$6.6M / $6.9M
Wallets
9,415
In profit
46%
Exposure on equity
1.8×
Unrealized PnL
−$191k
Open the cohort →
2x Losers2x loser

traders ranked 60% to 70% from the top by cumulative realized PnL (10+ closed trades)

Bias
leans long · +0.25
Long / short
$5.0M / $3.0M
Wallets
6,304
In profit
42%
Exposure on equity
1.5×
Unrealized PnL
−$324k
Open the cohort →
3x Losers3x loser

traders ranked 70% to 80% from the top by cumulative realized PnL (10+ closed trades)

Bias
leans long · +0.33
Long / short
$16.5M / $8.3M
Wallets
7,968
In profit
39%
Exposure on equity
1.9×
Unrealized PnL
−$1.0M
Open the cohort →
Rektrekt

traders ranked 80% to 90% from the top by cumulative realized PnL (10+ closed trades)

Bias
leans long · +0.40
Long / short
$60.0M / $25.6M
Wallets
10,223
In profit
36%
Exposure on equity
1.9×
Unrealized PnL
−$3.0M
Open the cohort →
2x Rekt2x rekt

traders ranked 90% to 95% from the top by cumulative realized PnL (10+ closed trades)

Bias
leans long · +0.43
Long / short
$213M / $85.0M
Wallets
6,135
In profit
35%
Exposure on equity
2.5×
Unrealized PnL
$5.6M
Open the cohort →
3x Rekt3x rekt

the bottom 5% of traders by cumulative realized PnL (10+ closed trades)

Bias
slightly long · +0.08
Long / short
$2.0B / $1.7B
Wallets
7,244
In profit
36%
Exposure on equity
1.9×
Unrealized PnL
−$41.5M
Open the cohort →
Ungradedunknown

wallets with fewer than 10 closed trades, too few to rank by realized PnL

Bias
leans long · +0.42
Long / short
$388M / $159M
Wallets
48,029
In profit
36%
Exposure on equity
2.2×
Unrealized PnL
$19.3M
Open the cohort →

Captured 2026-11-13 22:55:51 UTC: each card is the answer of GET /v1/hl-cohorts/segments/4x_whale/summary?axis=size and its 24 siblings, at /data/showcase/ds_hl_cohorts_live.json.

The four cohort ladders and their bounds

Three ladders grade a wallet, one grades a position. The labels are the exact strings the API returns; a path takes the slug. GET /v1/hl-cohorts/segments returns these rows, each with axis, cohort, slug, rank, basis, applies_to, groupable, min_usd, max_usd, percentile_min, percentile_max, min_closed_trades; groupable is false on the position ladder, which /segments names trade_size.

Account size axis=size13 buckets

The wallet's account value in USD; bounds are [min, max).

14x whale 4x_whaleaccount value $10M or more
23x whale 3x_whaleaccount value $5M to $10M
32x whale 2x_whaleaccount value $2.5M to $5M
4whaleaccount value $1M to $2.5M
52x shark 2x_sharkaccount value $500k to $1M
6sharkaccount value $250k to $500k
72x dolphin 2x_dolphinaccount value $100k to $250k
8dolphinaccount value $50k to $100k
92x fish 2x_fishaccount value $25k to $50k
10fishaccount value $10k to $25k
112x shrimp 2x_shrimpaccount value $1k to $10k
12shrimpaccount value under $1k
unknownaccount value not known for that hour (only an hour rebuilt from fills has it)

unknown: the wallet's account value is not known for that hour: the hour was rebuilt from the fill stream after a snapshot gap, which recovers positions but not the cash behind them, and the wallet was not in the real snapshot the rebuild started from. Only stored hours carry it (cohort-metrics with axis=size); the live snapshot knows every wallet's account value, so it is not a filter value. Keep its rows: a coin's ladder sums to its total only with them.

Realized PnL rank axis=pnl13 buckets

The percentile of the wallet's cumulative realized PnL among ranked wallets; 0% is the best.

13x smart 3x_smartthe top 1% of traders by cumulative realized PnL (10+ closed trades)
22x smart 2x_smarttraders ranked 1% to 5% from the top by cumulative realized PnL (10+ closed trades)
3smarttraders ranked 5% to 10% from the top by cumulative realized PnL (10+ closed trades)
43x winner 3x_winnertraders ranked 10% to 20% from the top by cumulative realized PnL (10+ closed trades)
52x winner 2x_winnertraders ranked 20% to 30% from the top by cumulative realized PnL (10+ closed trades)
6winnertraders ranked 30% to 40% from the top by cumulative realized PnL (10+ closed trades)
7losertraders ranked 40% to 60% from the top by cumulative realized PnL (10+ closed trades)
82x loser 2x_losertraders ranked 60% to 70% from the top by cumulative realized PnL (10+ closed trades)
93x loser 3x_losertraders ranked 70% to 80% from the top by cumulative realized PnL (10+ closed trades)
10rekttraders ranked 80% to 90% from the top by cumulative realized PnL (10+ closed trades)
112x rekt 2x_rekttraders ranked 90% to 95% from the top by cumulative realized PnL (10+ closed trades)
123x rekt 3x_rektthe bottom 5% of traders by cumulative realized PnL (10+ closed trades)
unknownwallets with fewer than 10 closed trades, too few to rank by realized PnL

Stable in population: the top rung is always the top 1% of ranked wallets.

Realized PnL in dollars axis=pnl_abs9 buckets

The same cumulative realized PnL, banded in dollars; bounds are [min, max).

1$1m+ 1m_plusrealized PnL $1M or more
2$100k-$1m 100k_to_1mrealized PnL $100k to $1M
3$10k-$100k 10k_to_100krealized PnL $10k to $100k
4$0-$10k 0_to_10krealized PnL $0 to $10k
5-$10k-$0 neg10k_to_0realized PnL −$10k to $0
6-$100k--$10k neg100k_to_neg10krealized PnL −$100k to −$10k
7-$1m--$100k neg1m_to_neg100krealized PnL −$1M to −$100k
8<-$1m below_neg1mrealized PnL under −$1M
unknownnot in the realized-PnL record yet

Stable in meaning: $1M is $1M in any month.

Position size axis=tier10 buckets

One position's notional, not the wallet's: a small account can hold a large position at leverage.

1>$2.5m above_2_5mpositions of $2.5M or more
2$1m-$2.5m 1m_to_2_5mpositions of $1M to $2.5M
3$500k-$1m 500k_to_1mpositions of $500k to $1M
4$250k-$500k 250k_to_500kpositions of $250k to $500k
5$100k-$250k 100k_to_250kpositions of $100k to $250k
6$50k-$100k 50k_to_100kpositions of $50k to $100k
7$25k-$50k 25k_to_50kpositions of $25k to $50k
8$10k-$25k 10k_to_25kpositions of $10k to $25k
9$1k-$10k 1k_to_10kpositions of $1k to $10k
10<$1k below_1kpositions of under $1k

Ask for it as axis=tier on cohort-metrics, or read /symbols/{symbol}/size-breakdown.

Indices

Smart Money Index and Whale-vs-Shrimp Index

SMI is the long share of the smart rungs (3x smart, 2x smart, smart) minus that of the rekt rungs (rekt, 2x rekt, 3x rekt); WSI is the long share of the whale rungs (4x whale to whale) minus that of shrimp and 2x shrimp. Both run from −1 to +1.

SMI and WSI · /symbols/{symbol}/indices

GET/v1/hl-cohorts/symbols/BTC/indices?hours=24
Open this side to see the captured response.

    
Live

Every coin × every cohort: who leans long, who leans short

Each cohort's bias on each coin at the latest snapshot, on the size or the pnl ladder. An empty cell is blank, never 0.

Coin × cohort · /heatmap

GET/v1/hl-cohorts/heatmap?axis=size
Open this side to see the captured response.

    
Live

Large fills by cohort

The newest 20 fills of $50,000 or more on each coin, with the account-size and realized-PnL cohort of the wallet behind each.

BTC fills of $50,000 or more · /symbols/BTC/large-fills

GET/v1/hl-cohorts/symbols/BTC/large-fills?limit=20
Open this side to see the captured response.

    
One free key

Everything free on one key

REST, the WebSocket, alerts and webhooks, MCP, the CLI and the Parquet archive.

REST

11 routes under /v1/hl-cohorts

Every cohort, every coin, hourly or at the latest 5-minute snapshot, as JSON.

Every route →
WebSocket

4 live channels

Cohort flow, bias, leverage and the indices pushed as they are made, at wss://stream.vike.io/v1/stream/hl-cohorts.

  • hl.cohort_bias
  • hl.cohort_flow
  • hl.cohort_leverage
  • hl.indices
Subscribe →
Alerts and webhooks

3 no-code cohort alerts

By e-mail or to your webhook, made on your account page, by your AI or with the CLI.

  • hl_cohort_bias
  • hl_cohort_fill
  • hl_liquidation
Alerts →
MCP

Ask in Claude, ChatGPT or Cursor

Your AI picks the tool and answers with live numbers; hl_cohort_metrics 1 credit, hl_segments 1 credit a call.

  • hl_cohort_metrics
  • hl_segments
Connect →
CLI

vike-data on your terminal

The same data from a shell: npm install -g @vike-io/cli, then vike-data init.

  • vike-data hl cohort-metrics
  • vike-data hl segments
Commands →
Parquet archive

Every snapshot, labelled

The positions archive carries each row's size cohort and point-in-time PnL cohort, one file per UTC day.

  • positions
The archive →
Alert · hl_cohort_bias

A cohort index crosses your line

An index of one coin (smi, wsi, smart_bias, whale_bias, smi_wsi_gap) crosses your threshold: one e-mail or webhook per crossing, re-armed once it retreats by your band.

Alert · hl_cohort_fill

A cohort fills big

Every fill by wallets of the cohorts you pick, from $10,000 up.

Alert · hl_liquidation

A cohort gets liquidated

Every liquidation above your floor, of the cohorts you pick or of one coin.

Every route, channel, tool and alert in full: AI & API →

Datasets

The five HL Cohorts datasets

Fields, real rows from the API and the code to load each one.

HL Cohorts · API analytics

Cohort positioning

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.

Routes
/v1/hl-cohorts/segments/{cohort}/summary, /v1/hl-cohorts/segments/{cohort}/history
Built on
Position snapshots
MCP
hl_segments
Free APIArchiveStreamMCP

Real rows

Cohort positioning · rows

GET
Open this side to see the captured response.

    

Fields of /segments/{cohort}/summary

FieldTypeDescription
axisstringsize | pnl | pnl_abs
cohortstringThe API label, e.g. whale or 3x smart
opened_withinstringThe openedWithin window asked for: 24h | 7d | 30d | all
snapshot_tsstringThe 5-minute snapshot read, ISO-8601 UTC
total_long_usdnumberLong notional, USD
total_short_usdnumberShort notional, USD
biasnumber(long − short) / (long + short); null when the cohort holds nothing
n_walletsintegerWallets of the cohort with an open position
n_wallets_in_profitintegerOf those, the wallets whose open positions are in profit
pct_wallets_in_profitnumberShare of those wallets whose open positions are in profit, 0–1
n_positionsintegerOpen positions
total_unrealized_pnlnumberUnrealized PnL of the open positions, USD
equity_exposurenumber(long + short) / native perp equity of the counted wallets: leverage on equity
perp_biasnumber(long − short) / that equity
total_margin_usednumberMargin the open positions use, USD
exposure_rationumberNotional / margin used
total_equitynumberThe cohort's account value, USD
n_wallets_with_equityintegerWallets of the cohort with a non-zero account value
by_sideobjectlong and short: value_usd, share, n_positions, n_wallets, margin_used, unrealized_pnl

Fields of /segments/{cohort}/history (each row of series)

FieldTypeDescription
tsstringHour, ISO-8601 UTC, newest first
long_usdnumberLong notional, USD
short_usdnumberShort notional, USD
biasnumber(long − short) / (long + short)
position_countintegerOpen positions: (wallet, symbol) pairs

The envelope of /segments/{cohort}/history

FieldTypeDescription
axisstringsize | pnl
cohortstringThe API label
label_basisstringpoint_in_time on both axes
data_fromstringThe first hour served, ISO-8601 UTC
seriesarrayThe rows above, newest first
has_morebooleanOlder hours exist beyond limit
label_computedobjectOn axis=pnl: when the labels were computed
leverageobjectWith include=leverage: data_from, scope and note (hours rebuilt from fills are null)

Load it

GET /v1/hl-cohorts/segments/{cohort}/summary · What one cohort holds now

CLI
—
MCP
hl_segments · 1 credit
Cost
1 credit, one request of the hourly limit

Aggregate positioning for one cohort at the latest snapshot.

perp_bias = (long - short) / equity and equity_exposure = (long + short) / equity: positions on the main dex over the equity of the wallets holding them, each wallet counted once: the native perp account value, plus for a unified or portfolio-margin wallet the USDC it holds outside it (its margin draws on it; the native account alone is about margin-sized). Builder-DEX positions and accounts are not included, and wallets without a known positive equity are left out of perp_bias, equity_exposure and the numerator of equity_covered_share (main-dex notional of the counted wallets / main-dex notional of the whole cohort). Unbounded ratios (above 1 = more than 1x of equity), null when that equity <= 0. That equity is not total_equity, so perp_bias x total_equity is not total_long_usd - total_short_usd. Under openedWithin long/short are the qualifying positions and the equity the whole native account of every wallet holding one. exposure_ratio stays notional / margin used.

Parameters

ParameterInDescription
cohortrequiredpathA label or slug from /cohorts / /segments
axisquerysize | pnl | pnl_abs. Default size. Per-wallet ladders only — trade_size is per-position and is rejected here; see the groupable field on /segments.
openedWithinquery24h | 7d | 30d | all. Default all

Call it

bash
curl -H "X-API-KEY: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hl-cohorts/segments/whale/summary?axis=size"

GET /v1/hl-cohorts/segments/{cohort}/history · One cohort, hour by hour

CLI
—
MCP
hl_segments · 1 credit
Cost
1 credit, one request of the hourly limit

One cohort's long / short / bias per hour, summed over every symbol. Ratios in [-1, +1]. A 404 names the axis only. axis=size groups positions by the size cohort stored on each position; axis=pnl by the realized-PnL cohort frozen at that hour (hourly from 2026-08-06, daily before it; see label_computed). Per hour: long_usd and short_usd in USD, bias = (long - short) / (long + short), null when both are 0, and position_count, which counts open positions ((wallet, symbol) pairs), not wallets. Newest first, settled hours only. include=leverage adds the three equity ratios described on that parameter. Data from 2026-04-07 (the first hour cohort labels are correct): an older start is served from there, and the envelope says data_from.

Parameters

ParameterInDescription
cohortrequiredpathA label or slug of axis, from /cohorts / /segments
axisrequiredquerysize | pnl: this endpoint serves history for these two only. Required.
startqueryISO-8601 UTC. Oldest edge. Omit it for the hours newest hours.
endqueryISO-8601 UTC. Newest edge; with no start, the window is the hours newest hours at or before it.
hoursqueryWindow length in hours when start is omitted. Default 168, max 8760.
limitqueryMax rows, newest first, default and max 5000; has_more says there are older ones (page back with end = the oldest ts minus 1 second; end is inclusive).
includequeryComma list; only leverage, default none (nothing extra is read). Adds to every row perp_bias = (long - short) / equity, equity_exposure = (long + short) / equity and equity_covered_share = main-dex notional of the counted wallets / main-dex notional of the whole cohort: unbounded ratios (above 1 = more than 1x of equity), main-dex positions of wallets with a known positive equity, each wallet once, over that equity: the native perp account, plus from the 2026-11-07 20:00 UTC hour on the USDC a unified or portfolio-margin wallet holds outside it (earlier hours stay native, so the two ratios step down there); builder-DEX positions are not included. An hour with no stored row, and any hour before leverage.data_from (2026-08-11), is null on all three (never 0). perp_bias and equity_exposure are also null when no counted wallet has a positive equity; equity_covered_share is null when the cohort holds no main-dex notional and a real 0 when it holds some but no wallet is counted. Hours rebuilt from fills rather than read from snapshots are null. An unknown token is a 400.

Call it

bash
curl -H "X-API-KEY: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hl-cohorts/segments/3x_smart/history?axis=pnl&hours=168"
HL Cohorts · API analytics

Cohort heatmap

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.

Routes
/v1/hl-cohorts/heatmap
Built on
Position snapshots
MCP
hl_segments
Free APIArchiveStreamMCP

Real rows

Cohort heatmap · rows

GET
Open this side to see the captured response.

    

Fields of /heatmap (each row of heatmap)

FieldTypeDescription
symbolstringThe coin
total_valuenumberOpen notional, USD
total_long_valuenumberLong notional, USD
total_short_valuenumberShort notional, USD
biasnumber(long − short) / (long + short)
countintegerOpen positions
count_longinteger…of which long
count_shortinteger…of which short
n_walletsintegerWallets holding the coin
segmentsarrayOne cell per cohort: cohort, rank, the same values, share_of_symbol; an empty cell is left out, never 0

The envelope of /heatmap

FieldTypeDescription
axisstringsize | pnl | pnl_abs
opened_withinstringThe openedWithin window asked for: 24h | 7d | 30d | all
snapshot_tsstringThe 5-minute snapshot read, ISO-8601 UTC
sourcestringWhere the board was read: the latest position snapshot
totalsobjectThe whole board: total_value, total_long_value, total_short_value, bias, count, n_symbols (coins on the board), n_wallets and n_wallets_source
heatmaparrayThe coin rows above

Load it

GET /v1/hl-cohorts/heatmap · Every coin x every cohort, now

CLI
—
MCP
hl_segments · 1 credit
Cost
1 credit, one request of the hourly limit

Coin x cohort positioning matrix — the whole board in one call.

Parameters

ParameterInDescription
axisquerysize | pnl | pnl_abs. Default size. Per-wallet ladders only — trade_size is per-position and is rejected here; see the groupable field on /segments.
openedWithinquery24h | 7d | 30d | all. Default all

Call it

bash
curl -H "X-API-KEY: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hl-cohorts/heatmap?axis=size"
HL Cohorts · API analytics

Large fills

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.

Routes
/v1/hl-cohorts/symbols/{symbol}/large-fills
Built on
Fills, Position snapshots
MCP
hl_market
Free APIArchiveStreamMCP

Real rows

Large fills · rows

GET
Open this side to see the captured response.

    

Fields of /symbols/{symbol}/large-fills (each row of fills)

FieldTypeDescription
tsstringFill time, ISO-8601 UTC
walletstringThe wallet
directionstringbuy | sell
size_usdnumberNotional, USD
size_tokennumberSize in coin units
pricenumberFill price
order_typestringmarket (crossed the book) | limit (rested)
size_cohortstringThe wallet's account-size cohort
pnl_cohortstringThe wallet's realized-PnL cohort
pnl_cohort_basisstringpoint_in_time (graded at the fill's hour) | current

Load it

GET /v1/hl-cohorts/symbols/{symbol}/large-fills · A coin's large fills, newest first

CLI
—
MCP
hl_market · 1 credit
Cost
1 credit, one request of the hourly limit

The asset page's Whale Activity feed: a symbol's large fills, newest first. The feed keeps only the newest 200 fills over $50k per symbol of the last 24 hours, so on a busy symbol that is minutes, not a day: covered_from is how far back the answer reaches, truncated says that cap may have cut older fills inside the window, has_more that limit cut rows. Each row has ts, wallet, direction (buy | sell), size_token, size_usd, price, order_type (market = crossed the book, limit = rested), size_cohort (the wallet's size rung on its latest snapshot) and pnl_cohort (graded at the fill's own hour where that hour is labelled, else today; pnl_cohort_basis says which). Liquidations are not flagged.

Parameters

ParameterInDescription
symbolrequiredpathHL ticker
min_usdquerySmallest fill in USD. Default and MINIMUM 50000: the feed behind this route holds nothing smaller.
hoursqueryHow far back, in hours. Default and max 24: the feed holds a day.
limitqueryMax rows, newest first. Default 200 (all the feed holds per symbol), max 1000; has_more says a lower limit cut rows.

Call it

bash
curl -H "X-API-KEY: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hl-cohorts/symbols/BTC/large-fills?limit=20"
HL Cohorts · API dataset · hourly

Cohort metrics

One coin's positioning across every cohort of a ladder, hourly — all history since April 2026 in one request.

Route
/v1/hl-cohorts/symbols/{symbol}/cohort-metrics
Cadence
Hourly buckets
Coverage
One coin, every cohort on an axis (size, tier, pnl, pnl_abs, pnl_unrealized), hourly from 2026-04-07, all of it in one request, paged by hour. axis=size, axis=tier and axis=pnl_unrealized 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.
Rows
MCP
hl_cohort_metrics
Free APIArchiveStreamMCP

Real rows

Cohort metrics · rows

GET
Open this side to see the captured response.

    

Fields

FieldTypeDescription
tsstringHour bucket, ISO-8601 UTC
cohortstringRung on the chosen axis, e.g. whale, 3x smart, $1m-$2.5m
position_countintegerOpen positions in the cohort
position_count_longinteger…of which long
n_walletsintegerWallets in the cohort holding the coin that hour, on every axis and grading (a wallet holds one position per coin, so it equals position_count wherever that is not null)
total_position_valuenumberNotional, USD
total_position_value_longnumberLong notional, USD
total_unrealized_pnlnumberUnrealized PnL, USD
total_position_sizenumberSize in coin units
total_position_size_longnumberLong size in coin units
biasnumber(long − short) / (long + short), by notional
label_basisstringpoint_in_time | current — the basis actually used
gradingstringOn axis=pnl rows: which PnL grading labelled the wallet (realized by default)

Load it

bash
curl -H "X-API-KEY: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hl-cohorts/symbols/BTC/cohort-metrics?axis=size&hours=1"
symbol
axis
labelBasis
GET/v1/hl-cohorts/symbols/{symbol}/cohort-metrics?axis={axis}&hours=1&labelBasis={labelBasis}

    
Press Send ▶ — the captured response appears here

    

GET /v1/hl-cohorts/symbols/{symbol}/cohort-metrics · One coin, every cohort, hourly

CLI
—
MCP
hl_cohort_metrics · 1 credit
Cost
1 credit, one request of the hourly limit

The full cohort matrix for one coin — every bucket on an axis, hourly.

Data from 2026-04-07 (the first hour cohort labels are correct), on every axis: an older start is served from there (never a 400), paging stops there, and the envelope says data_from. Every row carries n_wallets, the wallets in the cohort holding the coin that hour.

/symbols/{symbol}/metrics returns one row per hour, either all cohorts summed or a single cohort. Rebuilding the matrix from it costs one request per cohort (12 for size, 13 for pnl); this returns all of them in one.

axis=tier is the PER-POSITION ladder — each position row's own notional bucket, DERIVED from the row's size_usd: the canonical ten dollar-range buckets, largest first, the website's spellings verbatim (>$2.5m, $1m-$2.5m, $500k-$1m, $250k-$500k, $100k-$250k, $50k-$100k, $25k-$50k, $10k-$25k, $1k-$10k, <$1k — /cohorts and /segments publish the ladder with bounds). Rows have the same shape as axis=size, the bucket in the cohort field. It is a grouping only here: this endpoint aggregates position rows, so each row sits in exactly one bucket, while the per-wallet endpoints (/heatmap, /segments/{cohort}/summary) keep rejecting it — a wallet straddles buckets. (The retired micro/small/medium/large/mega vocabulary is gone; sending one of those as a cohort filter anywhere returns a 400 naming this ladder.)

Paginated by HOUR, not by row — a row limit would cut a bucket in half and return an hour whose cohorts do not sum to its total. hours bounds the buckets; every cohort in a returned bucket comes with it.

No provisional row: this is bulk history, and a partial hour inside a matrix that will be differenced or z-scored produces a fake move at the right edge. Use /symbols/{symbol}/metrics for the current value.

include=volume,median_pnl adds two per-cohort columns to the rows of the newest bucket, volume_24h_usd and median_realized_pnl_usd (size and pnl only; see the parameter). They are computed at request time, so they describe the book now, not the bucket's hour.

⚠️ labelBasis matters for research. By default the pnl cohort is resolved from the dictionary AT QUERY TIME, so a historical row carries TODAY's grading — correct for "who is smart right now", lookahead for a backtest, because a wallet under the 10-closed-trade floor back then may be graded now. Pass labelBasis=point_in_time to get each row's label as it was that hour. Every field is served (unavailable_fields is empty) while each hour of the window carries that label on its rows: every hour from 2026-08-06 09:00 UTC, and most earlier ones. A window that reaches an hour without it (all of April 2026, about 365 hours from May to 2026-08-06 08:00) is served as one aggregate for all of its hours, and its position_count, position_count_long, total_unrealized_pnl, total_position_size and total_position_size_long are null (listed in unavailable_fields); so are those five fields under grading=unrealized and grading=realized-pit. Point-in-time matrices are stored aggregates and refuse openedWithin (400).

axis=size is always point-in-time (a stored column), axis=tier is always point-in-time (a pure function of the stored size_usd), axis=pnl_unrealized is always point-in-time (the HOURLY rollup stores it, see below) and axis=pnl_abs is always current (no frozen source exists); all four reject a conflicting labelBasis rather than silently ignoring it. Every row and the envelope carry label_basis so the answer is self-describing.

⚠️ grading selects WHICH PnL grading; label_computed says WHEN it was computed. The two are independent and the response carries both, on the envelope and on every row. A grading name is neutral by design — realized does not say whether the label is today's or the hour's — so the endpoint refuses to let the name travel alone.

* grading=realized (default on axis=pnl) — the percentile ladder over cumulative realized PnL. With the default labelBasis this is resolved at QUERY time, so every historical hour carries TODAY's grading: label_computed.lookahead is true and says so. With labelBasis=point_in_time it is the frozen ladder, and label_computed names the 2026-08-06 seam — before it the labels come from the 2026-08-17 point-in-time rebuild (daily resolution), from it they come from the row's own pnl_cohort_realized (hourly). Both halves are honest; a series crossing the seam changes label RESOLUTION, which a turnover count will read as a regime change that is an artefact. * grading=realized-pit — the same ladder graded point-in-time across the WHOLE window (day D on the cumulative as of the end of D-1), which is what makes it the control for a study crossing that seam. Rebuilt once a DAY: it is extended just after 00:00 UTC through 23:00 of the last complete UTC day, so a window reaching the present comes back 1 to 25 hours short rather than wrong. * grading=unrealized — "currently onside": hour H's rank over the wallet's last snapshot strictly before H. axis=pnl_unrealized is the legacy spelling of exactly this and keeps working; both reach one branch.

grading is refused on size, tier and pnl_abs, which rank no PnL, and realized-pit/unrealized refuse labelBasis=current rather than silently overriding it.

⚠️ freshness is how a REALTIME caller checks it is not trading a stale book. On any window that reaches the present the envelope carries {newest_ts, behind_hours, settled_lag_ceiling_hours, stale}. stale is the pre-computed verdict, so a consumer does not have to re-derive the rollup's cadence — the rollup writes hour H at H+1:00–H+1:30, so a bucket up to two hours old is healthy and the ceiling sits an hour above that.

It exists because prose was not enough. grading=realized-pit reads a table rebuilt once a DAY; ask it the way a poller does (?grading=realized-pit&hours=1, no start) and it returns its own newest bucket — identical in shape to a current one, and hours old. That gap is not a constant: the newest hour is 23:00 of the last complete UTC day, so it runs from 1 to 25 hours over each day and stale is true for most of it. Read the age off freshness.behind_hours rather than from any number written in prose.

For live trading use grading=realized with labelBasis=point_in_time: honest labels, and one hour behind the clock rather than up to a day.

A window that ends in the PAST gets no freshness — "the newest bar is four months old" answers a question a historical query did not ask, and would make every backtest fetch look broken.

axis=pnl_unrealized grades positioning, not skill. Each wallet is ranked by the unrealized PnL of its open positions as a share of account value — "currently onside" — over its last snapshot STRICTLY BEFORE hour H, and that rank labels hour H. The grading turns over ~44% of wallets per day (the realized ladder: ~2.4%), which is the point: it is a different axis, not a re-spelling. Twelve rungs, no unknown (eligibility is a positive-equity snapshot, not a trade count), the same five null fields as a point-in-time pnl window served as one aggregate. Account values read zero from 2026-06-26 07:04 to 2026-06-30 06:31 UTC. For 2026-06-26 13:00 to 2026-06-30 06:00 UTC the share is taken of the wallet's last positive account value since 2026-06-23 07:00, and for 2026-04-13 15:00 and 2026-04-16 04:00 to 08:00 UTC of its last positive value in the 72 hours before the hour. These hours rank a different set of wallets, so cohort totals can step at their edges. On 2026-04-25 09:00 to 19:00 and 2026-05-02 09:00 to 11:00 UTC most wallets' unrealized PnL reads 0, so the rung within those hours is arbitrary.

Parameters

ParameterInDescription
symbolrequiredpathHL ticker
axisquerysize | pnl | pnl_abs | tier | pnl_unrealized. Default size. trade_size (the name /segments gives the ladder) is accepted as an alias of tier; the response still says axis: tier
startqueryISO-8601 UTC. Oldest edge of the window. Omit it and the window is the hours newest hourly buckets at or before end.
endqueryISO-8601 UTC. Newest edge. With no start: the hours newest hourly buckets at or before end, the same buckets as start = end - hours. A bucket counts when its hour starts at or before end, so an end exactly on the hour includes that hour's bucket. An end at or after the newest data (a future one included) is the same as no end; one older than all data returns an empty series.
openedWithinquery24h | 7d | 30d | all. Default all. Refused (400) with axis=pnl and labelBasis=point_in_time, with grading=unrealized or realized-pit and with axis=pnl_unrealized: those matrices are stored aggregates with position age summed away. Use axis=size, tier, pnl_abs or pnl with the default basis.
hoursqueryNumber of hourly buckets. Default 168, max 8760. Sizes the window when start is omitted; with start, it caps how many buckets come back (newest first).
cursorqueryCursor over hours
gradingqueryrealized | realized-pit | unrealized. Which PnL grading labels each wallet, for the axes that carry one (axis=pnl, axis=pnl_unrealized). Default realized on axis=pnl; refused on size, tier, pnl_abs. Every response declares in label_computed WHEN the label was computed — the grading name alone cannot say it.
labelBasisquerycurrent | point_in_time. Default depends on the axis: size, tier and pnl_unrealized are always point_in_time, pnl_abs always current. point_in_time (axis=pnl) returns each row's cohort label AS IT WAS that hour. Every field is served while each hour of the window carries that label on its rows (every hour from 2026-08-06 09:00 UTC, and most earlier ones); a window reaching an hour without it (all of April 2026, about 365 hours from May to 2026-08-06 08:00) is served as one aggregate whose five position fields are null (listed in unavailable_fields). Use it for backtests. Refused (400) with openedWithin.
includequeryComma list of volume and median_pnl; default none (nothing extra is read). Adds to every row of the NEWEST bucket volume_24h_usd (USD the cohort's wallets filled in this symbol over the last 24 hours; on axis=size only wallets holding the symbol now count; null when they filled nothing or the cohort is empty) and/or median_realized_pnl_usd (median cumulative realized PnL, USD, over the DISTINCT wallets holding the symbol now; null when none does). The median is a sampled quantile: exact up to 8,192 wallets in a cohort, an estimate above it. The asset page's pnl-axis "Med Lifetime" counts positions rather than wallets, so it can differ slightly. Both are CURRENT figures (request time, newest 5-minute snapshot), not the bucket hour's, and null on unknown. axis=size and axis=pnl with grading=realized only; refused (400) on any other axis or grading, with openedWithin, with cursor and with an end in the past.

Call it

bash
curl -H "X-API-KEY: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hl-cohorts/symbols/BTC/cohort-metrics?axis=size&hours=24"
HL Cohorts · API analytics

Symbol cohort series

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.

Routes
/v1/hl-cohorts/symbols/{symbol}/metrics, /v1/hl-cohorts/symbols/{symbol}/size-breakdown, /v1/hl-cohorts/symbols/{symbol}/indices
Built on
Position snapshots
MCP
hl_market
Free APIArchiveStreamMCP

Real rows

Symbol cohort series · rows

GET
Open this side to see the captured response.

    

Fields of /symbols/{symbol}/metrics, /indices and /size-breakdown

FieldTypeDescription
tsstring/metrics: the hour; /indices: the hour or the latest snapshot
symbolstring/indices: the coin as stored, whatever case was sent (btc → BTC, kpepe → kPEPE)
total_position_valuenumber/metrics, /size-breakdown: open notional, USD
total_position_value_longnumber…of which long, USD
position_countintegerOpen positions
biasnumber(long − short) / (long + short)
provisionalboolean/metrics: true on the newest, still-moving hour
sminumber/indices: Smart Money Index, −1 to +1
wsinumber/indices: Whale-vs-Shrimp Index, −1 to +1
whale_biasnumber/indices latest: bias of the whale rungs
smart_biasnumber/indices latest: bias of the smart rungs
tierstring/size-breakdown: the position-size bucket
min_sizenumber/size-breakdown: the bucket's lower bound, USD
max_sizenumber/size-breakdown: its upper bound, USD; null on the largest bucket
value_close_to_liquidationnumber/size-breakdown: notional near liquidation, USD

Load it

GET /v1/hl-cohorts/symbols/{symbol}/metrics · One coin, hourly, all cohorts or one

CLI
—
MCP
—
Cost
1 credit, one request of the hourly limit

Hourly open-interest / position-count / bias series for one coin, optionally sliced to a single cohort.

Hourly by construction: the 5-minute snapshot table summed into hour buckets over-counts open interest ~12x, which is what forced the previous cohort aggregate to be rebuilt.

Every row carries provisional. It is True on at most one row — the newest, covering the hour still in progress — because the hourly rollup lands 60-120 minutes late and a "current positioning" read would otherwise be silently that stale. Its ts is a snapshot instant rather than an hour boundary and it changes on every poll; drop it when persisting a series. Present only on the first page of a window reaching the present.

With a cohort: data from 2026-04-07 (the first hour cohort labels are correct); an older start is served from there and the envelope says data_from. Without one (all cohorts combined) the series does not depend on any label and keeps its whole history.

Parameters

ParameterInDescription
symbolrequiredpathHL ticker
startqueryISO-8601 UTC. Oldest edge of the window. Omit it and the window is the limit newest hourly rows at or before end.
endqueryISO-8601 UTC. Newest edge. With no start: the limit newest hourly rows at or before end, the same rows as start = end - limit hours. A row counts when its hour starts at or before end, so an end exactly on the hour includes that hour. An end at or after the newest data (a future one included) is the same as no end; one older than all data returns no rows.
axisquerysize | pnl | pnl_abs. Omit for all cohorts combined
cohortqueryOne label on that axis
openedWithinquery24h | 7d | 30d | all. Default all. Rolling per bucket, not relative to now — each hour counts positions opened in the window before THAT hour.
limitqueryDefault 500, max 5000. One row per hour, so also the window length in hours when start is omitted
cursorqueryKeyset cursor
labelBasisquerycurrent only. This endpoint resolves the cohort label from the wallet dictionary at QUERY time, so on the pnl ladders it can only serve current, and it REFUSES point_in_time by name instead of ignoring it. Every response declares label_basis and, for a pnl axis, label_computed.lookahead.

Call it

bash
curl -H "X-API-KEY: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hl-cohorts/symbols/BTC/metrics?limit=24"

GET /v1/hl-cohorts/symbols/{symbol}/size-breakdown · One coin by position size

CLI
—
MCP
hl_market · 1 credit
Cost
1 credit, one request of the hourly limit

Positioning split by canonical position-size bucket for one coin.

Ten dollar-range buckets (largest first), derived from each row's size_usd — the same ladder, spellings and bounds as axis=tier on /symbols/{symbol}/cohort-metrics and the /cohorts catalogue. Empty buckets come back zero-filled so the table shape is stable.

Parameters

ParameterInDescription
symbolrequiredpathHL ticker

Call it

bash
curl -H "X-API-KEY: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hl-cohorts/symbols/BTC/size-breakdown"

GET /v1/hl-cohorts/symbols/{symbol}/indices · Smart Money and Whale-vs-Shrimp indices

CLI
—
MCP
hl_market · 1 credit
Cost
1 credit, one request of the hourly limit

Smart Money Index, Whale-vs-Shrimp Index, whale / smart bias: the website's numbers as RATIOS in [-1, +1] (the site multiplies by 100). latest is the newest 5-minute snapshot (its pnl rungs graded by today's PnL grading, latest.label_basis: current), series the settled hourly rows, newest first. smi = long share of the 3x smart / 2x smart / smart wallets minus long share of the rekt / 2x rekt / 3x rekt wallets; wsi = long share of the 4x whale .. whale wallets minus long share of the 2x shrimp / shrimp wallets; whale_bias and smart_bias (latest only) = (long - short) / (long + short) over those whale / smart wallets. A value is null, never 0, when a cohort holds no positions. series: data from 2026-04-07 (the first hour cohort labels are correct); an older start is served from there, and the envelope says data_from.

Parameters

ParameterInDescription
symbolrequiredpathHL ticker
startqueryISO-8601 UTC. Oldest edge. Omit it for the hours newest hours.
endqueryISO-8601 UTC. Newest edge; with no start, the window is the hours newest hours at or before it.
hoursqueryWindow length in hours when start is omitted. Default 168, max 8760.
limitqueryMax series rows, newest first, default and max 5000; has_more says there are older ones (page back with end = the oldest ts minus 1 second; end is inclusive).

Call it

bash
curl -H "X-API-KEY: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hl-cohorts/symbols/BTC/indices?hours=24"
34 studies

Questions about Hyperliquid cohorts, answered with code

Each with the sentence to ask your AI instead, and a measured finding where there is one. Every block was run against the live API on 2026-11-04.

  1. Are Hyperliquid whales long or short BTC right now?
  2. What are profitable Hyperliquid traders doing on a coin?
  3. How are crypto speculators positioned? A Commitments-of-Traders view for crypto
  4. Whales vs retail: alert when their positioning diverges
  5. Do whales rotate between BTC, ETH and HYPE? (cross-asset cohort drift)
  6. When funding spikes, how do whale and retail cohorts split?
  7. Feed Hyperliquid cohort bias into a trading bot as an external signal
  8. Most crowded trade on Hyperliquid (cohort × coin heatmap)
  9. Rank every Hyperliquid coin by smart-money conviction and liquidation risk
  10. Build a Hyperliquid fear-and-greed gauge from the Smart Money and Whale-vs-Shrimp indices
  11. Smart-money (top-PnL cohort) long/short on a coin
  12. What does "whale" or "3x smart" mean? Cohort bounds
  13. What one cohort holds right now
  14. How many wallets are in each tier (wallet and PnL distribution)
  15. Long/short bias history of a cohort over time
  16. How leveraged are whales compared with shrimp over time?
  17. Threshold alert: a cohort is more than 70% long a coin
  18. Show whale fills above $100k on a Hyperliquid coin in the last hour, with each buyer's cohort
  19. Which coins have one-sided whale flow right now?
  20. Are Hyperliquid whales taking or making? Market versus limit share of large fills
  21. Alert on any single Hyperliquid fill over $1M
  22. Did cohort leverage rise before the last liquidation cascade?
  23. Daily 60-second Hyperliquid brief (cohorts + liquidations + movers)
  24. Alert me when smart money and whales disagree on a coin
  25. Which coin do smart wallets like and rekt wallets hate?
  26. Is notional bias or equity-adjusted bias the better signal?
  27. Did cohort positioning predict price? A backtest on labels as they were · Backtests
  28. Fade the losing cohort: mean reversion on extreme bias · Backtests
  29. Smart Money Index versus price: does it lead? · Backtests
  30. Are Whale-vs-Shrimp extremes a contrarian signal? · Backtests
  31. Hyperliquid net flow by cohort, hour by hour · Backtests
  32. Backtest following smart money with point-in-time cohort labels from the positions archive · Backtests
  33. Do smart-money wallets' large fills precede price moves? · Backtests
  34. How do I check Hyperliquid cohort data is fresh before I trade on it? · AI & API
HL Cohorts · API

Are Hyperliquid whales long or short BTC right now?

See how Hyperliquid accounts of $1m and up lean on BTC in the newest settled hour: each of the four whale rungs carries a bias from -1 (all short) to +1 (all long).

Uses
/symbols/{…}/cohort-metrics, /symbols/{…}/indices
Verified
live API, 2026-11-04: 4 calls, all 200
Free APIArchiveStreamMCP
Measured 2026-11-04: In the 06:00 UTC hour the four whale rungs ($1m and up) held $740M long and $1,014M short BTC, a bias of -0.16. They did not agree: the $10m-and-up rung was -0.62 on $914M, the three smaller rungs leaned long (+0.16 to +0.52). Over the 24 hours before, the whale bias stayed between -0.21 and -0.14.
Ask your AI agent: “Are Hyperliquid whales long or short BTC right now?”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# BTC positioning by account-value cohort, newest settled hour
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/symbols/BTC/cohort-metrics?axis=size&hours=1",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

What are profitable Hyperliquid traders doing on a coin?

Read the coin's realized-PnL cohort matrix; the 3x smart, 2x smart and smart rows show how the top 10% of wallets by lifetime realized PnL are positioned and how much they traded in 24 hours.

Uses
/symbols/{…}/cohort-metrics, /symbols/{…}/indices
Verified
live API, 2026-11-04: 4 calls, all 200
Free APIArchiveStreamMCP
Measured 2026-11-04: On HYPE in the 06:00 UTC hour the top 10% by realized PnL (3x smart, 2x smart, smart) held $591M long against $456M short, a bias of +0.13, and had filled $1.63B of HYPE in the 24 hours before; the bottom 20% (the three rekt rungs) leaned the other way, -0.35. HYPE's Smart Money Index at the 07:34 UTC snapshot: +0.24.
Ask your AI agent: “What are the most profitable Hyperliquid traders doing on HYPE right now?”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# HYPE by realized-PnL cohort, newest settled hour, with 24 h volume and median PnL
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/symbols/HYPE/cohort-metrics?axis=pnl&labelBasis=point_in_time&hours=1&include=volume,median_pnl",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

How are crypto speculators positioned? A Commitments-of-Traders view for crypto

Split one Hyperliquid market's open interest into long and short by account-size category with one call, then repeat it with an earlier end for the weekly change.

Uses
/segments/{…}/summary, /symbols/{…}/cohort-metrics
Verified
live API, 2026-11-04: 4 calls, all 200
Free APIArchiveStreamMCP
Ask your AI agent: “Show a Commitments-of-Traders style report for BTC on Hyperliquid: long and short by account size”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# BTC open interest by account-size category, long and short, newest settled hour
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/symbols/BTC/cohort-metrics?axis=size&hours=1",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

Whales vs retail: alert when their positioning diverges

Poll a coin's Whale-vs-Shrimp Index, the whales' long share minus the small accounts' long share, and alert when it crosses your threshold.

Uses
/symbols/{…}/cohort-metrics, /symbols/{…}/indices
Verified
live API, 2026-11-04: 4 calls, all 200
Free APIArchiveStreamMCP
Measured 2026-11-04: BTC's Whale-vs-Shrimp Index read -0.24 at 07:39 UTC. Over the last 90 days (2,160 hours) it ran from -0.40 (2026-11-03 06:00 UTC) to +0.40 (2026-08-19 20:00 UTC), median -0.10; an alert at -0.3 would have been past its line for 222 hours, one at +0.3 for 1.
Ask your AI agent: “Is the Whale-vs-Shrimp Index on BTC below -0.3 right now?”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# BTC whale-vs-shrimp divergence now, plus the last 24 settled hours
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/symbols/BTC/indices?hours=24",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

Do whales rotate between BTC, ETH and HYPE? (cross-asset cohort drift)

Pull the same 30 days of hourly size-cohort positioning for each coin, sum the whale rows per hour, and compare their long notional and bias across the three coins.

Uses
/heatmap, /symbols/{…}/cohort-metrics
Verified
live API, 2026-11-04: 6 calls, all 200
Free APIArchiveStreamMCP
Measured 2026-11-04: Over the 30 days to 06:00 UTC, the four whale rungs cut their long notional on BTC from $1,012M to $740M and on ETH from $1,247M to $865M, while HYPE barely moved ($597M to $572M): a cut on the two largest coins, not a rotation into HYPE. Their BTC bias went from -0.04 to -0.16.
Ask your AI agent: “Over the last 30 days, did Hyperliquid whales move long exposure from BTC to ETH or HYPE?”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# 30 days of hourly BTC positioning by account-size cohort
r1 = requests.get(
    "https://data.vike.io/v1/hl-cohorts/symbols/BTC/cohort-metrics?axis=size&hours=720",
    headers={"X-API-Key": API_KEY},
)

# the same 30 days for ETH
r2 = requests.get(
    "https://data.vike.io/v1/hl-cohorts/symbols/ETH/cohort-metrics?axis=size&hours=720",
    headers={"X-API-Key": API_KEY},
)

# the same 30 days for HYPE
r3 = requests.get(
    "https://data.vike.io/v1/hl-cohorts/symbols/HYPE/cohort-metrics?axis=size&hours=720",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

When funding spikes, how do whale and retail cohorts split?

Pull a coin's hourly funding rate and its hourly size-cohort matrix over the same window, join them on the hour, and compare whale and shrimp bias in the high-funding hours.

Uses
/symbols/{…}/cohort-metrics, /v1/hyperliquid/symbols/hourly
Verified
live API, 2026-11-04: 5 calls, all 200
Free APIArchiveStreamMCP
Ask your AI agent: “In the last 30 days, when BTC funding on Hyperliquid was highest, were whales or small accounts more long?”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# BTC hourly close, open interest and funding rate for 30 days
r1 = requests.get(
    "https://data.vike.io/v1/hyperliquid/symbols/hourly?symbols=BTC&days=30",
    headers={"X-API-Key": API_KEY},
)

# the same 720 hours of BTC positioning by account-size cohort
r2 = requests.get(
    "https://data.vike.io/v1/hl-cohorts/symbols/BTC/cohort-metrics?axis=size&hours=720",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

Feed Hyperliquid cohort bias into a trading bot as an external signal

Poll the newest settled hour of a coin's realized-PnL cohort matrix with point-in-time labels, and trade only when its freshness block says the hour is not stale.

Uses
/symbols/{…}/cohort-metrics, /symbols/{…}/indices
Verified
live API, 2026-11-04: 4 calls, all 200
Free APIArchiveStreamMCP
Ask your AI agent: “Is Hyperliquid's BTC smart-money data fresh, and how is the top 1% positioned?”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# BTC smart-money matrix for the newest settled hour, labels as they were at that hour
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/symbols/BTC/cohort-metrics?axis=pnl&labelBasis=point_in_time&hours=1",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

Most crowded trade on Hyperliquid (cohort × coin heatmap)

One call to the heatmap returns every coin split by every cohort at the newest snapshot; rank the cells by net notional or by bias times share to find the most crowded trade.

Uses
/heatmap
Verified
live API, 2026-11-04: 4 calls, all 200
Free APIArchiveStreamMCP
Measured 2026-11-04: At the 07:39 UTC snapshot the most crowded of 3,946 cells was 4x whale on BTC, $502M net short (bias -0.59, 27% of BTC's open notional), with 4x whale on ETH right behind: $501M net short at a bias of -0.98. The largest net long was 3x whale on ETH, $345M.
Ask your AI agent: “What is the most crowded trade on Hyperliquid right now, by cohort and coin?”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# every coin by account-size cohort at the newest snapshot
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/heatmap?axis=size",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

Rank every Hyperliquid coin by smart-money conviction and liquidation risk

Take smart-money bias per coin from the realized-PnL heatmap and the share of open interest near liquidation from the risk ranking, join them on symbol, and sort.

Uses
/heatmap, /symbols/{…}/indices, /v1/hyperliquid/liquidations/risk
Verified
live API, 2026-11-04: 6 calls, all 200
Free APIArchiveStreamMCP
Measured 2026-11-04: Of the 40 markets with $50M or more of open notional at the 07:39 UTC snapshot, the top 10% by realized PnL leaned most long on xyz:AAPL (+0.37) and most short on xyz:BRENTOIL (-0.53) and XRP (-0.43). The largest share near liquidation was xyz:CRCL's 24%, then HYPE's 14% of $1.87B.
Ask your AI agent: “Rank Hyperliquid coins over $50M of open interest by smart-money bias and share near liquidation”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# every coin by realized-PnL cohort at the newest snapshot
r1 = requests.get(
    "https://data.vike.io/v1/hl-cohorts/heatmap?axis=pnl",
    headers={"X-API-Key": API_KEY},
)

# every coin's share of open notional near liquidation, the most at risk first
r2 = requests.get(
    "https://data.vike.io/v1/hyperliquid/liquidations/risk?limit=500",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

Build a Hyperliquid fear-and-greed gauge from the Smart Money and Whale-vs-Shrimp indices

Read latest.smi and latest.wsi from /indices for the largest coins by open interest, average them and multiply by 100; the gauge runs from -100 to +100 and is yours to define, not a published index.

Uses
/symbols/{…}/indices, /v1/hyperliquid/positions/symbols
Verified
live API, 2026-11-04: 3 calls, all 200
Free APIArchiveStreamMCP
Measured 2026-11-04: Over the ten largest crypto perps by open notional (BTC, ETH, HYPE, ZEC, SOL, XRP, NEAR, XMR, LIT, PUMP) the gauge read -16.5 at 07:39 UTC and stayed negative all week: from -21.7 (2026-11-02 17:00 UTC) to -12.1 (2026-10-28 19:00 UTC).
Ask your AI agent: “Average the Smart Money Index and the Whale-vs-Shrimp Index over the ten largest Hyperliquid coins by open interest”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# BTC's two indices now; hours=1 keeps the hourly series to one row
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/symbols/BTC/indices?hours=1",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

Smart-money (top-PnL cohort) long/short on a coin

List the biggest open positions on one coin held by the 3x smart cohort (top 1% of wallets by realized PnL) with /v1/hyperliquid/positions?axis=pnl&cohort=3x_smart&sort=size.

Uses
/symbols/{…}/cohort-metrics, /v1/hyperliquid/positions
Verified
live API, 2026-11-04: 4 calls, all 200
Free APIArchiveStreamMCP
Ask your AI agent: “What are the biggest BTC positions held by 3x smart wallets on Hyperliquid right now, with their account value?”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the five biggest BTC positions of 3x smart wallets right now
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions?symbol=BTC&axis=pnl&cohort=3x_smart&sort=size&limit=5",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

What does "whale" or "3x smart" mean? Cohort bounds

The segments catalogue lists every cohort on every ladder with its bounds; a whale is an account worth $1m to $2.5m, and 3x smart is the top 1% of wallets by lifetime realized PnL.

Uses
/cohorts, /segments
Verified
live API, 2026-11-04: 4 calls, all 200
Free APIArchiveStreamMCP
Ask your AI agent: “What account size makes a Hyperliquid wallet a whale, and what is 3x smart?”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# every cohort on every ladder, with its bounds
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/segments",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

What one cohort holds right now

The cohort summary returns one cohort's long and short notional, bias, wallet and position counts, margin, equity and unrealized PnL across every coin at the newest snapshot.

Uses
/heatmap, /segments/{…}/summary
Verified
live API, 2026-11-04: 4 calls, all 200
Free APIArchiveStreamMCP
Ask your AI agent: “What do the top 1% of Hyperliquid traders by realized PnL hold right now?”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# what the top 1% by realized PnL hold right now, across every coin
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/segments/3x_smart/summary?axis=pnl",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

How many wallets are in each tier (wallet and PnL distribution)

Call the cohort summary once per tier and read n_wallets; it counts the wallets with at least one open position, and the heatmap's totals give the denominator.

Uses
/heatmap, /segments, /segments/{…}/summary
Verified
live API, 2026-11-04: 5 calls, all 200
Free APIArchiveStreamMCP
Ask your AI agent: “How many Hyperliquid wallets with open positions are in each account-size tier?”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# how many wallets in the smallest account tier hold an open position now
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/segments/shrimp/summary?axis=size",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

Long/short bias history of a cohort over time

One call returns a size or PnL cohort's long and short notional and bias (-1 to +1) for each hour, summed over all coins, newest first. Cohort labels are correct from 7 April 2026.

Uses
/segments/{…}/history
Verified
live API, 2026-11-04: 5 calls, all 200
Free APIArchiveStreamMCP
Ask your AI agent: “Show the hourly long/short bias of the Hyperliquid whale cohort over the last week”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the last week of whale positioning across the whole book, newest hour first
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/segments/whale/history?axis=size",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

How leveraged are whales compared with shrimp over time?

Add include=leverage to a cohort's hourly history: every hour from 2026-08-11 carries its notional over equity (equity_exposure), its net lean over equity (perp_bias) and the share of its book the two cover. One call for whale and one for shrimp set them side by side.

Uses
/segments/{…}/history, /segments/{…}/summary
Verified
live API, 2026-11-04: 6 calls, all 200
Free APIArchiveStreamMCP
Measured 2026-11-04: Over the last 90 days (about 1,980 hourly readings each), whales ($1m to $2.5m accounts) carried a median 5.3x notional over equity, between 4.5x and 6.3x; shrimp (under $1k) a median 5.9x, swinging from 2.5x to 8.7x. At 06:00 UTC: whales 5.2x, shrimp 5.7x.
Ask your AI agent: “Plot Hyperliquid whales' and shrimp's notional-to-equity ratio per hour since August 11”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the whale cohort's hourly leverage over the last 90 days
r1 = requests.get(
    "https://data.vike.io/v1/hl-cohorts/segments/whale/history?axis=size&include=leverage&hours=2160",
    headers={"X-API-Key": API_KEY},
)

# the shrimp cohort's hourly leverage over the same 90 days
r2 = requests.get(
    "https://data.vike.io/v1/hl-cohorts/segments/shrimp/history?axis=size&include=leverage&hours=2160",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

Threshold alert: a cohort is more than 70% long a coin

Poll the coin's metrics for one cohort, compute its long share from the newest row, and fire when it passes 0.70; the heatmap checks every coin at once.

Uses
/heatmap, /segments/{…}/summary, /symbols/{…}/metrics
Verified
live API, 2026-11-04: 4 calls, all 200
Free APIArchiveStreamMCP
Ask your AI agent: “Is the Hyperliquid whale cohort more than 70% long BTC right now?”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# whale positioning on BTC: the current hour first, then the settled ones
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/symbols/BTC/metrics?axis=size&cohort=whale&limit=2",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

Show whale fills above $100k on a Hyperliquid coin in the last hour, with each buyer's cohort

Ask the coin's large-fills feed for min_usd=100000 and hours=1; each fill carries the wallet, side, size, order type and the wallet's size and realized-PnL cohorts, and covered_from says how far back the answer reaches.

Uses
/symbols/{…}/large-fills
Verified
live API, 2026-11-04: 4 calls, all 200
Free APIArchiveStreamMCP
Ask your AI agent: “Show BTC fills over $100k on Hyperliquid in the last hour and the cohort of each buyer”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# BTC fills of $100k and more in the last hour, with each wallet's cohorts
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/symbols/BTC/large-fills?min_usd=100000&hours=1",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

Which coins have one-sided whale flow right now?

Call /large-fills?min_usd=100000&hours=2 per coin and net the taker rows (order_type market) by direction; netting every row gives zero, because both sides of each trade are in the feed.

Uses
/symbols/{…}/large-fills, /v1/hyperliquid/positions/symbols
Verified
live API, 2026-11-04: 3 calls, all 200
Free APIArchiveStreamMCP
Ask your AI agent: “For BTC, ETH and HYPE, net the taker side of fills over $100,000 in the last two hours and tell me which is most one-sided”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# HYPE fills of $100,000 or more from the last two hours
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/symbols/HYPE/large-fills?min_usd=100000&hours=2",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

Are Hyperliquid whales taking or making? Market versus limit share of large fills

Group a coin's /large-fills by size_cohort and order_type; a cohort's market share above 50% means it takes liquidity more than it provides, since every trade in the feed has one market and one limit side.

Uses
/symbols/{…}/large-fills
Verified
live API, 2026-11-04: 3 calls, all 200
Free APIArchiveStreamMCP
Ask your AI agent: “In ETH's recent fills over $50,000, what share of each whale rung's volume was taken at market?”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# every ETH fill over $50,000 the feed holds
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/symbols/ETH/large-fills",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

Alert on any single Hyperliquid fill over $1M

Poll /large-fills?min_usd=1000000 once a minute for each coin you watch, alert on rows you have not seen, and read covered_from, because an empty answer only covers the minutes the feed reaches back.

Uses
/symbols/{…}/large-fills
Verified
live API, 2026-11-04: 3 calls, all 200
Free APIArchiveStreamMCP
Ask your AI agent: “Is there a BTC, ETH or HYPE fill of $1M or more in Hyperliquid's large-fills feed right now, and how far back does the feed reach?”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# BTC fills of $1M or more still in the feed
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/symbols/BTC/large-fills?min_usd=1000000&limit=50",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

Did cohort leverage rise before the last liquidation cascade?

Find the hour of the drop, then read the cohort's hourly equity_exposure and perp_bias for the hours before it from /segments/{cohort}/history with include=leverage.

Uses
/segments/{…}/history, /v1/hyperliquid/liquidations, /v1/hyperliquid/ohlcv
Verified
live API, 2026-11-04: 5 calls, all 200
Free APIArchiveStreamMCP
Ask your AI agent: “Did Hyperliquid whales' leverage rise in the six hours before BTC dropped at 01:00 UTC on 2026-10-22?”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the whale cohort's hourly leverage over the six hours up to BTC's 01:00 UTC drop on 2026-10-22
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/segments/whale/history?axis=size&include=leverage&start=2026-10-21T19:00:00Z&end=2026-10-22T01:00:00Z",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

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.

Uses
/heatmap, /v1/hyperliquid/liquidations, /v1/hyperliquid/symbols/hourly
Verified
live API, 2026-11-04: 7 calls, all 200
Free APIArchiveStreamMCP
Ask your AI agent: “Give me a 60-second Hyperliquid brief: smart-money positioning, the last 24 hours of liquidations, and how BTC, ETH, SOL and HYPE moved”

The code

python
import os
from datetime import datetime, timedelta, timezone

import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# where each realized-PnL cohort leans on every coin, at the newest snapshot
r1 = requests.get(
    "https://data.vike.io/v1/hl-cohorts/heatmap?axis=pnl",
    headers={"X-API-Key": API_KEY},
)

# the last 24 hours of liquidations
SINCE = (datetime.now(timezone.utc) - timedelta(hours=24)).strftime("%Y-%m-%dT%H:%M:%SZ")  # 24 hours ago, UTC
r2 = requests.get(
    f"https://data.vike.io/v1/hyperliquid/liquidations?start={SINCE}&limit=5000",
    headers={"X-API-Key": API_KEY},
)

# one day of hourly closes for the coins you follow
r3 = requests.get(
    "https://data.vike.io/v1/hyperliquid/symbols/hourly?symbols=BTC,ETH,SOL,HYPE&days=1",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

Alert me when smart money and whales disagree on a coin

Poll /indices every 5 minutes and compare latest.smart_bias with latest.whale_bias; alert when their signs differ by more than your threshold, and skip a null, which means the cohort holds nothing on the coin.

Uses
/symbols/{…}/indices, /v1/hyperliquid/positions/symbols
Verified
live API, 2026-11-04: 3 calls, all 200
Free APIArchiveStreamMCP
Ask your AI agent: “On which of BTC, ETH, HYPE and SOL do Hyperliquid smart money and whales lean opposite ways right now?”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# HYPE's whale and smart bias at the newest snapshot
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/symbols/HYPE/indices?hours=1",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

Which coin do smart wallets like and rekt wallets hate?

Call /indices for each coin and rank by latest.smi, the long share of smart wallets minus the long share of rekt wallets; the top coin is where the two disagree most in the smart wallets' favour.

Uses
/symbols/{…}/cohort-metrics, /symbols/{…}/indices, /v1/hyperliquid/positions/symbols
Verified
live API, 2026-11-04: 4 calls, all 200
Free APIArchiveStreamMCP
Ask your AI agent: “Rank BTC, ETH, HYPE, SOL and ZEC by the Hyperliquid Smart Money Index right now”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# HYPE's indices at the newest snapshot
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/symbols/HYPE/indices?hours=1",
    headers={"X-API-Key": API_KEY},
)
HL Cohorts · API

Is notional bias or equity-adjusted bias the better signal?

One /segments/{cohort}/history call with include=leverage returns both bias (long minus short over notional) and perp_bias (long minus short over equity) per hour since 2026-08-11; score each against the forward return from /ohlcv.

Uses
/segments/{…}/history, /v1/hyperliquid/ohlcv
Verified
live API, 2026-11-04: 3 calls, all 200
Free APIArchiveStreamMCP
Ask your AI agent: “Give me the 3x smart cohort's hourly bias and perp_bias since 2026-08-11 so I can compare them with BTC's next-hour return”

The code

python
import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the 3x smart cohort's hourly bias and perp_bias since the equity ratios begin
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/segments/3x_smart/history?axis=pnl&include=leverage&start=2026-08-11T00:00:00Z",
    headers={"X-API-Key": API_KEY},
)
FAQ

Hyperliquid long/short ratio FAQ

What is the Hyperliquid long/short ratio?
The long notional of a coin's open positions divided by its short notional. Above 1, more money is long than short. This page also gives it per cohort, and as bias = (long − short) / (long + short), which runs from −1 (all short) to +1 (all long).
Are Hyperliquid whales long or short right now?
The board at the top of this page shows each cohort's bias on BTC, ETH, SOL and HYPE; pick the size ladder for whales. The same answer comes from GET /v1/hl-cohorts/symbols/BTC/cohort-metrics?axis=size&hours=1, or ask your AI: “Are Hyperliquid whales long or short BTC right now?”
What is the HYPE long/short ratio?
Pick HYPE on the board: its long and short notional, overall and per cohort, at the latest hour. GET /v1/hl-cohorts/symbols/HYPE/cohort-metrics?axis=size&hours=1 returns the same numbers.
Who is smart money on Hyperliquid?
Wallets ranked by cumulative realized PnL, with at least 10 closed trades: 3x smart is the top 1%, 2x smart the top 5%, smart the top 10%. The Smart Money Index is their long share minus the long share of the bottom three rungs (rekt, 2x rekt, 3x rekt), from −1 to +1.
What is a cohort?
A bucket of wallets on one ladder: account size (shrimp to 4x whale), the rank of realized PnL (3x smart to 3x rekt), realized PnL in dollars, or, for single positions, position size. Each cohort's long, short and bias are summed per coin and per hour.
How often does it update?
Open positions are read every 5 minutes. A cohort's summary, the heatmap and the indices' latest value are as of the newest snapshot; the hourly series settle after each hour. On this page the board and the heatmap are captured every 5 minutes, the cohort cards, indices and large fills every 15.
How far back does it go?
Cohort data starts on 7 April 2026: the first hour the labels are correct. One request returns all of it for a coin, hour by hour.
Can I backtest on it?
Yes, with labels as they were at each hour. How, and which ladders are safe: Backtests.
Is it free?
Yes. Sign in, create a key and send it as X-API-KEY: 20,000 requests an hour and 200 a minute per key, up to 3 keys, nothing billed. In Claude Desktop add https://data.vike.io/mcp as a connector and sign in: no key.