Annalist
Hyperliquid crowd state, smart-money positioning and base rates; pay per call via x402 (Base USDC)
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"annalist": {
"url": "https://api.annalist.dev/mcp"
}
}
}Remote endpoints
https://api.annalist.dev/mcpstreamable-httpWhat it can do
Tool inventory
Tools (11)
🟢crowd_perp(coin)
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.
Input Schema
{
"type": "object",
"properties": {
"coin": {
"type": "string",
"description": "Hyperliquid perp symbol, for example BTC, ETH, SOL, HYPE, kPEPE (case-sensitive)"
}
},
"required": [
"coin"
]
}🟢crowd_states(state)
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.
Input Schema
{
"type": "object",
"properties": {
"state": {
"type": "string",
"enum": [
"up_50pct_7d",
"up_100pct_7d",
"up_200pct_7d",
"funding_top5",
"funding_bottom5",
"attention_spike_3x",
"new_listing"
]
}
}
}🟢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.
Input Schema
{
"type": "object",
"properties": {}
}🟢crowd_changes(since)
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.
Input Schema
{
"type": "object",
"properties": {
"since": {
"type": "string",
"description": "ISO timestamp within the last 7 days"
}
},
"required": [
"since"
]
}🟢crowd_history(from, to, coin, state)
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.
Input Schema
{
"type": "object",
"properties": {
"from": {
"type": "string",
"description": "YYYY-MM-DD"
},
"to": {
"type": "string",
"description": "YYYY-MM-DD, at most 30 days after from"
},
"coin": {
"type": "string",
"description": "Hyperliquid perp symbol, for example BTC, ETH, SOL, HYPE, kPEPE (case-sensitive)"
},
"state": {
"type": "string",
"enum": [
"up_50pct_7d",
"up_100pct_7d",
"up_200pct_7d",
"funding_top5",
"funding_bottom5",
"attention_spike_3x",
"new_listing"
]
}
},
"required": [
"from",
"to"
]
}🟢smart_perp(coin)
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.
Input Schema
{
"type": "object",
"properties": {
"coin": {
"type": "string",
"description": "Hyperliquid perp symbol, for example BTC, ETH, SOL, HYPE, kPEPE (case-sensitive)"
}
},
"required": [
"coin"
]
}🟢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.
Input Schema
{
"type": "object",
"properties": {}
}🟢annalist_about
Free. What Annalist is, every tool and its price, how payment works (x402, USDC on Base), and how fresh the data is.
Input Schema
{
"type": "object",
"properties": {}
}🟢annalist_baserates(state)
Free. Historical base rates for every crowd state: sample size, median and spread of later returns, chance of further run-ups. Optional state filter.
Input Schema
{
"type": "object",
"properties": {
"state": {
"type": "string",
"enum": [
"up_50pct_7d",
"up_100pct_7d",
"up_200pct_7d",
"funding_top5",
"funding_bottom5",
"attention_spike_3x",
"new_listing"
]
}
}
}🟢annalist_market_sample
Free. The crowd_market view as it was 24 hours ago, to evaluate the data before paying.
Input Schema
{
"type": "object",
"properties": {}
}🟢annalist_track_record
Free. Every crowd-state event's later outcome, compared with its backtest base rate.
Input Schema
{
"type": "object",
"properties": {}
}Community
Evidence