{"uid":"cap_sa25BMV4QFJOtJmH7oCrU","slug":"hyperliquid-cohort-bias-history-b5285a96","name":"Hyperliquid Cohort Bias History","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/live/cohort-bias/history","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_OPgwgoBR9S7Om428ls1NP","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 historical cohort-level directional bias data for Hyperliquid perpetual traders, showing how different trader groups positioned over time","exampleAgentPrompt":"Pull the historical cohort bias data from Hyperliquid for BTC perpetuals over the last 7 days — I want to see how different trader groups like retail and whales have been leaning long or short.","exampleUseCases":[{"title":"Contrarian signal from retail crowding","prompt":"Show me the cohort bias history on Hyperliquid for ETH perps over the past 30 days — I want to see when retail traders were extremely net long so I can identify potential contrarian short setups."},{"title":"Pre-liquidation positioning analysis","prompt":"Get the historical cohort bias data for all Hyperliquid perp markets from last week — I want to see how different trader cohorts were positioned right before the big liquidation cascade on Tuesday."},{"title":"Smart money vs crowd divergence","prompt":"Give me the Hyperliquid cohort bias history for SOL perpetuals over the past 14 days so I can compare how whale-tier traders and smaller accounts were leaning differently in terms of long/short bias."}],"resultDescription":"A time-series dataset showing historical directional bias broken down by trader cohort on Hyperliquid perpetuals. Each record typically includes timestamps, cohort identifiers, net long/short ratios or bias scores, and aggregated positioning metrics derived from the node fills ledger.","failureModes":["Invalid or missing body parameters return a 400 error","Unsupported cohort type or market identifier returns an error response","Payment of $0.001 USDC via x402 on Base is required; missing or failed payment returns 402","Time range too large or unsupported may return an error or empty result","Rate limiting or node data lag may cause stale or incomplete history"],"whenToPreferThis":"Choose this endpoint when you need time-series cohort-level sentiment and directional bias data derived directly from Hyperliquid's own fills ledger, without relying on third-party aggregators. It is ideal for building contrarian signals, backtesting crowd behavior, or studying how different trader size cohorts positioned historically on Hyperliquid perps. Prefer it over generic market data APIs when the specific Hyperliquid trader-cohort segmentation and fill-level accuracy matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:54:15.478Z","isFirstParty":false}