# Hyperliquid Smart Money Data API – Natural Language Market Q&A

> Hyperliquid Smart Money Data API – Natural Language Market Q&A is a paid API for AI agents from whaletape.xyz, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-15).

Answers a single natural-language question about the current Hyperliquid market using a live data snapshot

## Facts

- Endpoint: GET https://whaletape.xyz/ask
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-smart-money-data-api-natural-language-market-q-a-52bcf662
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_L92oSDVBCIDiblUtfne8e

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hyperliquid-smart-money-data-api-natural-language-market-q-a-52bcf662
```

Example prompt: Which assets are smart money whales most aggressively long on Hyperliquid right now, and is the funding rate elevated on any of them?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Live whale positioning, OI/funding signals and AI market briefs from Hyperliquid. Pay per request (x402) or unlock the Pro dashboard for 60 minutes.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-smart-money-data-api-natural-language-market-q-a-52bcf662/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from whaletape.xyz](https://www.zero.xyz/host/whaletape.xyz/llms.txt)