{"uid":"cap_bPPCH1mlv-m-0k6omaqll","slug":"annalist-hyperliquid-perpetuals-liquidation-data-c75b5642","name":"Annalist Hyperliquid Perpetuals Liquidation Data","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/liq/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":"BTC","flags":[],"long_clusters":[{"usd":25200000,"price":77480}],"longs_liquidating_below":[{"usd":12400000,"positions":9,"within_pct":5}]}}},"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_8k72NhkkDnBsNhMECcwYm","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 real-time perpetual futures liquidation clusters, long/short positions at risk, and historical context for a given Hyperliquid perp symbol","exampleAgentPrompt":"What are the current liquidation clusters and long positions at risk for BTC on Hyperliquid perps — show me how much USD is sitting in those clusters and where they'd get wiped out?","exampleUseCases":[{"title":"Liquidation cascade risk assessment","prompt":"Check Hyperliquid perp liquidations for ETH — how much USD is at risk in long clusters, and at what price levels would a big drop start triggering a cascade?"},{"title":"Smart money positioning for trade entry","prompt":"I'm thinking about longing SOL on Hyperliquid — pull the liquidation cluster data and tell me where the crowd is positioned and what historically happened next at similar setups."},{"title":"Monitoring HYPE perp liquidation exposure","prompt":"Pull the latest liquidation data for HYPE perpetuals on Hyperliquid and tell me how many positions and how much money is at risk of being liquidated within 5% of the current price."}],"resultDescription":"Returns a JSON object with the queried coin symbol, liquidation flags, long clusters with USD value and price level, and longs at risk of liquidating below current price including USD exposure, position count, and proximity percentage. Data is cryptographically signed by Annalist for agent-verifiable integrity.","failureModes":["Invalid or unsupported coin symbol returns an error — must use Hyperliquid perp ticker format (e.g. BTC, ETH, kPEPE)","Missing required 'coin' query parameter results in a 400-level error","Payment failure via x402 protocol blocks the response if USDC balance is insufficient","Rate limiting or upstream Hyperliquid data unavailability may cause temporary failures"],"whenToPreferThis":"Choose this endpoint when you need real-time Hyperliquid-specific perpetual futures liquidation data with cryptographic signing for agent-verifiable trust. Prefer it over generic crypto data APIs when you need granular liquidation cluster maps, crowd positioning, and historical liquidation context specific to Hyperliquid's on-chain state. The x402 micropayment model makes it suitable for per-call agent workflows without subscriptions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T06:40:47.749Z","isFirstParty":false,"canonicalSlug":"annalist-hyperliquid-perpetuals-liquidation-data-c75b5642"}