# SmartPerps Cohort Scan — Hyperliquid Smart Trader Position Scanner > SmartPerps Cohort Scan — Hyperliquid Smart Trader Position Scanner is a paid API for AI agents from api.youraitools.co, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-23). 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. ## Facts - Endpoint: GET https://api.youraitools.co/smartperps/v1/scan?utm_source=zero.xyz - Price: $0.03/call - Payment: x402 - Status: unknown - Last checked: 2026-10-23 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/smartperps-cohort-scan-hyperliquid-smart-trader-position-scanner-a5fd964f - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_82clAJXASI_HsV0cNS8cZ Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability smartperps-cohort-scan-hyperliquid-smart-trader-position-scanner-a5fd964f ``` Example prompt: 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. ## When to prefer this 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. ## Known failure modes - 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 ## How this service works 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. ## Output 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. ## Request schema (JSON Schema) ```json { "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" } } } } } } } ``` ## Response schema (JSON Schema) ```json { "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": … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/smartperps-cohort-scan-hyperliquid-smart-trader-position-scanner-a5fd964f/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from api.youraitools.co](https://www.zero.xyz/host/api.youraitools.co/llms.txt)