{"uid":"cap_LVbdsEUobO-OIoshB-7uo","slug":"hyperliquid-whales-api-klymax402-com-aa5bc525","name":"Hyperliquid Whale Positions API","description":"Get aggregated whale positions on Hyperliquid","url":"https://hyperliquid-whales.api.klymax402.com/api/positions?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":[],"properties":{"coin":{"type":"string","description":"Filter by coin symbol (e.g. BTC, ETH, SOL). Optional — returns all coins if omitted."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"coin":"BTC"}}},"response":{"chain":"hyperliquid","message":"No whale positions found for BTC. Try without a coin filter to see all positions.","results":0,"aggregates":[],"coinFilter":"BTC","totalTraders":10,"tradersWithPositions":0}},"exampleRequest":{"coin":"BTC"},"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.42","successRate":"1.00","reviews":1,"stars":"2.7","state":"rated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WO9ludoNptUUkzBPjMyqn","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns aggregated large-trader (whale) open positions on the Hyperliquid decentralized perpetuals exchange, optionally filtered by coin symbol.","exampleAgentPrompt":"What are the current whale positions on Hyperliquid for BTC? I want to see how big traders are positioned right now.","exampleUseCases":null,"resultDescription":"Returns aggregated whale position data from Hyperliquid, including open positions grouped by coin. When a coin filter is supplied (e.g. BTC), returns only positions for that asset. The response includes details on large-trader positions such as size, direction (long/short), and aggregate metrics across whale accounts.","failureModes":["Invalid coin symbol returns empty results or error","Hyperliquid data unavailable causes upstream fetch failure","Rate limiting or payment failure returns 402 or 429","No whale positions found for a low-liquidity coin returns empty array"],"whenToPreferThis":"Use this endpoint when you need to understand what large traders (whales) are doing on the Hyperliquid perpetuals DEX — especially useful for market sentiment analysis, trading signal generation, or monitoring smart money flows. Prefer this over generic order book endpoints when aggregated whale-level conviction data is specifically needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":2,"lastUsedAt":"2026-08-20T23:12:20.641Z","lastSuccessfullyRanAt":"2026-08-20T23:12:20.641Z","lastHealthCheckAt":"2026-10-22T17:27:00.141Z","isFirstParty":false,"canonicalSlug":"hyperliquid-whales-api-klymax402-com-aa5bc525"}