# WhaleTape Hyperliquid Whale Position Lookup

> WhaleTape Hyperliquid Whale Position Lookup is a paid API for AI agents from whaletape.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns live on-chain position data for a specific Hyperliquid wallet address, including long/short exposure, leverage, entry price, notional size, and unrealized PnL.

## Facts

- Endpoint: GET https://whaletape.xyz/whale/%7Baddress%7D
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/whaletape-hyperliquid-whale-position-lookup-7c31887a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-WKdlD7biu6B-96JFC6UC

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 whaletape-hyperliquid-whale-position-lookup-7c31887a
```

Example prompt: Pull up the current Hyperliquid positions for whale address 0xAbCd1234... — I want to see their long/short exposure, which coins they're trading, leverage, and unrealized PnL right now.

## When to prefer this

Use this endpoint when you need real-time position data for a specific known wallet address on Hyperliquid. Prefer this over broader market signal endpoints when the goal is to track a particular trader or whale rather than scan across markets. It is the right choice for copy-trading logic, wallet monitoring, or due diligence on a specific address.

## Known failure modes

- Invalid or malformed wallet address returns empty positions array or error
- Address with no open Hyperliquid positions returns zero exposure and empty array
- Rate limiting or payment failure (402) if USDC payment not attached
- Hyperliquid on-chain data delay may cause slight staleness during high-throughput periods
- Non-Hyperliquid addresses (e.g., Ethereum mainnet wallets with no Hyperliquid activity) return no data

## 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

Returns a JSON object with the wallet address, aggregated long and short USD exposure, an array of individual open positions (each with coin, side, entry price, leverage, notional size, and unrealized PnL), total open position count, and number of DEXes consulted.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "positions open right now, per dex; public on-chain Hyperliquid data",
  "address": "0x0000000000000000000000000000000000000000",
  "exposure": {
   "long": 1500000,
   "short": 0
  },
  "positions": [
   {
    "coin": "BTC",
    "side": "long",
    "entry_px": 100000,
    "leverage": 5,
    "notional": 1500000,
    "unrealized_pnl": 25000
   }
  ],
  "open_positions": 1,
  "dexes_consultados": 3
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/whaletape-hyperliquid-whale-position-lookup-7c31887a/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)