{"uid":"cap__-S3JArpfrlZjEHVhw1bJ","slug":"annalist-hyperliquid-perp-full-state-c063c18b","name":"Annalist Hyperliquid Perp Full State","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/perp/full?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":"BTC","crowd":{"states":[]},"smart_money":{"net_share":0.12},"liquidations":{"flags":[]}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NfykE-SC7_boCvn1zHtgP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns full perpetual market intelligence for a Hyperliquid coin — crowd positioning state, smart money net share, and liquidation flags with historical context — as cryptographically signed data.","exampleAgentPrompt":"Pull the full Hyperliquid perp intelligence for BTC — crowd positioning, smart money net share, liquidation flags, and what historically followed similar conditions — and give me the signed data snapshot.","exampleUseCases":[{"title":"Pre-trade crowd sentiment check","prompt":"Before I open a BTC perp position on Hyperliquid, can you check the current crowd state and smart money net share to see if the crowd is heavily one-sided?"},{"title":"Liquidation cascade risk assessment","prompt":"Are there any significant liquidation flags firing for ETH perps on Hyperliquid right now, and what did price do historically after similar liquidation patterns?"},{"title":"Alt-coin smart money monitoring","prompt":"Check the full perp state for kPEPE on Hyperliquid — I want to see if smart money is accumulating or distributing and whether any crowd positioning extremes are showing up."}],"resultDescription":"A JSON object containing: the queried coin symbol, an array of crowd state snapshots, a smart money object with net_share (fraction of open interest held by smart money wallets), and a liquidations object with flags describing recent liquidation events and historical analogs — all wrapped in a cryptographic signature for data integrity verification.","failureModes":["Invalid or unsupported coin symbol returns an error — must use exact Hyperliquid perp ticker (e.g. BTC not BTCUSDT)","Payment failure via x402 protocol results in 402 response before data is returned","Hyperliquid data unavailability may result in empty arrays for crowd states or flags","Stale or delayed underlying data if Hyperliquid feed is lagging","Rate limit or quota exhaustion returning 429 or similar error"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive, single-call snapshot of Hyperliquid perpetual market intelligence — crowd positioning, smart money flows, and liquidation context — with cryptographic signing for data integrity. Prefer it over raw Hyperliquid API calls when you need the historical-analog context (what happened next) or when your agent workflow requires verifiable signed data payloads. It is specifically suited for DeFi trading agents that need actionable, pre-analyzed signals rather than raw order book data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T06:39:47.888Z","isFirstParty":false,"canonicalSlug":"annalist-hyperliquid-perp-full-state-c063c18b"}