{"uid":"cap_J1dhR8aRrwIveDnrb-tBY","slug":"smartperps-by-agentgate-lite-positioning-snapshot-ad420cfb","name":"SmartPerps by AgentGate – Lite Positioning Snapshot","description":"Smart-money positioning for one Hyperliquid perp: how the 120 most profitable Hyperliquid accounts (30-day PnL, public leaderboard, rules-based) are 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://smartperps.agentgate.workers.dev/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)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"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_HVkGQ6oY5HC73OJWlF2Hf","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 real-time smart-money positioning data for a single Hyperliquid perpetual contract, derived from the 120 most profitable traders on the public leaderboard.","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 BTC","prompt":"Before I open a BTC position, tell me how the 120 most profitable Hyperliquid traders are positioned on BTC perps right now — are they leaning long or short, and by how much notional?"},{"title":"ETH perp bias alert for trading bot","prompt":"Check SmartPerps for ETH and tell me the current bias label and net notional — I want to know if it's strong short, lean short, mixed, lean long, or strong long before my bot executes."},{"title":"Monitoring altcoin smart-money shifts","prompt":"What's the smart-money positioning snapshot for HYPE perps on Hyperliquid right now? I want to see how many top traders are long vs short and what the coverage confidence looks like."}],"resultDescription":"A JSON object containing: bias label (strong_long/lean_long/mixed/lean_short/strong_short), trader counts long and short, long/short/net notional in USD, long share of notional and traders as percentages, 1h and 24h net notional flow, snapshot timestamp and age in seconds, cohort size and coverage percentage, confidence level, mark price, and a plain-language bias note.","failureModes":["503 Service Unavailable: snapshot is stale or cohort coverage is too low — endpoint is fail-closed and will not return data or charge the caller","Invalid or unrecognized symbol ticker returns an error response","Network or worker timeout if Hyperliquid data source is temporarily unreachable","flow_1h_net_usd and flow_24h_net_usd may be null if historical flow data is not yet available for the symbol"],"whenToPreferThis":"Use this endpoint when you need a fast, pre-computed smart-money sentiment signal for a specific Hyperliquid perpetual and want a structured bias label plus notional breakdown without building your own leaderboard scraper. It is especially valuable for trading agents that need a reliable, fail-closed data source — stale data is refused rather than silently served. Prefer this over raw exchange APIs when you want the 120-trader cohort already filtered, aggregated, and bias-classified in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:37:02.550Z","isFirstParty":false,"canonicalSlug":"smartperps-by-agentgate-lite-positioning-snapshot-ad420cfb"}