Hyperliquid Crowd, Smart Money & Liquidation Signals

Is a Hyperliquid perp crowded right now, how are Hyperliquid's most profitable traders positioned in it, and what historically happened next? One record per coin, refreshed hourly, from Annalist.

Built for trading bots, AI agents and research workflows that want context, not just raw prices.

What you get for each coin

Crowd state

• 7-day and 1-day move, 7-day average volume, days since listing
• Funding: hourly rate, APR, its percentile against the coin's own last 90 days and against all perps, and the 7-day funding percentile against the coin's own last year
• Open interest in USD, plus its 24-hour and 7-day change
• Premium to oracle price
• Wikipedia attention ratio for major coins
• Active crowd states: up_50pct_7d, up_100pct_7d, up_200pct_7d, funding_top5, funding_bottom5, attention_spike_3x, new_listing

Base rates for each active state: what happened after similar states on Hyperliquid's own history. Each comes with its sample size, the median and spread of 7/30/90-day returns, and the share of cases that ran up another 50–100% or fell 50%.

Smart-money positioning, from a cohort of Hyperliquid's most profitable directional traders:

• traders long vs. short, and long, short and net exposure in USD
• the 24-hour change
• concentration: the largest wallet's share, plus the trader-count view
• their share of open interest
• leverage settings
• flags such as smart_short_into_crowd_long

Liquidation levels and order-book depth (optional, includeLiquidations):

• USD of large accounts' known long positions that would be liquidated within 1, 2, 3, 5, 10 and 20% below the price, and of shorts above it
• the biggest liquidation clusters with their prices, and how concentrated they are
• how much of open interest the known positions cover
• live order-book depth within 0.5 to 10%, spread, and slippage for $10k, $100k and $1M orders
• cascade ratios (known liquidations within 2% and 5% against resting depth there) and flags: long_cascade_risk, short_squeeze_risk, thin_book

Only aggregates are reported, never wallet addresses.

Modes

Mode	Output	Price
coins	One record per coin you list	$0.01 per coin, plus $0.02 per coin with liquidation levels
market	Market-wide crowding plus smart-money overview	$0.02 per run
states	Every perp currently in a crowd state, with base rates	$0.02 per run

You pay only for records returned. Unknown coins and errors are free.

Example output (coins mode, abridged)

{
  "type": "coin",
  "coin": "SOL",
  "crowd": { "return_7d": 0.12, "funding_apr": 0.11, "funding_pct_own_90d": 0.82, "open_interest_usd": 812000000,
             "states": [], "base_rates": {} },
  "smart_money": { "traders_long": 14, "traders_short": 6, "net_usd": 9200000, "net_share": 0.41,
                   "net_share_by_traders": 0.4, "largest_wallet_share": 0.22, "flags": [] },
  "provenance": { "crowd": { "as_of": "2026-10-12T19:07:00Z", "signature": "…", "key_id": "187e49f200625a2f" } },
  "notice": "Historical statistics and current market data. Not investment advice."
}

Why trust it

• Signed. Every record carries an Ed25519 signature (key at https://api.annalist.dev/.well-known/annalist-key.json).
• Can't be backfilled. The archive behind it is append-only, and its daily fingerprints are published in a public ledger with Bitcoin timestamps.
• Clean sources. Hyperliquid's public chain data and Wikipedia pageviews only.
• Track record. A free, live record of how each state actually played out is at https://api.annalist.dev/v1/accuracy.

Use it from AI agents

• Call this Actor through Apify's MCP server or API.
• Agents can also buy directly over x402 (USDC on Base) or MCP at https://api.annalist.dev.
• See annalist.dev.

Notice

Historical statistics and current market data, not investment advice. Data, not recommendations. Hyperliquid restricts trading from some jurisdictions, including the US; this Actor provides information only.