{"uid":"cap_Fyrg86s6nMATAOjwGLqh5","slug":"smartperps-by-agentgate-f74735bd","name":"SmartPerps by AgentGate","description":"Crypto smart money tracker API. Smart-money positioning for one Hyperliquid perp: how a rules-based cohort of the 120 Hyperliquid accounts with the highest 30-day PnL (public leaderboard) is positioned right now: traders long vs short, long/short/net notional in USD, bias (strong long / lean long / mixed / lean short / strong short), 1h and 24h net notional flow, snapshot age, cohort coverage. Fail-closed: stale or low-coverage snapshots are refused (503, not charged). Not financial advice.","url":"https://api.youraitools.co/smartperps/v1/lite?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 tracker, hyperliquid whales, top trader positions, smart money bias, crypto whale tracking, long short ratio"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"bias":{"type":"string"},"tier":{"type":"string"},"cohort":{"type":"object"},"symbol":{"type":"string"},"bias_note":{"type":"string"},"checked_at":{"type":"string"},"confidence":{"type":"string"},"disclaimer":{"type":"string"},"mark_price":{"type":"number"},"snapshot_at":{"type":"string"},"traders_long":{"type":"number"},"traders_short":{"type":"number"},"snapshot_age_s":{"type":"number"},"sources_failed":{"type":"array"},"flow_1h_net_usd":{},"flow_24h_net_usd":{},"net_notional_usd":{"type":"number"},"long_notional_usd":{"type":"number"},"short_notional_usd":{"type":"number"},"long_share_traders_pct":{"type":"number"},"long_share_notional_pct":{"type":"number"}}}}}}},"responseSchema":{"type":"json","example":{"bias":"strong_short","tier":"lite","cohort":{"size":120,"covered":120,"coverage_pct":100,"cohort_refreshed_at":"2026-10-23T01:08:26.080Z"},"symbol":"BTC","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":81380,"snapshot_at":"2026-10-23T01:08:26.080Z","traders_long":8,"traders_short":37,"snapshot_age_s":4,"sources_failed":[],"flow_1h_net_usd":null,"flow_24h_net_usd":null,"net_notional_usd":-820640322,"long_notional_usd":23033122,"short_notional_usd":843673444,"long_share_traders_pct":17.8,"long_share_notional_pct":2.7}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cjJtGtsJteXvbtagIWENK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current positioning of the 120 most profitable Hyperliquid traders (by 30-day PnL) for a given perpetual futures symbol, including long/short breakdown, net notional USD, bias classification, and 1h/24h flow data.","exampleAgentPrompt":"What's the current smart money positioning on BTC perps — are the top 120 Hyperliquid traders mostly long or short, and what's the net notional bias?","exampleUseCases":[{"title":"Pre-trade sentiment check on ETH","prompt":"Before I open a long on ETH perps, tell me how the top Hyperliquid traders by PnL are positioned right now — are they mostly long or short, and what's the net notional?"},{"title":"Monitor SOL smart money bias shift","prompt":"Check the current SmartPerps positioning for SOL on Hyperliquid — I want to know the bias classification, how many of the top traders are short, and whether there's been any notable 1-hour flow change."},{"title":"Scan HYPE perp for strong directional consensus","prompt":"Pull the smart money snapshot for HYPE perps — I'm looking for whether confidence is high and if the bias is strong long or strong short among the top 120 Hyperliquid accounts."}],"resultDescription":"Returns a JSON object containing: the bias label (strong_long, lean_long, mixed, lean_short, strong_short), a plain-English bias_note, counts of traders long vs short, long/short/net notional in USD, long share of notional and traders as percentages, 1h and 24h net flow in USD (may be null), current mark price, snapshot timestamp, snapshot age in seconds, cohort size and coverage percentage, confidence level (high/medium/low), a disclaimer, and any failed sources. If the snapshot is stale or coverage is too low, the endpoint returns a 503 (fail-closed) and does not charge.","failureModes":["503 Service Unavailable: snapshot is stale or cohort coverage is below threshold — request is refused and not charged","Invalid or unrecognized symbol ticker returns an error","Network timeout reaching Hyperliquid leaderboard data source","Partial cohort coverage resulting in reduced confidence level","flow_1h_net_usd and flow_24h_net_usd may be null if insufficient flow history exists"],"whenToPreferThis":"Use SmartPerps when you need a fast, rules-based, real-time read on how the most profitable Hyperliquid accounts are positioned on a specific perp — particularly useful for pre-trade sentiment checks, directional bias signals, or monitoring smart money flow. Prefer this over generic sentiment APIs when the target market is Hyperliquid perpetual futures and you want cohort-based positioning data rather than social or order-book sentiment. The fail-closed design (503 on stale data) makes it suitable for automated agent pipelines where data freshness is critical.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T12:44:34.063Z","isFirstParty":false,"canonicalSlug":"smartperps-by-agentgate-f74735bd"}