# Hyperliquid Smart Money Premium Bundle API

> Hyperliquid Smart Money Premium Bundle API is a paid API for AI agents from whaletape.xyz, paid per call via x402, $0.12/call, status unknown (last checked 2026-09-13).

Returns a combined AI market brief, per-market directional bias, largest whale positions, and fresh trading signals for Hyperliquid in a single call

## Facts

- Endpoint: GET https://whaletape.xyz/premium
- Price: $0.12/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-smart-money-premium-bundle-api-39d2bc39
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_D_0Dz6LFHxIwZgcw-aZfa

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-premium-bundle-api-39d2bc39
```

Example prompt: Give me the full Hyperliquid smart money snapshot right now — I want the AI market brief, per-market directional bias, the biggest whale positions, and the latest signals all in one shot.

## When to prefer this

Choose this endpoint when you need a comprehensive, all-in-one Hyperliquid market intelligence snapshot and want to minimize API calls and cost compared to calling the AI brief, bias, whale positions, and signals endpoints separately. Ideal for agents running periodic market checks, dashboard refreshes, or pre-trade decision support where latency and cost efficiency matter. If you only need one specific data type (e.g. funding squeeze detection or a single wallet lookup), use the more targeted sibling endpoints instead.

## Known failure modes

- Payment failure or insufficient USDC balance results in 402 Payment Required
- Hyperliquid data unavailability causes downstream data gaps or partial results
- Rate limiting may return 429 if called too frequently
- Empty signals array if no new signals have been generated recently
- Stale data if underlying Hyperliquid feeds have lag

## How this service works

One call instead of four: AI brief, per-market bias, largest whale positions and fresh signals. Cheaper than buying them separately ($0.16)

## Output

A single JSON response containing: (1) an AI-generated narrative brief summarizing current Hyperliquid market conditions, (2) per-market directional bias indicating bullish or bearish lean, (3) the largest whale positions with notional size and side, and (4) the freshest trading signals from profitable traders — all combined in one payload instead of requiring four separate API calls.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "signals": [],
  "ai_brief": "## Overview\nCrypto funding rates are markedly stretched across altcoins and memes (0.5–1.6% hourly), while index perps ( ...",
  "disclaimer": "educational data and analysis; NOT financial advice",
  "updated_at": "2026-08-23T01:39:43.769674+00:00",
  "ai_brief_at": "2026-08-23T01:34:53.600706+00:00",
  "recommendations": [
   {
    "side": "SHORT",
    "score": -3,
    "symbol": "VVV",
    "funding": 0.0001040384,
    "mark_px": 16.877,
    "reasons": [
     "funding high (+0.0104%/h): long side crowded",
     "whales 100% short ($888,018 total)"
    ],
    "oi_change": 0.0001966955568541902,
    "px_change": 0.0002963489805594479,
    "confidence": "media",
    "day_volume": 19628676.50290999,
    "asset_class": "crypto"
   }
  ],
  "whale_positions": [
   {
    "dex": "native",
    "roe": -0.9668634787,
    "coin": "ETH",
    "name": null,
    "side": "short",
    "size": -42974.8855,
    "address": "0x5b5d51203a0f9079f8aeb098a6523a13f298c060",
    "entry_px": 2033.48,
    "leverage": 5,
    "notional": 104287584.391705,
    "margin_used": 20857516.878341,
    "max_leverage": 15,
    "leverage_type": "cross",
    "liquidation_px": 3835.4670080535,
    "unrealized_pnl": -16898636.442468,
    "funding_all_time": -14675996.585308,
    "funding_since_open": -471866.583737
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-smart-money-premium-bundle-api-39d2bc39/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)
