{"uid":"cap_tTtjaJDpG781VjKAahj6U","slug":"annalist-historical-crowd-state-events-c36bc195","name":"Annalist Historical Crowd-State Events","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/history?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":["from","to"],"properties":{"to":{"type":"string","format":"date"},"coin":{"type":"string","description":"Hyperliquid perp symbol, for example BTC, ETH, SOL, HYPE, kPEPE"},"from":{"type":"string","format":"date"},"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":{"events":[]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_sMUXqr8DilF97v-FKpGfR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns signed, Bitcoin-timestamped historical crowd-state events for Hyperliquid perpetuals over a specified date range, optionally filtered by coin and state type.","exampleAgentPrompt":"Pull the Annalist crowd-state history for BTC on Hyperliquid from 2025-05-01 to 2025-05-30, filtering for up_100pct_7d events, so I can backtest my momentum strategy.","exampleUseCases":[{"title":"Backtest momentum strategy on BTC","prompt":"Give me all the up_100pct_7d crowd-state events for BTC on Hyperliquid between 2025-03-01 and 2025-03-31 — I want to see when BTC entered that hype state so I can backtest my momentum entry rules."},{"title":"Audit funding spikes for SOL","prompt":"Pull the funding_top5 crowd-state events for SOL on Hyperliquid from 2025-04-01 to 2025-04-30 — I need to verify which days it was in the top funding tier to cross-check my risk model."},{"title":"Review all attention spikes across all coins","prompt":"Fetch every attention_spike_3x crowd-state event across all Hyperliquid perps from 2025-05-01 to 2025-05-15 — I want to see which coins had a 3x attention spike during that window for a research report."}],"resultDescription":"A list of signed historical crowd-state events for the requested date range, each timestamped and linked to a Bitcoin-anchored daily hash. Each event records a Hyperliquid perpetual entering or leaving a defined crowd state (e.g. up_50pct_7d, funding_top5, attention_spike_3x), with cryptographic signatures enabling independent verification of the archive's integrity.","failureModes":["Date range exceeds 30 days — API rejects with an error","Invalid coin symbol not found on Hyperliquid — returns empty result or error","Invalid state enum value — request rejected with validation error","No events exist for the given filter combination — returns empty list","Payment failure via x402 — request blocked before execution","Malformed date format (non ISO-8601) — returns 400 bad request"],"whenToPreferThis":"Choose this endpoint when you need tamper-evident, cryptographically signed historical crowd-state data for Hyperliquid perpetuals — specifically for backtesting trading strategies, auditing past hype cycles, or verifying crowd-state transitions with Bitcoin-timestamped provenance. Prefer it over real-time endpoints when your use case is retrospective analysis rather than live monitoring. The append-only archive with published daily hashes makes it uniquely suited for compliance, research, or strategy validation where data integrity must be provable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:34:53.376Z","isFirstParty":false,"canonicalSlug":"annalist-historical-crowd-state-events-c36bc195"}