{"uid":"cap_I6gn0TJ8QUqWUc_3ssaQy","slug":"hyperliquid-whale-net-positioning-by-coin-b13668d9","name":"Hyperliquid Whale Net Positioning by Coin","description":"Paid token safety / rug-pull checks for AI agents: Solana SPL (/check) and Robinhood Chain ERC-20 (/rh/check). One-sentence verdict + blocking/warnings/unknowns, casino|speculative|legit tier, holder count & concentration, liquidity, 1h volume & buy/sell flow, honeypot/tax or mint/freeze authority, RugCheck/GoPlus cross-checks. $0.01 USDC on Base or Solana via x402. Also: Hyperliquid perp market data for trading agents: funding extremes across all HL perps ($0.002), whale liquidation levels ($0.003), whale net positioning ($0.005), and a one-call LLM-ready market brief ($0.008). Refreshed ~every 3 min from HL public data; every response has generated_at/age_s; stale data is never charged.","url":"https://chiefofstaff-solana.iodized-lemon.workers.dev/hl/whales?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","properties":{"coin":{"type":"string","description":"Optional HL perp ticker, e.g. SOL"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"age_s":41,"by_coin":[{"coin":"BTC","tilt":"net short","n_long":24,"holders":51,"n_short":27,"net_usd":-375300000,"long_usd":385664755,"short_usd":760964000,"avg_leverage":12.3,"gross_pct_of_oi":34.6}],"endpoint":"/hl/whales","generated_at":"2026-10-07T20:00:59Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MrzXjN5fK-QhiAOQc-8xm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns whale net positioning data (long vs short notional, leverage, tilt, gross % of OI) across Hyperliquid perpetual markets, optionally filtered to a specific coin.","exampleAgentPrompt":"What are whales doing on Hyperliquid right now for SOL — are they net long or short, how much notional is on each side, and what's their average leverage?","exampleUseCases":[{"title":"Pre-trade whale sentiment check","prompt":"Before I open a long on SOL perps on Hyperliquid, can you check what the whales are doing — are they net long or short, and how much leverage are they running?"},{"title":"Cross-market whale tilt scan","prompt":"Give me a rundown of whale positioning across all Hyperliquid perps — which coins have the most extreme long or short tilt among big players?"},{"title":"Risk monitoring for trading bot","prompt":"Check the current whale net positioning on Hyperliquid for BTC and tell me the gross percentage of open interest they control and how fresh the data is."}],"resultDescription":"A JSON object containing per-coin whale positioning data: net USD position (positive = net long, negative = net short), long and short notional in USD, number of long/short whale accounts, average leverage, tilt label (net long/net short), gross % of open interest controlled by whales, plus metadata fields generated_at and age_s indicating data freshness. Data is refreshed approximately every 3 minutes; stale data is not charged.","failureModes":["Data older than expected refresh window (age_s high) — endpoint reports age but still returns last known data","Invalid coin ticker returns empty by_coin array or 404","Payment not completed (x402 flow not satisfied) — returns 402 Payment Required with payment instructions","Network timeout to Hyperliquid data source — may return stale or error response"],"whenToPreferThis":"Use this endpoint when you need to understand large-player (whale) directional bias and leverage on Hyperliquid perpetual markets, especially to inform trading decisions or risk management. Prefer this over funding rate or liquidation endpoints when the key question is 'are big players net long or short and by how much?' The optional coin filter allows targeted single-market queries at the same price. At $0.005 USDC per call it is cost-effective for frequent polling by trading agents.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:36:13.197Z","isFirstParty":false,"canonicalSlug":"hyperliquid-whale-net-positioning-by-coin-b13668d9"}