{"uid":"cap_P8q23l0ifS-fssiybWJKy","slug":"hyperliquid-max-pain-events-analytics-7faf9e18","name":"Hyperliquid Max Pain Events Analytics","description":"Operator-neutral Hyperliquid trading intelligence — perp fills, position lifecycles, all-wallet leaderboards, trader cohorts, liquidation risk and prediction markets. Every endpoint is FIRST-PARTY: computed from our own node_fills ledger and the Hyperliquid public info API (no third-party data source). Free quota, then HTTP 402 (x402: pay-per-call in USDC, no account, no key).","url":"https://hyperliquid-data.v1337.org/services/hyperliquid-data/v1/analytics/max-pain-events","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","description":"Operator-defined JSON payload. Probe the upstream or consult the operator's /openapi.json for the concrete shape.","additionalProperties":true},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"queryParams":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__Yzwc9sXr3UofLB2y-IIc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves max-pain liquidation events from Hyperliquid perpetuals, identifying price levels and moments where the most trader losses occurred","exampleAgentPrompt":"Pull the max pain liquidation events for BTC perpetuals on Hyperliquid over the last 7 days — I want to see which price levels triggered the biggest cluster of forced liquidations and how large the losses were.","exampleUseCases":null,"resultDescription":"Returns a list of max-pain events on Hyperliquid perpetuals, including price levels, timestamps, asset symbols, magnitude of losses, and the concentration of liquidations at each price point — computed from first-party node fill data.","failureModes":["Malformed or missing body payload returns HTTP 400 with schema validation error","Insufficient USDC balance triggers HTTP 402 requiring x402 payment","Unknown asset symbol or time range outside available ledger data returns empty result set or 404","Node ledger data lag may cause incomplete results for very recent events","Rate limit exceeded returns HTTP 429"],"whenToPreferThis":"Use this endpoint when you need to identify price levels and moments where Hyperliquid perpetual traders experienced maximum aggregated losses or forced liquidations — especially useful for understanding market structure, predator-prey dynamics around liquidation clusters, or validating trading strategies around key pain thresholds. Prefer over generic liquidation data sources because it is computed first-party from Hyperliquid node fills without third-party data intermediaries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:42:01.778Z","isFirstParty":false}