{"uid":"cap_KS3_DD1kRCg-EFoxige1I","slug":"hyperliquid-cohort-tier-trades-4fe9a92c","name":"Hyperliquid Cohort Tier Trades","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/trades","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_b36ZWhEE6J5dPcuzVEhrp","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 trade/fill records for wallets within a specific trader cohort tier on Hyperliquid perpetuals markets","exampleAgentPrompt":"Pull all the trade fills for the top-tier cohort of traders on Hyperliquid perps — I want to see what the elite cohort has been executing recently.","exampleUseCases":null,"resultDescription":"A list of perpetual trade fill records (executions) belonging to wallets classified under the specified cohort tier, sourced directly from the operator's node_fills ledger. Includes fill-level details such as asset, side, price, size, and timestamp for each trade within that trader segment.","failureModes":["Invalid or missing cohort tier parameter returns 400 Bad Request","Unrecognized tier value returns empty result set or 422","Payment not completed returns HTTP 402 with x402 payment challenge","Upstream Hyperliquid node data temporarily unavailable returns 503","Malformed JSON body returns 400 with schema validation error","Rate limit exceeded before payment returns 429"],"whenToPreferThis":"Use this endpoint when you need to analyze or retrieve trade fills segmented by trader cohort tier on Hyperliquid — particularly when you want to study behavior patterns of a specific trader class (e.g. whales, retail, mid-tier) rather than a single wallet or the full leaderboard. Prefer this over single-wallet fill endpoints when doing cohort-level research or building strategies based on group behavior.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:49:04.465Z","isFirstParty":false}