Annalist
What is crowded on Hyperliquid right now, where its most profitable traders are positioned, and what historically happened next. Signed data for AI agents, paid per call over x402. No accounts, no API keys.
Right now
- Funding in its own top 5%3
- Funding in its own bottom 5%3
- Up 50–100% in a week1
Smart money
A cohort of Hyperliquid's most profitable directional traders, built from public chain data. Only totals are published, never wallet addresses.
What usually happened next
Every answer carries base rates like these, measured on Hyperliquid's own history. Compare: any liquid perp on a random day had a 90-day median of −21%.
| State | Horizon | Median return | Rose | Doubled again | Cases |
|---|---|---|---|---|---|
| Up 100–200% in a week | 90 days | −41% | 26% | 23% | 98 |
| Up 200%+ in a week | 90 days | −54% | 29% | 29% | 21 |
| Newly listed perp | 90 days | −29% | 35% | 39% | 168 |
| Funding in its own top 5% | 30 days | +5% | 62% | 5% | 120 |
| Wikipedia attention 3× normal | 90 days | +10% | 57% | 19% | 21 |
Endpoints
| Route | Price | What it returns |
|---|---|---|
/v1/crowd/perp | $0.01 | Use before acting on a Hyperliquid perpetual to see whether it is crowded or in a hype state and what historically followed. |
/v1/crowd/states | $0.02 | Every Hyperliquid perp currently in a crowd state (7-day moves of +50/+100/+200%, funding in its own top or bottom 5%, Wikipedia attention spikes, new listings), ranked by 7-day move, each with base rates for what followed similar states historically. |
/v1/crowd/market | $0.01 | Market-wide crowding on Hyperliquid: breadth of 7-day moves, how many perps are up 50%+/100%+ in a week, share of perps with funding in their own top/bottom 5%, total open interest and its 24h change, BTC and ETH funding percentiles, and Wikipedia attention to cryptocurrency. |
/v1/crowd/changes | $0.005 | For bots that poll: crowd-state events (a perp entering or leaving a state) since a timestamp, newest first, up to 7 days back. |
/v1/crowd/history | $0.05 | Signed historical crowd-state events for backtesting: up to 30 days per call, optionally filtered by coin and state. |
/v1/smart/perp | $0.01 | Use before acting on a Hyperliquid perpetual to see how the most profitable Hyperliquid traders are positioned in it: how many wallets in a 200-wallet smart-money cohort are long vs short, their long, short and net exposure in USD, the 24h change, average leverage, their share of open interest, and how that compares with the crowd (funding, 7-day move). |
/v1/smart/market | $0.02 | Where Hyperliquid's most profitable traders are positioned across all perps: the cohort's overall net long or short, the coins it is most net long and most net short, the biggest 24-hour changes, and coins where smart money is positioned against the crowd. |
Use it
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
const pay = wrapFetchWithPaymentFromConfig(fetch, {
schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});
const res = await pay("https://api.annalist.dev/v1/crowd/perp?coin=SOL");
Why you can trust the history
Every response is signed (Ed25519; key at /.well-known/annalist-key.json). The archive behind it is append-only: each day's file hashes go to a public ledger and are timestamped in Bitcoin, so the record can't be backfilled or quietly edited. Base rates come only from Hyperliquid's public data and Wikipedia pageviews.
Historical statistics and current market data. Not investment advice. Data, not recommendations. Hyperliquid restricts trading from some jurisdictions, including the US; Annalist sells information only. Questions: open an issue on the ledger repo.