# AgentFeed – Hyperliquid Whale Perp Positions

> AgentFeed – Hyperliquid Whale Perp Positions is a paid API for AI agents from x402.ochinimus.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-13).

Returns aggregated open perpetual futures positions of the top 250 Hyperliquid accounts by account value, including notional size, PnL, liquidation distance, and net exposure per coin.

## Facts

- Endpoint: GET https://x402.ochinimus.app/api/hl-whales?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentfeed-hyperliquid-whale-perp-positions-2077146b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VsrQK6NT0GdSOFQeUQmUR

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 agentfeed-hyperliquid-whale-perp-positions-2077146b
```

Example prompt: What are the top Hyperliquid whales currently long and short on — pull their aggregated perp positions, notional sizes, unrealized PnL, and how close any of them are to liquidation right now.

## When to prefer this

Use this endpoint when you need real-time aggregated positioning data specifically from Hyperliquid's top traders by account value, including liquidation proximity metrics. Prefer this over generic market data feeds when the goal is to understand large-player perp exposure, crowding risk, or liquidation cascade potential on Hyperliquid rather than just price or funding data.

## Known failure modes

- Upstream Hyperliquid API unavailable — may return stale or error response
- Payment not confirmed — returns 402 if USDC micropayment over x402 fails
- Data freshness lag — whale list refreshes periodically so positions may be seconds to minutes old
- Empty coin list if no whales hold open perps at query time

## How this service works

Hyperliquid whales: the open perp positions of the largest Hyperliquid accounts aggregated per coin: net long or short USD, account counts, size-weighted entries, notional-weighted distance to liquidation, notional within 10% of liquidation and uPnL. Use when you need to answer: How are the biggest Hyperliquid traders positioned, and where are their liquidations? With coin=BTC: whale liquidation…

## Output

A JSON object containing per-coin aggregated data for the top 250 Hyperliquid accounts: number of long and short accounts, average entry price, total notional USD, unrealized PnL, average liquidation distance percentage, amount of notional within 10% of liquidation, and the mark price. Also includes metadata about when the whale list was refreshed, total accounts scanned, and accounts with active positions.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "as_of": "2026-10-12T07:02:18.323Z",
   "coins": [
    {
     "coin": "ETH",
     "long": {
      "accounts": 14,
      "avg_entry_px": 2137.68,
      "notional_usd": 249652710.4,
      "unrealized_pnl_usd": 41986926.96,
      "avg_liq_distance_pct": 42.87,
      "within_10pct_of_liq_usd": 0
     },
     "short": {
      "accounts": 16,
      "avg_entry_px": 2407.92,
      "notional_usd": 787635870.47,
      "unrealized_pnl_usd": -49641173.18,
      "avg_liq_distance_pct": 74.32,
      "within_10pct_of_liq_usd": 0
     },
     "mark_px": 2569.9,
     "net_usd": -537983160.07
    }
   ],
   "method": "Open perp positions of the largest Hyperliquid accounts, rea…",
   "sources": [
    "Hyperliquid info API (clearinghouseState, metaAndAssetCtxs)",
    "Hyperliquid leaderboard (stats-data.hyperliquid.xyz)"
   ],
   "whale_list": {
    "from": "largest accounts by account value on the Hyperliquid leaderb…",
    "size": 250,
    "of_rows": 47389,
    "refreshed_at": "2026-10-12T07:02:10.359Z"
   },
   "accounts_scanned": 250,
   "accounts_with_positions": 66
  },
  "paid": true,
  "tool": "get_hl_whales"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentfeed-hyperliquid-whale-perp-positions-2077146b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.ochinimus.app](https://www.zero.xyz/host/x402.ochinimus.app/llms.txt)