{"uid":"cap_82clAJXASI_HsV0cNS8cZ","slug":"smartperps-cohort-scan-hyperliquid-smart-trader-position-scanner-a5fd964f","name":"SmartPerps Cohort Scan — Hyperliquid Smart Trader Position Scanner","description":"Crypto smart money scan API (Hyperliquid). Market-wide smart-money scan over every Hyperliquid perp held by the top-120 30-day-PnL cohort: the cohort gross long/short book and net exposure, and ranked lists of the coins it is most net long, most net short and most one-sided on (by trader count), plus the biggest 24h net buying and selling by notional, each with bias, trader counts, net notional and flows. limit 1-25 rows per list, min_traders 2-50 (default 3). Fail-closed. Not financial advice.","url":"https://api.youraitools.co/smartperps/v1/scan?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"limit":{"type":"integer","description":"Rows per list, 1-25 (default 10)"},"min_traders":{"type":"integer","description":"Only rank coins held by at least this many cohort accounts, 2-50 (default 3)"}},"description":"Search intents: smart money scan, whale net long coins, hyperliquid leaderboard positions, crypto sentiment scan, most shorted coins, smart money market"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"mode":{"type":"string"},"tier":{"type":"string"},"cohort":{"type":"object"},"checked_at":{"type":"string"},"coins_held":{"type":"number"},"confidence":{"type":"string"},"disclaimer":{"type":"string"},"flows_note":{"type":"string"},"cohort_book":{"type":"object"},"min_traders":{"type":"number"},"snapshot_at":{"type":"string"},"coins_ranked":{"type":"number"},"most_net_long":{"type":"array"},"most_net_short":{"type":"array"},"most_one_sided":{"type":"array"},"snapshot_age_s":{"type":"number"},"sources_failed":{"type":"array"},"biggest_24h_buying":{"type":"array"},"biggest_24h_selling":{"type":"array"}}}}}}},"responseSchema":{"type":"json","example":{"mode":"cohort","tier":"scan","cohort":{"size":120,"covered":120,"coverage_pct":100,"cohort_refreshed_at":"2026-10-23T01:08:26.080Z"},"checked_at":"2026-10-23T01:08:30.196Z","coins_held":178,"confidence":"high","disclaimer":"Not financial advice. Past performance does not guarantee future results. Descriptive statistics of public Hyperliquid positions at snapshot time; past PnL of the cohort says nothing about future results and positions can change at any moment. SmartPerps never trades, holds funds or keys.","flows_note":"Flow history builds up over the first 24 hours after launch; flow lists are empty until a 24h-old snapshot exists.","cohort_book":{"net_usd":-2691814073,"equity_usd":702970565,"gross_long_usd":206948229,"long_share_pct":6.7,"gross_short_usd":2898762302,"accounts_with_positions":83},"min_traders":3,"snapshot_at":"2026-10-23T01:08:26.080Z","coins_ranked":146,"most_net_long":[{"bias":"mixed","symbol":"AAVE","traders_long":5,"traders_short":13,"flow_1h_net_usd":null,"flow_24h_net_usd":null,"net_notional_usd":1003728,"long_share_notional_pct":52.5},{"bias":"strong_long","symbol":"ATOM","traders_long":5,"traders_short":1,"flow_1h_net_usd":null,"flow_24h_net_usd":null,"net_notional_usd":972941,"long_share_notional_pct":96}],"most_net_short":[{"bias":"strong_short","symbol":"BTC","traders_long":8,"traders_short":37,"flow_1h_net_usd":null,"flow_24h_net_usd":null,"net_notional_usd":-820640322,"long_share_notional_pct":2.7},{"bias":"strong_short","symbol":"ETH","traders_long":10,"traders_short":40,"flow_1h_net_usd":null,"flow_24h_net_usd":null,"net_notional_usd":-755197408,"long_share_notional_pct":7.1}],"most_one_sided":[{"bias":"strong_short","symbol":"XPL","traders_long":0,"traders_short":20,"flow_1h_net_usd":null,"flow_24h_net_usd":null,"net_notional_usd":-14667723,"long_share_notional_pct":0},{"bias":"strong_short","symbol":"AERO","traders_long":0,"traders_short":12,"flow_1h_net_usd":null,"flow_24h_net_usd":null,"net_notional_usd":-2620964,"long_share_notional_pct":0}],"snapshot_age_s":4,"sources_failed":[],"biggest_24h_buying":[],"biggest_24h_selling":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dydV5mpQRaTIjnio75_AC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a ranked snapshot of perpetuals positions held by a cohort of top Hyperliquid traders, showing which coins they are most net-long, net-short, or one-sided on.","exampleAgentPrompt":"Show me the top 10 coins where smart Hyperliquid traders have the strongest net positioning right now, only including coins held by at least 5 traders in the cohort.","exampleUseCases":[{"title":"Spotting crowded short trades","prompt":"Which perpetuals do smart Hyperliquid traders have the biggest net-short exposure on right now? Show me the top 10, only count coins where at least 5 cohort accounts have a position."},{"title":"Finding contrarian long opportunities","prompt":"Give me the coins where top Hyperliquid traders are most net-long at this moment — limit it to the top 15 results and require at least 3 traders holding each coin."},{"title":"Checking one-sided consensus trades","prompt":"What are the most one-sided perpetuals trades among elite Hyperliquid accounts right now — coins where almost everyone in the cohort is on the same side? Show me up to 25 results."}],"resultDescription":"A JSON object containing cohort metadata (size, coverage, refresh time), aggregate book stats (net USD, equity, gross long/short), and three ranked lists of perpetual coins: most-net-long, most-net-short, and most-one-sided — each entry including the coin symbol, trader counts on each side, net notional USD, long share percentage, bias label, and 1h/24h flow data where available. Also includes a disclaimer and a confidence rating.","failureModes":["Flow history fields (flow_1h_net_usd, flow_24h_net_usd) return null for the first 24 hours after launch — expected behavior, not an error","min_traders outside 2-50 range or limit outside 1-25 may return a validation error","Payment failure via x402 returns HTTP 402 with no data","Stale snapshot if cohort refresh is delayed — check cohort_refreshed_at timestamp","Empty coin lists if the cohort has no open positions at snapshot time"],"whenToPreferThis":"Choose this endpoint when you need a real-time ranked view of what a curated cohort of top Hyperliquid perpetuals traders are positioned in, including directional bias and notional size. It is distinct from general crypto price feeds or sentiment APIs because it reflects actual on-chain perp positions of identified smart-money accounts, not social sentiment or order book data. Prefer it over generic market data APIs when the question is specifically about smart-money positioning or crowded trades on Hyperliquid.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T12:38:25.991Z","isFirstParty":false,"canonicalSlug":"smartperps-cohort-scan-hyperliquid-smart-trader-position-scanner-a5fd964f"}