{"uid":"cap_NB_z9zgRmiSM_n0DL9G2m","slug":"annalist-crowd-state-change-events-polling-76a22673","name":"Annalist Crowd-State Change Events (Polling)","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/changes?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":["since"],"properties":{"since":{"type":"string","format":"date-time"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{"events":[{"ts":"2026-10-12T14:07:00Z","coin":"XYZ","type":"enter","state":"up_100pct_7d"}]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JzpSJTfZoRvn8IVy6ZkER","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a time-ordered stream of crowd-state entry/exit events for Hyperliquid perpetuals since a given timestamp, each signed with the mark price at event time.","exampleAgentPrompt":"Pull all Hyperliquid crowd-state change events since 2024-06-01T12:00:00Z — I want to see which perps entered or exited crowded or hype states and what the mark price was at the time of each event.","exampleUseCases":[{"title":"Polling bot for crowd-state alerts","prompt":"Every 5 minutes, fetch any new Hyperliquid crowd-state entry or exit events since the last time you checked — show me which perps changed state and at what price."},{"title":"Pre-trade crowd-state check","prompt":"Before I trade HYPE-PERP, show me all the crowd-state changes it's had since 2024-07-01T00:00:00Z so I can see when it entered or exited crowded conditions."},{"title":"Intraday crowd-state timeline","prompt":"Give me a chronological list of every Hyperliquid perp that entered or left a crowd state in the last 6 hours, with the signed mark price at each event."}],"resultDescription":"A list of crowd-state change events (newest first) covering up to 7 days back from the request time. Each event includes the perpetual symbol, the type of state transition (entry/exit, crowded/hype), a timestamp, and a mark price signed at the time of the event. Events are filtered to those occurring after the provided `since` timestamp.","failureModes":["Missing or invalid `since` query parameter returns a 400 error","Timestamp older than 7 days may return an empty result set or an error indicating the lookback limit","Malformed date-time format (not ISO 8601) causes a 400 validation error","No events in the window returns an empty array (not an error)","x402 payment not provided or insufficient returns a 402 Payment Required response","Service downtime or rate limits may return 503 or 429 errors"],"whenToPreferThis":"Choose this endpoint when building a polling bot or event-driven workflow that needs to detect crowd-state transitions on Hyperliquid perps incrementally — i.e., you track a cursor timestamp and want only changes since your last poll. Prefer the historical backtesting sibling endpoint if you need up to 30 days of data in one call, or the current-state endpoint if you want a snapshot of all currently crowded perps without caring about transitions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:41:42.002Z","isFirstParty":false,"canonicalSlug":"annalist-crowd-state-change-events-polling-76a22673"}