{"uid":"cap_NOC3CdHNa-Yy3iAqsP4IT","slug":"hyperliquid-smart-money-whale-events-cursor-api-d88e5017","name":"Hyperliquid Smart Money Whale Events Cursor API","description":"Only what changed since your last call: pass the cursor you got back and receive just the new whale events, never the whole base again. Built for agents that poll on a schedule and pay per request","url":"https://whaletape.xyz/pulse","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"count":1,"events":[{"ts":1788010123,"coin":"ETH","side":"short","event":"increased","address":"0x5b5d...","notional":104287584.4}],"truncated":false,"next_cursor":1788010123}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cR-HepMX9fBvIRsvYf8bu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns only new whale events on Hyperliquid since the last poll, using a cursor for incremental updates","exampleAgentPrompt":"Check for any new Hyperliquid whale events since my last poll and give me only what's changed — use the cursor from the previous response so we don't re-fetch everything.","exampleUseCases":[{"title":"Scheduled whale activity monitor","prompt":"Every 5 minutes, check for new Hyperliquid whale events using my last cursor and alert me if any large position changes have appeared since my previous check."},{"title":"Real-time smart money dashboard feed","prompt":"Poll Hyperliquid for the latest whale events incrementally — pass the cursor from the last call so my dashboard only processes new activity, not the full history again."},{"title":"Agent-driven trading signal pipeline","prompt":"Fetch only the new whale events on Hyperliquid since my last cursor position and feed them into my signal pipeline to look for emerging large-player positioning trends."}],"resultDescription":"A delta payload containing only whale events that occurred after the provided cursor position — new smart money activity on Hyperliquid perp markets — plus an updated cursor value to use on the next poll. No repeated baseline data is returned.","failureModes":["Invalid or expired cursor returns error or full dataset reset","No new events since last cursor returns empty result set","Rate limiting if polling too aggressively","Service unavailability returns HTTP 5xx","Missing cursor parameter may return unexpected results"],"whenToPreferThis":"Choose this endpoint when you are polling Hyperliquid whale data on a schedule and want to minimize bandwidth and cost by receiving only new events since your last call. It is ideal for agents that run on a timer and must avoid redundant baseline reloads. Prefer sibling endpoints for full snapshots, market-wide overviews, or liquidation level lookups.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:00:31.150Z","isFirstParty":false}