{"uid":"cap_aMzVRRVZR-icuwWjxp9TU","slug":"hyperliquid-trader-cohort-tier-classification-23e19e1d","name":"Hyperliquid Trader Cohort Tier Classification","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/tier","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_Bj2Vdsx_zipyMipOzrPcX","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":"Classifies Hyperliquid wallet addresses into trader cohorts and tiers based on perpetual trading behavior, position history, and on-chain fill data","exampleAgentPrompt":"What cohort tier does wallet 0xAbC123... fall into on Hyperliquid — is it a whale, retail, or something in between? Pull it from the node_fills-based tier classification.","exampleUseCases":[{"title":"Whale vs retail trader segmentation","prompt":"Can you check which cohort tier the wallet 0x1a2b3c4d5e6f... is in on Hyperliquid — I want to know if it's classified as a whale, mid-tier, or retail perp trader."},{"title":"Risk scoring by trader cohort","prompt":"I'm building a copy-trading filter — can you pull the Hyperliquid cohort tier for these addresses so I can only follow wallets that are in the top tier?"},{"title":"Leaderboard cohort research","prompt":"I'm analyzing the top 50 Hyperliquid perp traders on the leaderboard — can you classify each one into their cohort tier so I can see if high-PnL traders cluster in the same segment?"}],"resultDescription":"Returns the cohort tier classification for the queried Hyperliquid wallet(s), including tier label (e.g. whale, mid-tier, retail), segment metadata derived from perpetual fill history, and any supporting statistics used to determine the classification.","failureModes":["Unknown or inactive wallet address returns empty cohort or null tier","Malformed wallet address causes 400 validation error","Payment not completed via x402 on Base results in 402 Payment Required","Wallet with no Hyperliquid perp activity may be unclassifiable","Rate limiting or node data lag may cause stale or delayed tier results"],"whenToPreferThis":"Choose this endpoint when you need on-chain, first-party Hyperliquid trader segmentation derived directly from node_fills data — not third-party aggregators. Ideal for DeFi analytics agents, copy-trading filters, risk systems, or leaderboard analysis that requires accurate cohort classification without requiring an account or API key, paying only $0.001 USDC per call via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:48:35.785Z","isFirstParty":false}