Annalist
What is crowded on Hyperliquid right now, where its most profitable traders are positioned, where the liquidations sit, and what historically happened next. Plus its stock and commodity perps, prediction markets and HLP vault. Signed data for AI agents, paid per call over x402. No accounts, no API keys.
Right now
- Funding in its own bottom 5%3
- Funding in its own top 5%3
- Up 50–100% in a week1
Smart money
The 200 Hyperliquid wallets with the highest 30-day perp PnL among those with at least $50,000 in the account (now and on average over the month), $250,000 of 30-day volume, a 30-day return of at least 5% on average account value, and PnL of at least 20 bp per dollar traded (screens out market makers). Wallets are discovered from the public trade stream and re-ranked at least every 14 days. Only totals are published, never wallet addresses.
Liquidations within 5%
- SOL$9.9M longs below · under $0.1M shorts above
- BTC$5.6M longs below · $8.7M shorts above
- ETH$0.3M longs below · $3.3M shorts above
- HYPE$1.2M longs below · under $0.1M shorts above
- LIT$0.5M longs below · none shorts above
Known positions that would be force-closed if the price moved 5% against them, from the public positions of Hyperliquid's large accounts. Each answer adds clusters, coverage of open interest, order-book depth and cascade ratios. Only totals are published, never wallet addresses.
Newer Hyperliquid markets
- Builder-deployed perps: 160 markets, largest SP500, SKHX, GOLD$3.9B open interest
- Outcome markets: 328 live; most traded: Anthropic first-day market cap above $1500B (listing by 2027-01-01T00:00:00Z)$8.7M traded in 24h
- HLP vault: $180M under managementnet short $0.2M
Stock, index, commodity and currency perps that other exchanges run on Hyperliquid; its on-chain prediction markets; and HLP, the exchange's own market-making vault. Hourly, signed, from public chain data.
x402 service checks
Sellers: show your grade with a signed badge: <a href="https://annalist.dev/check/YOUR_HOST"><img src="https://api.annalist.dev/v1/verify/badge.svg?host=YOUR_HOST"></a>. Agents: fetch /v1/verify/attestation?host= (free) and check the signature before paying.
Before an agent pays an x402 service: is it up, does it charge what it lists, and are its customers real? We probe every service listed in Coinbase's x402 Bazaar daily, read its USDC payments on Base with fake volume removed, and make small test purchases. Every grade comes with its reasons. We also record every listed price and payout wallet each day, so agents can see what changed and what a kind of call usually costs. Rankings are never for sale, and our own service is left out of them.
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 its most profitable traders are positioned: how many wallets in a 200-wallet smart-money cohort are long vs short, long, short and net USD, the 24h change, concentration, leverage settings, 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. |
/v1/liq/perp | $0.02 | Use before opening, sizing or holding a Hyperliquid perpetual position to see where forced selling or buying would hit: known longs liquidating within 1 to 20% below the mark and shorts above it, the biggest clusters, and coverage of open interest, set against order-book depth, spread and slippage as cascade ratios. |
/v1/liq/market | $0.03 | Liquidation pressure across Hyperliquid's largest perps: for each, the known longs liquidating within 5% below the mark and shorts within 5% above it, cascade ratios against order-book depth, 2% depth, how much of open interest the known positions cover, and flags; plus the coins with the most liquidations nearby. |
/v1/hip3/perp | $0.01 | Use before trading a stock, index, commodity or FX perpetual on Hyperliquid (builder-deployed, HIP-3; coins like xyz:NVDA, xyz:GOLD, xyz:SP500): price and 1h, 24h, 7d and 30d moves, volume, open interest and its 24h change, how close it is to its open-interest cap, funding (hourly, APR, percentile vs its own 30 days), premium and max leverage, with flags. |
/v1/hip3/market | $0.02 | Overview of every builder-deployed (HIP-3) perpetual on Hyperliquid, mostly 24/7 stock, index, commodity and FX markets: each exchange's markets, open interest and volume; the largest and most traded markets; the biggest 24h moves; funding extremes; markets near their open-interest cap; and flags. |
/v1/outcomes/list | $0.02 | Every live Hyperliquid outcome (prediction) market: readable title, category (sports, price, ipo, policy_rate, awards), deadline, each side's price as implied probability with its 24h change, and 24h volume, most traded first. |
/v1/outcomes/market | $0.01 | One Hyperliquid outcome (prediction) market by id: readable title, structured details (teams, thresholds, deadlines, official source), each side's implied probability, 24h change, volume and outstanding value, its question, and a week of hourly prices per side. |
/v1/vaults/hlp | $0.01 | Hyperliquid's own market-making vault (HLP), which takes over liquidated positions: account value, APR, PnL over a day, week, month and all time, and its net position per coin across all its sub-vaults, with the most long, most short and biggest 24h changes. |
/v1/perp/full | $0.03 | One call, one payment for everything on a Hyperliquid perpetual: crowd state with base rates for what usually followed (as /v1/crowd/perp), smart-money positioning (as /v1/smart/perp) and liquidation levels with order-book depth (as /v1/liq/perp), each with its own as_of. |
/v1/checks/service | $0.01 | Use before paying an x402 service: independent checks by host or URL. |
/v1/checks/seller | $0.01 | Checks for an x402 seller wallet on Base: the services that pay out to it and their grades, and USDC received over 30 days with payers, repeat payers and fake-volume signals (payers the seller funded, crawler bots, one-wallet dominance). |
/v1/checks/top | $0.02 | Leaderboards from our independent checks of x402 services: most real (wash-adjusted) paying customers, most reliable, and flagged services (price or wallet mismatches, outages, mostly bot traffic, self-funded volume), with the method. |
/v1/checks/changes | $0.01 | What changed in x402 service listings, from daily snapshots of Coinbase's Bazaar: price raises and cuts, endpoints added and dropped, new and departed services, and payout-wallet changes (worth checking before paying: a hijacked listing looks the same as a rotated wallet). |
/v1/prices/service | $0.01 | Price history of an x402 service by host or URL: each listed endpoint's price, first-seen date and changes, price changes in 30 days (raised, lowered, delisted), the prices it actually quoted when we called it, and where it sits against similar services by category (market median and percentile). |
/v1/prices/benchmarks | $0.01 | Price benchmarks for x402 services by category (seller tags such as search, llm, weather, market-data): how many services, price percentiles (each service counted once, at its median), and 7- and 30-day trends. |
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.