{"uid":"cap_nbDvpoPL9tCFxw74-sLgr","slug":"bykaranteli-hyperliquid-whale-position-events-history-09711672","name":"ByKaranteli Hyperliquid Whale Position Events History","description":"Every recorded position change of the 300 largest Hyperliquid accounts by equity (opened, closed, increased, reduced, flipped) with size before and after, notional changed, entry and liquidation price and leverage, scanned every 5 minutes on our side from 2026-09-02; the free /api/public/hyperliquid-whales returns the live board and only the last 200 events.","url":"https://bykaranteli.com/api/x402/hl-whale-events","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":{"to":{"type":"string","description":"iso, optional"},"from":{"type":"string","description":"iso, optional"},"limit":{"type":"number","description":"number, optional, max 20000"},"symbol":{"type":"string","description":"string, optional coin, e.g. BTC"},"exchange":{"type":"string","description":"string, optional kind filter: opened | closed | increased | reduced | flipped"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"rows":[],"count":500,"dataset":"hl-whale-events"}},"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_DmAZcwaVFZon2ykOsuhjV","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 historical position change events (opens, closes, size changes, flips) for the 300 largest Hyperliquid accounts by equity, recorded every 5 minutes since 2026-09-02, with full trade details.","exampleAgentPrompt":"Pull all BTC position-change events from the top 300 Hyperliquid whale accounts between January 10 and January 15, 2027, limited to 500 results, and only show me events where they opened new positions.","exampleUseCases":[{"title":"Pre-rally whale accumulation research","prompt":"Show me every time a top-300 Hyperliquid account opened or increased a BTC long position in the 48 hours before January 12, 2027 — up to 1000 events, so I can see if whales were accumulating ahead of the move."},{"title":"Leverage and liquidation risk audit","prompt":"Get me the last 200 ETH position events for the biggest Hyperliquid accounts, including their leverage and liquidation prices, so I can assess how much risk is concentrated at the top."},{"title":"Flip-detection for a specific altcoin","prompt":"Find all 'flipped' position events for SOL on Hyperliquid from the whale accounts between December 1 and December 31, 2026 — I want to see when the big players switched from long to short or vice versa."}],"resultDescription":"A JSON object with an 'ok' flag, a 'count' of returned rows, a 'dataset' label ('hl-whale-events'), and a 'rows' array. Each row contains details of a single position change event: the account, coin/symbol, event type (opened/closed/increased/reduced/flipped), position size before and after the event, notional USD amount changed, entry price, liquidation price, leverage used, and a timestamp.","failureModes":["Invalid ISO date strings in from/to params return an error or empty result","Limit exceeding 20000 may be rejected or clamped","Unknown symbol values return empty rows rather than an error","Payment failure (402) if the x402 payment header is missing or insufficient","Rate limiting if called too frequently without valid payment"],"whenToPreferThis":"Choose this endpoint when you need historical depth (back to 2026-09-02) on Hyperliquid whale position changes beyond the last 200 events available on the free board, or when you need to filter by specific coin, event type, or time window with up to 20,000 records per call. Prefer this over the free /api/public/hyperliquid-whales endpoint when doing backtesting, research, or alerting that requires more than the most recent 200 events.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:40:13.444Z","isFirstParty":false}