{"uid":"cap_-0JT17W48qPdTFu2FFlRj","slug":"annalist-hyperliquid-crowd-states-20545d9c","name":"Annalist Hyperliquid Crowd States","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/states?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","properties":{"state":{"enum":["up_50pct_7d","up_100pct_7d","up_200pct_7d","funding_top5","funding_bottom5","attention_spike_3x","new_listing"],"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{"states":{"up_100pct_7d":[{"coin":"XYZ","return_7d":1.4}]}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fZsIIx7WJ434I26xDc4uh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns coins currently matching specific crowd-behavior states on Hyperliquid (e.g. up 50/100/200% in 7 days, funding extremes, attention spikes, new listings), with historical context on what happened next","exampleAgentPrompt":"Pull the Annalist crowd state data for Hyperliquid coins that are up 100% in the last 7 days — I want to see which assets are in that state and what historically happened next after they hit that level.","exampleUseCases":[{"title":"Momentum coin screening for trading","prompt":"Show me all coins on Hyperliquid that are up 200% in the past 7 days using Annalist crowd state data — I want to know which ones are in that state right now."},{"title":"Funding rate extremes alert","prompt":"What coins on Hyperliquid are currently in the top 5 highest funding rates? Pull the Annalist crowd state for funding_top5 so I can see who's paying the most."},{"title":"New listing opportunity scouting","prompt":"Are there any new listings on Hyperliquid right now? Use Annalist to pull the new_listing crowd state and tell me what coins just got listed."}],"resultDescription":"Returns a JSON object containing a 'states' map keyed by the requested crowd state (e.g. 'up_100pct_7d'), with an array of coins matching that state including their symbol and 7-day return figure. Data is cryptographically signed by Annalist for verifiability.","failureModes":["Invalid or missing 'state' enum value returns an error","Payment not received via x402 protocol returns 402 Payment Required","Rate limiting or quota exceeded may return 429","If no coins currently match the requested state, the array may be empty","Network or upstream Hyperliquid data unavailability may cause 503"],"whenToPreferThis":"Choose this endpoint when you need real-time Hyperliquid crowd-behavior snapshots filtered by specific state categories (momentum, funding extremes, attention spikes, new listings) with cryptographic signing for trustless agent use. Prefer over generic market data APIs when you want crowd-state classification plus historical precedent context, and when operating in an x402 pay-per-call agentic workflow where signed data provenance matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:37:06.529Z","isFirstParty":false,"canonicalSlug":"annalist-hyperliquid-crowd-states-20545d9c"}