{"uid":"cap_LtjQyFI-PgLZbSlsJYC1Q","slug":"hyperliquid-top-liquidators-analytics-ad77d4ba","name":"Hyperliquid Top Liquidators 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/top-liquidators","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_KXXMvMcpw8-YC6IbGYt8N","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 a ranked leaderboard of wallets that have executed the most or largest liquidations on Hyperliquid perpetuals, derived from first-party node_fills ledger data.","exampleAgentPrompt":"Show me the top liquidators on Hyperliquid by total liquidation volume — I want to see which wallets are running the biggest liquidation operations on the perp markets.","exampleUseCases":[{"title":"Identifying dominant liquidation bots","prompt":"Who are the top 20 liquidators on Hyperliquid right now? I want to know which wallets are executing the most liquidations and how much volume they're capturing."},{"title":"Risk research on liquidation concentration","prompt":"Pull the Hyperliquid top liquidators leaderboard for me — I'm trying to understand how concentrated liquidation activity is and whether a few addresses dominate the process."},{"title":"Tracking a competitor liquidator's performance","prompt":"I need to see where a specific wallet ranks among Hyperliquid's top liquidators and how their liquidation count and volume compares to others on the leaderboard."}],"resultDescription":"A ranked list of wallet addresses that have acted as liquidators on Hyperliquid perpetuals, including metrics such as liquidation count, total notional volume liquidated, and estimated PnL from liquidation activity, sourced from the operator's node_fills ledger.","failureModes":["Payment not received or x402 payment flow incomplete — request rejected with 402","Invalid or malformed POST body — 400 error returned","No liquidation data available for the specified filter criteria — empty result set","Node_fills ledger temporarily unavailable — 503 service error","Rate limiting or upstream Hyperliquid API degradation causing stale or delayed data"],"whenToPreferThis":"Choose this endpoint when you need first-party, node-level liquidation leaderboard data for Hyperliquid perpetuals without relying on third-party data aggregators. It is ideal for DeFi research agents, liquidation bot benchmarking, or risk analysis tools that need authoritative on-chain liquidation rankings derived directly from Hyperliquid's fill ledger. Prefer this over generic DEX analytics APIs when Hyperliquid-specific liquidation intelligence is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:57:32.522Z","isFirstParty":false}