# Hyperliquid Smart Money Whale Events API

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

Returns recent trading actions (opened, added, reduced, flipped, closed) by profitable whale wallets on Hyperliquid since the last cycle

## Facts

- Endpoint: GET https://whaletape.xyz/whales/events
- Price: $0.02/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-events-api-567131a3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LZ_PhnBCfRQz1HphNZhL2

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-events-api-567131a3
```

Example prompt: Pull the latest smart money events from Hyperliquid — show me what profitable whales just did: which positions they opened, added to, reduced, flipped, or closed since the last cycle.

## When to prefer this

Choose this endpoint when you need to know what smart money actually DID (actions taken) rather than what they currently hold. It is distinct from a portfolio/holdings snapshot — it surfaces directional signals like flips, opens, and closes since the last cycle, making it ideal for momentum and signal detection workflows rather than static portfolio analysis.

## Known failure modes

- Payment not attached or insufficient — 402 response requiring x402 USDC payment
- No events in current cycle — empty result if no whale activity since last snapshot
- Rate limiting — too many requests in short succession
- Service unavailable — upstream Hyperliquid data temporarily inaccessible

## How this service works

What the profitable whales just did, not only what they hold: opened, added, reduced, flipped or closed. Built from our own position history, with the last 3 hours served when the current cycle is quiet

## Output

A list of recent trading events by profitable whale wallets on Hyperliquid, each event describing the action type (opened, added, reduced, flipped, or closed), the asset involved, position side, and notional size — derived from whaletape's own position history tracking across cycles.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "events": [
   {
    "coin": "BTC",
    "side": "long",
    "event": "opened",
    "address": "0x0000000000000000000000000000000000000000",
    "entry_px": 77000,
    "leverage": 40,
    "notional": 9700000,
    "roi_week": 1.82,
    "roi_month": 5.75,
    "liquidation_px": 70748
   }
  ],
  "updated_at": "2026-08-23T01:39:43Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-smart-money-whale-events-api-567131a3/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)