{"uid":"cap_LZ_PhnBCfRQz1HphNZhL2","slug":"hyperliquid-smart-money-whale-events-api-567131a3","name":"Hyperliquid Smart Money Whale Events API","description":"What the profitable whales just did, not only what they hold: opened, added, reduced, flipped or closed. Built from our own position history, with the last 3 hours served when the current cycle is quiet","url":"https://whaletape.xyz/whales/events","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"events":[{"coin":"BTC","side":"long","event":"opened","address":"0x0000000000000000000000000000000000000000","entry_px":77000,"leverage":40,"notional":9700000,"roi_week":1.82,"roi_month":5.75,"liquidation_px":70748}],"updated_at":"2026-08-23T01:39:43Z"}},"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_Uc98si94LHGmmSIdvqsci","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns recent trading actions (opened, added, reduced, flipped, closed) by profitable whale wallets on Hyperliquid since the last cycle","exampleAgentPrompt":"Pull the latest smart money events from Hyperliquid — show me what profitable whales just did: which positions they opened, added to, reduced, flipped, or closed since the last cycle.","exampleUseCases":[{"title":"Spot whale position flips in real time","prompt":"Check what profitable whales just did on Hyperliquid — specifically any positions they've flipped or newly opened in the last cycle, so I can see if smart money changed direction."},{"title":"Validate trade idea against whale activity","prompt":"I'm thinking of going long ETH on Hyperliquid — can you check what the profitable whale wallets have been doing with ETH positions recently? Did they open, add, or reduce?"},{"title":"Build smart money signal for trading bot","prompt":"Fetch the latest whale events on Hyperliquid so my bot can see which assets smart money has opened or closed positions on since the last update cycle."}],"resultDescription":"A list of recent trading events by profitable whale wallets on Hyperliquid, each event describing the action type (opened, added, reduced, flipped, or closed), the asset involved, position side, and notional size — derived from whaletape's own position history tracking across cycles.","failureModes":["Payment not attached or insufficient — 402 response requiring x402 USDC payment","No events in current cycle — empty result if no whale activity since last snapshot","Rate limiting — too many requests in short succession","Service unavailable — upstream Hyperliquid data temporarily inaccessible"],"whenToPreferThis":"Choose this endpoint when you need to know what smart money actually DID (actions taken) rather than what they currently hold. It is distinct from a portfolio/holdings snapshot — it surfaces directional signals like flips, opens, and closes since the last cycle, making it ideal for momentum and signal detection workflows rather than static portfolio analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:51:02.618Z","isFirstParty":false}