{"uid":"cap_RRr5X7Yc65KT9WfHL8QJo","slug":"hyperliquid-top-volume-wallets-analytics-a623efa6","name":"Hyperliquid Top-Volume Wallets 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-volume-wallets","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_aux0WUyoJqR1-JDmVLzfS","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 list of wallets with the highest trading volume on Hyperliquid perpetuals, computed from first-party node fills data.","exampleAgentPrompt":"Show me the top 20 wallets by trading volume on Hyperliquid perps over the last 7 days, ranked from highest to lowest volume.","exampleUseCases":[{"title":"Identify whale traders for market research","prompt":"Who are the top 50 volume traders on Hyperliquid right now? I need to understand who the biggest market movers are so I can analyze their trading patterns."},{"title":"Build a competitive trading leaderboard","prompt":"Can you pull the all-time top 100 wallets by perpetuals trading volume on Hyperliquid and show me their total trade counts alongside their volumes? I want to display this as a public leaderboard."},{"title":"Monitor liquidation risk among whales","prompt":"Show me the top volume traders on Hyperliquid perps this month and help me identify which ones might be at risk of liquidation based on their activity patterns."}],"resultDescription":"A ranked list of wallet addresses sorted by perpetuals trading volume on Hyperliquid, including volume totals, trade counts, and potentially per-asset breakdowns, derived from first-party node fills data.","failureModes":["Payment not fulfilled via x402 on Base — returns 402 Payment Required","Invalid or malformed JSON body — returns 400 Bad Request","Unsupported time range or filter parameters — returns 422 Unprocessable Entity","Hyperliquid node data temporarily unavailable — returns 503 Service Unavailable","Rate limiting or payment processing delay — returns 429 or timeout"],"whenToPreferThis":"Use this endpoint when you need first-party, operator-computed Hyperliquid top-volume wallet rankings without relying on any third-party data aggregator. It is ideal for identifying whale traders, building leaderboards, or performing competitive volume analysis on Hyperliquid perps. Prefer this over generic DeFi analytics APIs when you specifically need Hyperliquid-native fill data at low per-call cost with no API key required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:55:59.147Z","isFirstParty":false}