io.github.ryanroskowski/annalist

Annalist

Hyperliquid crowd state, smart-money positioning and base rates; pay per call via x402 (Base USDC)

0.2.0
Version
remote
Transport
11
Tools

Security review

Partly reviewed

Reviewed 53m ago. Tool definitions changed on Oct 12, 2026.

  • tools: 11 tools scanned
  • metadata: scanned
  • mediumReviewTool definitions changed after an earlier review

    A server that changes its tool descriptions after being approved ("rug pull") can slip new instructions to agents. Re-check what changed before trusting it.

    changed 2026-10-12

Tools (11)

  • crowd_perp

    Use before acting on a Hyperliquid perpetual to see whether it is crowded or in a hype state and what historically followed. Returns 7-day move, funding (hourly, APR, percentile vs its own 90 days and vs all perps), open interest and its 24h/7d change, premium, Wikipedia attention, active crowd states, and each state's base rates (sample size, median and spread of 7/30/90-day returns). Signed. Not investment advice. Price: $0.01 USDC per call via x402 on Base.

  • crowd_states

    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. Optional ?state= filter. Signed. Not investment advice. Price: $0.02 USDC per call via x402 on Base.

  • crowd_market

    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. Signed. Not investment advice. Price: $0.01 USDC per call via x402 on Base.

  • crowd_changes

    For bots that poll: crowd-state events (a perp entering or leaving a state) since a timestamp, newest first, up to 7 days back. Each event is signed with the mark price at the time. Not investment advice. Price: $0.005 USDC per call via x402 on Base.

  • crowd_history

    Signed historical crowd-state events for backtesting: up to 30 days per call, optionally filtered by coin and state. The archive is append-only and its daily hashes are published and Bitcoin-timestamped. Price: $0.05 USDC per call via x402 on Base.

  • smart_perp

    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, how concentrated it is (largest wallet's share, trader-count view), leverage settings, their share of open interest, and how that compares with the crowd (funding, 7-day move). Flags smart money broadly positioned against a crowded move. Aggregates only, never wallet addresses. Signed. Not investment advice. Price: $0.01 USDC per call via x402 on Base.

  • smart_market

    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. Cohort definition included. Aggregates only. Signed. Not investment advice. Price: $0.02 USDC per call via x402 on Base.

  • annalist_about

    Free. What Annalist is, every tool and its price, how payment works (x402, USDC on Base), and how fresh the data is.

  • annalist_baserates

    Free. Historical base rates for every crowd state: sample size, median and spread of later returns, chance of further run-ups. Optional state filter.

  • annalist_market_sample

    Free. The crowd_market view as it was 24 hours ago, to evaluate the data before paying.

  • annalist_track_record

    Free. Every crowd-state event's later outcome, compared with its backtest base rate.