{"uid":"cap_au24QMhtCZKfoH25sKRZD","slug":"hyperliquid-cohort-tier-trades-1553e4bc","name":"Hyperliquid Cohort Tier Trades","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/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_CXXG2Vomu0YTQG5D9dsbW","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 history and fill records for Hyperliquid perpetual traders grouped by a specified cohort tier","exampleAgentPrompt":"Pull the recent perp trades for top-tier traders on Hyperliquid — I want to see what the highest-cohort accounts have been filling lately across all markets.","exampleUseCases":[{"title":"Monitoring elite trader activity","prompt":"Show me what the top-tier cohort of Hyperliquid perp traders has been doing in the last 24 hours — I want to see their fills and which assets they're trading most."},{"title":"Cohort comparison for trading research","prompt":"I'm researching whether high-tier Hyperliquid traders front-run liquidations — can you pull the trade fills for the elite tier so I can compare timestamps against liquidation events?"},{"title":"Trend detection via tier segmentation","prompt":"Which markets are the top-cohort Hyperliquid traders most active in right now? Pull their recent trades so I can spot any positioning trends before they hit the broader market."}],"resultDescription":"A JSON payload containing trade fills and position records for Hyperliquid perpetual traders within the specified cohort tier, sourced directly from the node_fills ledger. Includes fill details such as asset, side, size, price, and timestamp, segmented by trader tier.","failureModes":["Invalid or unrecognized tier value returns 400 or empty result set","Missing required body fields causes a 422 validation error","Payment not processed via x402 on Base returns 402 Payment Required","Upstream Hyperliquid node data lag may cause stale or incomplete fill records","Overly broad time range or large cohort may result in truncated responses or timeout"],"whenToPreferThis":"Use this endpoint when you need trade-level fill data scoped to a specific cohort tier of Hyperliquid perpetual traders, rather than raw wallet-level or market-wide data. It is ideal for segmented analysis — understanding what sophisticated or elite traders are doing relative to the broader market. Prefer this over generic Hyperliquid public API calls when you need pre-segmented, intelligence-ready cohort data without building your own classification layer.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:57:06.703Z","isFirstParty":false}