{"uid":"cap_juxmCe9aYuqVJcPqSW9EH","slug":"hyperliquid-trader-cohort-tier-classification-8db4872a","name":"Hyperliquid Trader Cohort Tier Classification","description":"Operator-neutral Hyperliquid trading intelligence — perp fills, position lifecycles, all-wallet leaderboards, trader cohorts, liquidation risk and prediction markets. Every endpoint is FIRST-PARTY: computed from our own node_fills ledger and the Hyperliquid public info API (no third-party data source). Free quota, then HTTP 402 (x402: pay-per-call in USDC, no account, no key).","url":"https://hyperliquid-data.v1337.org/services/hyperliquid-data/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":"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_R0-nPPguWchzacv9HO3D6","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 perpetual traders into cohort tiers based on their trading behavior and performance metrics","exampleAgentPrompt":"What cohort tier is wallet 0x1234abcd...ef on Hyperliquid — is it classified as a retail, mid, or whale-level perpetuals trader based on their fill history?","exampleUseCases":[{"title":"Classify whale vs retail trader","prompt":"Can you tell me what cohort tier wallet 0xabcd...5678 falls into on Hyperliquid? I want to know if they're a whale, mid-tier, or retail-level perp trader based on their actual fill history."},{"title":"Risk profile unfamiliar trading wallet","prompt":"I'm looking at this Hyperliquid wallet 0x9f3e...a12b and want to understand what kind of trader they are before I follow their positions — what cohort does their perpetuals activity put them in?"},{"title":"Segment traders for cohort analytics","prompt":"I have a list of Hyperliquid wallet addresses and need to bucket each one into its trader cohort tier — can you classify 0x7c2d...f890 first so I can see what segment they belong to based on their perp trading behavior?"}],"resultDescription":"Returns a cohort tier classification for the specified trader wallet, indicating which segment or tier the trader belongs to based on their perpetual trading activity, fill volume, and behavioral patterns derived from the first-party node_fills ledger.","failureModes":["Invalid or malformed wallet address returns 400 error","Unknown wallet with no trading history may return empty or default tier","HTTP 402 returned when free quota is exhausted — requires x402 micropayment in USDC to proceed","Malformed POST body or missing required fields returns validation error","Network or node data lag may cause stale tier assignments"],"whenToPreferThis":"Choose this endpoint when you need to classify or segment a specific Hyperliquid perpetuals trader into a behavioral cohort tier using first-party on-chain fill data. Prefer this over generic leaderboard or position endpoints when the goal is trader segmentation or cohort analysis rather than raw PnL or rankings. Ideal for risk profiling, targeting specific trader types, or building cohort-aware analytics pipelines on Hyperliquid.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T19:26:32.098Z","isFirstParty":false}