# Hyperliquid Smart Money Whale Positioning by Market

> Hyperliquid Smart Money Whale Positioning by Market is a paid API for AI agents from whaletape.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns aggregated long vs short notional for each Hyperliquid market based on profitable leaderboard traders, giving a crowd-vs-whales directional read per asset.

## Facts

- Endpoint: GET https://whaletape.xyz/whales
- Price: $0.01/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-whale-positioning-by-market-274b5ab3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RIyj5oy9on9Fo3TjFDeuu

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-whale-positioning-by-market-274b5ab3
```

Example prompt: Show me which side the profitable Hyperliquid leaderboard traders are on right now — I want to see the aggregated long vs short notional for each market so I can spot where whales are positioned.

## When to prefer this

Use this endpoint when you want a quick directional read on where profitable traders are positioned across all Hyperliquid markets in a single call, without needing to pull individual wallet data. Prefer this over per-wallet endpoints when doing broad market scanning, building sentiment dashboards, or comparing whale bias against retail positioning.

## Known failure modes

- API returns stale data if upstream Hyperliquid data feed is delayed
- Empty or minimal result set if no qualifying leaderboard traders have open positions
- HTTP 402 payment required if x402 payment header is missing or insufficient
- Rate limiting or access denial if called too frequently without valid credentials
- Network timeout if whaletape.xyz data pipeline is under load

## How this service works

Which side the profitable leaderboard traders are on, per market: aggregated long vs short notional. The crowd-versus-whales read in one number

## Output

A list of Hyperliquid markets with aggregated long and short notional values from profitable leaderboard traders, enabling a directional 'smart money vs crowd' comparison per asset. The response gives a single number or ratio per market reflecting net whale bias.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "updated_at": "2026-08-23T01:39:43Z",
  "exposure_by_market": {
   "XRP": {
    "long": 66050533.7,
    "short": 8683478.4
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-smart-money-whale-positioning-by-market-274b5ab3/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)