{"uid":"cap_t5fLAlmJxIBNpL0iOG9yj","slug":"smartperps-coin-positioning-170b2c15","name":"SmartPerps Coin Positioning","description":"Smart-money positioning on Hyperliquid perps for trading agents: how a rules-based cohort of the 120 most profitable Hyperliquid accounts (30-day PnL, public leaderboard) is positioned in any coin right now: traders long vs short, long/short notional, net bias, 1h/4h/24h net flows, average entry and leverage, liquidation clusters and the largest positions; a market-wide scan of the coins the cohort is most net long, net short and one-sided on; and a live profile of any Hyperliquid account. Public data only, snapshot every 5 minutes, fail-closed. Read-only analytics, paid per call over x402 or with prepaid credits; free preview and remote MCP. Not financial advice. 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.","url":"https://smartperps.agentgate.workers.dev/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":"0x5b5d51203a0f9079f8aeb098a6523a13f298c060","leverage":5,"entry_price":2322.73,"notional_usd":254342742,"liquidation_price":4159.1827146536,"trader_30d_pnl_usd":114316598,"unrealized_pnl_usd":-7054831,"cohort_rank_30d_pnl":1,"liquidation_distance_pct":74.1},{"side":"short","size":66302.7619,"margin":"cross","address":"0xb83de012dba672c76a7dbbbf3e459cb59d7d6e36","leverage":5,"entry_price":2375.32,"notional_usd":158397298,"liquidation_price":4809.4343860862,"trader_30d_pnl_usd":102801123,"unrealized_pnl_usd":-906592,"cohort_rank_30d_pnl":2,"liquidation_distance_pct":101.32}],"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":[{"positions":0,"within_pct":"0-2","notional_usd":0},{"positions":0,"within_pct":"2-5","notional_usd":0},{"positions":0,"within_pct":"5-10","notional_usd":0}],"shorts":[{"positions":0,"within_pct":"0-2","notional_usd":0},{"positions":0,"within_pct":"2-5","notional_usd":0},{"positions":2,"within_pct":"5-10","notional_usd":15529865}],"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_SZl29laAetMj47F1ZFn0Z","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 smart-money positioning analytics for a single Hyperliquid perpetual futures coin, based on the 120 most profitable accounts on the platform.","exampleAgentPrompt":"What is the current smart-money positioning on ETH perps — are the top 120 Hyperliquid traders mostly long or short, and what's the net notional bias?","exampleUseCases":[{"title":"Pre-trade directional bias check","prompt":"Before I open a long on BTC perps, check SmartPerps to see how the most profitable Hyperliquid accounts are positioned on BTC right now — are they net long or short, and what's the leverage they're using?"},{"title":"Liquidation cluster risk scan","prompt":"Pull the SmartPerps data for SOL — I want to see where the liquidation clusters are for the top traders so I know which price levels might cause cascading liquidations."},{"title":"Monitoring smart-money ETH flows","prompt":"Check SmartPerps for ETH and tell me what the 1-hour and 4-hour net flows look like for the smart-money cohort — is there a recent shift in positioning?"}],"resultDescription":"A JSON snapshot (refreshed every 5 minutes) containing: directional bias label (e.g. strong_short), trader counts long and short, long/short/net notional in USD, average entry prices for longs and shorts, average leverage, net flow over 1h/4h/24h windows, liquidation clusters bucketed by proximity to mark price, top individual positions with size/margin/entry/liquidation price/unrealized PnL/cohort rank, mark price, confidence level, cohort coverage stats, and a standard disclaimer.","failureModes":["Symbol not found or unsupported ticker returns an error or empty result","Snapshot may be up to 5 minutes stale if the latest refresh is delayed","Flows for 1h/4h/24h may be null if insufficient historical snapshots exist","Payment failure (x402) if credits are exhausted or payment not accepted","Coin with very few cohort traders may return low confidence or sparse data","Rate limiting if called excessively beyond prepaid credit balance"],"whenToPreferThis":"Use this endpoint when you need real-time smart-money sentiment and positioning data for a specific Hyperliquid perpetual futures market, particularly when directional bias, liquidation risk levels, and top-trader positioning are relevant to a trading or risk decision. Prefer this over generic order-book or funding-rate APIs when you specifically want to know how the 120 most historically profitable Hyperliquid accounts are positioned right now.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:35:00.609Z","isFirstParty":false,"canonicalSlug":"smartperps-coin-positioning-170b2c15"}