{"uid":"cap_Z0fqUk8hw_moD1Tswy4_O","slug":"annalist-hyperliquid-perp-crowd-state-analyzer-c0923894","name":"Annalist Hyperliquid Perp Crowd State Analyzer","description":"Signed data for AI agents, paid per call over x402. Hyperliquid crowd state, smart money and liquidations with what historically happened next, plus independent checks of x402 services and MCP servers.","url":"https://api.annalist.dev/v1/crowd/perp?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["coin"],"properties":{"coin":{"type":"string","description":"Hyperliquid perp symbol, for example BTC, ETH, SOL, HYPE, kPEPE"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{"coin":"SOL","states":[],"return_7d":0.12,"base_rates":{},"funding_apr":0.11}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uK4TYycc4Op5qXRArS0F0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns crowd and hype state analysis for a Hyperliquid perpetual, including funding metrics, open interest changes, premium, Wikipedia attention, and historical base rates for each crowd state","exampleAgentPrompt":"Before I trade SOL perp on Hyperliquid, check if it's in a crowded or hype state and tell me what historically happened next — funding percentile, open interest changes, and base rates for each active crowd state.","exampleUseCases":[{"title":"Pre-trade crowding check on BTC perp","prompt":"I'm about to short BTC perp on Hyperliquid — can you check if it's currently in a hype or crowded state and show me the historical base rates so I know what I'm walking into?"},{"title":"Screening HYPE perp after a big rally","prompt":"HYPE perp has been on a massive run this week — pull up the crowd state analysis for it on Hyperliquid and tell me the funding APR percentile vs its own 90-day history and vs all other perps."},{"title":"Evaluating kPEPE perp before a meme coin trade","prompt":"I want to trade kPEPE perp on Hyperliquid but I'm worried it might be over-hyped — check the crowd state, Wikipedia attention spike, open interest changes, and what the median 7-day return has been after similar conditions."}],"resultDescription":"Returns a signed JSON payload with: 7-day price move, hourly funding rate, funding APR, funding percentile vs coin's own 90-day history and vs all perps, open interest and its 24h/7d percentage change, premium, Wikipedia page attention, list of currently active crowd states, and for each state its historical base rates including sample size, median 7-day/30-day/90-day returns, and return spread.","failureModes":["Invalid or unsupported coin symbol returns an error (symbol not listed on Hyperliquid)","Network timeout or upstream data unavailability from Hyperliquid","Payment failure via x402 protocol resulting in 402 response before data is returned","Insufficient historical data for a newly listed perp may yield sparse base rate statistics"],"whenToPreferThis":"Use this endpoint when you need a pre-trade crowd/hype risk assessment specifically for Hyperliquid perpetuals, including funding rate context, open interest momentum, and historical base rates for identified crowd states. Prefer this over generic market data APIs when you want regime-aware context (crowded long, hype, etc.) with quantified historical outcomes rather than raw price feeds.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:39:14.180Z","isFirstParty":false,"canonicalSlug":"annalist-hyperliquid-perp-crowd-state-analyzer-c0923894"}