{"uid":"cap_ng_1pFcQMmwW9he38YP7E","slug":"smartperps-coin-bias-hyperliquid-perpetuals-sentiment-eda576c8","name":"SmartPerps Coin Bias — Hyperliquid Perpetuals Sentiment","description":"Smart money tracker API (Hyperliquid). Full smart-money positioning for one Hyperliquid perp from the top-120 30-day-PnL cohort: lite plus 1h/4h/24h flows, average entry per side vs mark, average leverage, uPnL per side, concentration, liquidation price bands by distance from mark (count and notional per band, never per account) and the 10 largest cohort positions (truncated addresses, no liquidation price). Fail-closed. Not financial advice. Past performance does not guarantee future results.","url":"https://api.youraitools.co/smartperps/v1/coin?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":["symbol"],"properties":{"symbol":{"type":"string","description":"Hyperliquid perp ticker, e.g. BTC, ETH, SOL, HYPE, kPEPE (BTC-PERP, ETH-USD, SOLUSDT accepted)"}},"description":"Search intents: smart money positioning, hyperliquid top traders, whale flows, liquidation levels, trader leverage, smart money entries"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"bias":"strong_short","tier":"coin","flows":{"1h":null,"4h":null,"24h":null},"cohort":{"size":120,"covered":120,"coverage_pct":100,"cohort_refreshed_at":"2026-10-23T01:08:26.080Z"},"symbol":"ETH","bias_note":"Most of the cohort's notional and most cohort traders in this coin are short.","checked_at":"2026-10-23T01:08:30.196Z","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.","mark_price":2389,"snapshot_at":"2026-10-23T01:08:26.080Z","avg_leverage":12.84,"traders_long":10,"top_positions":[{"side":"short","size":106464.1028,"margin":"cross","address":"0x5b5d…c060","leverage":5,"entry_price":2322.73,"notional_usd":254342742,"trader_30d_pnl_usd":114316598,"unrealized_pnl_usd":-7054831,"cohort_rank_30d_pnl":1},{"side":"short","size":66302.7619,"margin":"cross","address":"0xb83d…6e36","leverage":5,"entry_price":2375.32,"notional_usd":158397298,"trader_30d_pnl_usd":102801123,"unrealized_pnl_usd":-906592,"cohort_rank_30d_pnl":2}],"traders_short":40,"avg_entry_long":2454.489627,"snapshot_age_s":4,"sources_failed":[],"avg_entry_short":2381.656074,"net_notional_usd":-755197408,"long_notional_usd":62204218,"concentration_note":null,"short_notional_usd":817401626,"liquidation_clusters":{"longs":[{"price_to":2389,"positions":0,"price_from":2341,"within_pct":"0-2","notional_usd":0},{"price_to":2341,"positions":0,"price_from":2270,"within_pct":"2-5","notional_usd":0},{"price_to":2270,"positions":0,"price_from":2150,"within_pct":"5-10","notional_usd":0}],"shorts":[{"price_to":2437,"positions":0,"price_from":2389,"within_pct":"0-2","notional_usd":0},{"price_to":2508,"positions":0,"price_from":2437,"within_pct":"2-5","notional_usd":0},{"price_to":2628,"positions":2,"price_from":2508,"within_pct":"5-10","notional_usd":null,"notional_withheld":"fewer than 3 positions"}],"bands_note":"Bands by distance of the liquidation price from mark (longs below, shorts above). Notional is withheld for bands with fewer than 3 positions so no band maps to one account.","no_liquidation_price_usd":4577002},"entry_vs_mark_long_pct":-2.67,"long_share_traders_pct":20,"entry_vs_mark_short_pct":-0.31,"long_share_notional_pct":7.1,"unrealized_pnl_long_usd":-1704791,"unrealized_pnl_short_usd":-2516812,"largest_position_share_pct":28.9}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_I_AKLchMolX-N0BZjsyeD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the directional bias (long/short), confidence, top positions, and liquidation clusters for a specific Hyperliquid perpetual futures ticker based on a tracked cohort of top traders","exampleAgentPrompt":"What's the current SmartPerps bias for ETH on Hyperliquid — are the top traders net long or short, and how confident is the signal?","exampleUseCases":[{"title":"Pre-trade sentiment check on BTC","prompt":"Before I open a BTC perp position on Hyperliquid, tell me what the top traders are doing right now — are they mostly long or short, what's the confidence, and how much notional is on each side?"},{"title":"Monitor SOL smart money exposure","prompt":"Check the SmartPerps cohort bias for SOL perps on Hyperliquid — I want to know the net notional, average leverage, and whether there are any big liquidation clusters nearby."},{"title":"Research HYPE futures top positions","prompt":"Pull the top trader positions for HYPE perpetuals on Hyperliquid, including their 30-day PnL, side, and how far they are from liquidation."}],"resultDescription":"Returns a JSON object containing: directional bias label (e.g. strong_short), confidence level (high/medium/low), a bias_note explaining the reading, current mark price, average leverage of the cohort, counts of long and short traders, long/short/net notional USD, top individual positions with address, side, size, entry price, leverage, unrealized PnL, 30-day PnL, and liquidation distance, plus liquidation cluster breakdowns by proximity bucket. Also includes cohort metadata (size, coverage, refresh time) and snapshot age.","failureModes":["Invalid or unrecognized ticker symbol returns an error or empty result","Symbol not traded on Hyperliquid perps market returns no data","Stale snapshot if cohort refresh is delayed (snapshot_age_s will be elevated)","sources_failed array may indicate partial data if some data sources were unavailable","Payment failure via x402 if USDC balance is insufficient (HTTP 402)","Rate limiting if too many requests in a short window"],"whenToPreferThis":"Use this endpoint when you need real-time directional sentiment and position data for a specific Hyperliquid perpetual futures market sourced from a tracked cohort of top-performing traders. It is distinctly useful for on-chain smart-money analysis — not just open interest from exchange APIs — because it surfaces individual top-trader positions, 30-day PnL rankings, leverage, and liquidation proximity. Prefer it over generic exchange APIs when you want cohort-level behavioral intelligence rather than raw order book or funding rate data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T12:42:29.667Z","isFirstParty":false,"canonicalSlug":"smartperps-coin-bias-hyperliquid-perpetuals-sentiment-eda576c8"}