{"uid":"cap_L92oSDVBCIDiblUtfne8e","slug":"hyperliquid-smart-money-data-api-natural-language-market-q-a-52bcf662","name":"Hyperliquid Smart Money Data API – Natural Language Market Q&A","description":"Live whale positioning, OI/funding signals and AI market briefs from Hyperliquid. Pay per request (x402) or unlock the Pro dashboard for 60 minutes.","url":"https://whaletape.xyz/ask","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","required":["q"],"properties":{"q":{"type":"string","maxLength":300,"description":"natural-language question (any language; answered in kind)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"model":"claude-opus-5","answer":"Whales are 88% long XRP ($66M vs $8.7M short)...","cached":false,"question":"what is the whale bias on XRP?","updated_at":"2026-08-23T01:39:43Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8i-VJ2A9kPWAdvYmbslOc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Answers a single natural-language question about the current Hyperliquid market using a live data snapshot","exampleAgentPrompt":"Which assets are smart money whales most aggressively long on Hyperliquid right now, and is the funding rate elevated on any of them?","exampleUseCases":[{"title":"Pre-trade smart money check","prompt":"Before I open a BTC long on Hyperliquid, can you tell me what the whales are doing right now — are they net long or short, and what's the current funding rate?"},{"title":"Cross-market rotation screening","prompt":"Is there any asset on Hyperliquid right now where big money just flipped direction and funding is stretched — I want to know where a squeeze might be building."},{"title":"Non-English market briefing","prompt":"¿Qué están haciendo las ballenas en Hyperliquid ahora mismo con ETH? Quiero saber su posición y la tasa de financiamiento actual."}],"resultDescription":"A natural-language answer (in the same language as the question) grounded in a live Hyperliquid market snapshot, covering whale positions, funding rates, open interest, and directional signals as relevant to the query.","failureModes":["Question exceeds 300 characters — truncate or rephrase","Question is too vague to resolve against live data — returns a best-effort or clarifying response","Payment not included or insufficient — 402 Payment Required response","Market data snapshot temporarily unavailable — may return stale or error response","Question about a non-Hyperliquid asset or off-topic domain — may return no useful answer"],"whenToPreferThis":"Use this endpoint when you need a fast, plain-English (or any-language) answer to a specific market question grounded in live Hyperliquid data, without parsing raw JSON feeds. Prefer this over the structured endpoints when the question is exploratory, ad hoc, or needs to be relayed directly to a non-technical user. If you need structured data for programmatic downstream processing, use the dedicated snapshot or flow endpoints instead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:44:39.127Z","isFirstParty":false}