{"uid":"cap_Pl1q3WiewLOnQUseCpt95","slug":"hyperliquid-cohort-tier-positions-4f48d56c","name":"Hyperliquid Cohort Tier Positions","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/positions","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_Ff2BcesMe4bYCNs-dTa5s","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 open perpetual positions for wallets within a specific Hyperliquid trader cohort/tier, enabling analysis of collective positioning behavior across trader segments.","exampleAgentPrompt":"Show me the current open perp positions held by top-tier traders on Hyperliquid — I want to see what the elite cohort is positioned in right now.","exampleUseCases":[{"title":"Whale position surveillance for trading signals","prompt":"Pull the current open perpetual positions for the highest-tier trader cohort on Hyperliquid — I want to see what the whales are holding and in which direction so I can gauge market sentiment."},{"title":"Cohort exposure analysis for risk management","prompt":"Get me all open positions for mid-tier traders on Hyperliquid perps — I need to understand the aggregate directional exposure of that cohort to assess crowding risk."},{"title":"Monitoring elite traders before major market events","prompt":"Check what positions the top-tier Hyperliquid trader cohort is holding right now across all perp markets — I want to see if they're positioned for a big move ahead of today's macro data."}],"resultDescription":"A structured list of open perpetual positions associated with wallets in the specified trader cohort/tier, including details such as asset, position size, side (long/short), entry price, mark price, unrealized PnL, and leverage. Data is sourced from Hyperliquid's own node_fills ledger.","failureModes":["Invalid or unrecognized cohort tier identifier returns 400 or empty result","Payment not settled via x402 on Base returns 402 Payment Required","Malformed POST body missing required fields returns 400 Bad Request","Upstream Hyperliquid node data lag may cause stale position data","Rate limiting or transient node unavailability returns 503"],"whenToPreferThis":"Choose this endpoint when you need segmented, cohort-level perpetual position data on Hyperliquid sourced directly from a first-party node ledger — not aggregated third-party data. Ideal for agents performing smart money tracking, crowding analysis, or competitive positioning research across defined trader tiers. Prefer over generic Hyperliquid APIs when you need pre-computed cohort classification.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:45:25.486Z","isFirstParty":false}