{"uid":"cap_0L4p-vaQq6A7yK8r-d-7U","slug":"hyperliquid-max-pain-events-analytics-328ee523","name":"Hyperliquid Max Pain Events Analytics","description":"First-party Hyperliquid trading intelligence: perp fills, position lifecycles, all-wallet leaderboards, trader cohorts, liquidation risk and HIP-4 prediction markets - computed from our own node_fills ledger plus the Hyperliquid public info API (no third-party data source). Free discovery (/healthz, /v1/stats, /.well-known/x402, /v1/openapi.json) and free sample routes (/v1/markets/overview, /v1/assets); all other API calls are $0.001 USDC per request via x402 on Base (no account, no API key).","url":"https://hyperliquid-data.v1337.org/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":"down","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_I2SKm1vFRPcjbkHtDSaSX","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":"Returns max-pain event analytics for Hyperliquid perpetuals, identifying price levels and moments where aggregate trader losses are maximized, derived from first-party node fills and position data.","exampleAgentPrompt":"Pull the max pain events for ETH-USDC perps on Hyperliquid — I want to see which price levels caused the biggest aggregate losses and when those events occurred.","exampleUseCases":[{"title":"Identifying liquidation cascade price levels","prompt":"Show me the max pain events for BTC perpetuals on Hyperliquid over the past week — I need to know which price points triggered the largest cascades of trader losses."},{"title":"Pre-trade risk zone analysis","prompt":"Before I open a long position on SOL perps on Hyperliquid, pull the max pain events history so I can see which price levels have historically been the most dangerous for longs."},{"title":"Post-mortem on a volatile trading session","prompt":"There was a big move on Hyperliquid yesterday — can you fetch the max pain events for that session across all perp markets so I can understand where most traders got hurt?"}],"resultDescription":"Returns computed max-pain event records for Hyperliquid perpetual markets, including price levels at which aggregate unrealized or realized losses are maximized, timestamps of peak pain events, affected assets, and associated open interest or fill volume context — all derived from the operator's first-party node_fills ledger.","failureModes":["Payment required (402) if x402 micropayment on Base is not attached or fails","Invalid or missing body payload returns 400 with schema validation error","Unknown asset or market identifier returns empty result set or 404","Rate limiting or node data lag may cause stale or delayed results","Malformed JSON body returns parse error"],"whenToPreferThis":"Choose this endpoint when you need first-party, node-level max pain analytics specifically for Hyperliquid perpetual markets without relying on any third-party data aggregator. It is ideal for agents performing DeFi risk analysis, liquidation research, or market microstructure studies on Hyperliquid where data provenance and freshness from a dedicated node are important. Prefer it over generic crypto analytics APIs when Hyperliquid-specific fill-ledger fidelity and HIP-4 prediction market context matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T19:28:34.037Z","isFirstParty":false}