{"uid":"cap_K0dKw-L0NiUlPBf44wZ-W","slug":"hyperliquid-data-trader-cohorts-summary-5edabdc6","name":"Hyperliquid Data - Trader Cohorts Summary","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/cohorts/summary","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_XB3K5TMhANsVE9NvQS_SI","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 summary breakdown of Hyperliquid perpetual traders segmented into behavioral cohorts (e.g. whales, retail, liquidation-prone) based on fill and position lifecycle data.","exampleAgentPrompt":"Give me a summary of the different trader cohorts on Hyperliquid perps — I want to see how the population breaks down by segment, like whales, retail, and high-liquidation-risk traders.","exampleUseCases":[{"title":"Whale vs retail trader analysis","prompt":"Break down the current Hyperliquid perpetual trader population into cohorts and tell me how many whales versus retail traders are active right now."},{"title":"Liquidation risk cohort monitoring","prompt":"Which trader cohorts on Hyperliquid carry the most liquidation risk? Give me a cohort summary so I can see where the concentrated risk is."},{"title":"Market composition research","prompt":"I'm building a report on Hyperliquid perp market structure — can you pull the cohort summary so I can see how traders are distributed across behavioral segments?"}],"resultDescription":"A structured JSON response containing aggregated statistics for each identified trader cohort on Hyperliquid, including segment labels, trader counts, volume metrics, position data, and risk indicators derived from the operator's node_fills ledger.","failureModes":["Malformed POST body returns 400 with schema validation error","Payment not submitted or insufficient USDC triggers x402 payment-required response","Cohort filter parameters outside supported range return empty or error response","Hyperliquid public info API downtime may cause stale or incomplete cohort data","Rate limiting or node sync lag may produce delayed results"],"whenToPreferThis":"Choose this endpoint when you need a population-level segmentation of Hyperliquid traders by behavioral cohort rather than individual wallet lookups. It is uniquely suited for market structure research, risk monitoring across trader classes, and understanding the composition of Hyperliquid's perp trading base. Prefer it over individual fill or leaderboard endpoints when you want aggregate cohort-level insights in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:46:04.668Z","isFirstParty":false}