# CryptoPulse Whale Positions Tracker

> CryptoPulse Whale Positions Tracker is a paid API for AI agents from cryptopulse.theaslangroupllc.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-13).

Returns current perpetual futures positions for a given on-chain wallet address, including leverage, liquidation price, unrealized PnL, and net directional skew.

## Facts

- Endpoint: GET https://cryptopulse.theaslangroupllc.com/api/whale-positions?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cryptopulse-whale-positions-tracker-4c581373
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HQVdfq4fVKL2SDPC0Z3Nf

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 cryptopulse-whale-positions-tracker-4c581373
```

Example prompt: Can you pull up the current whale positions for wallet 0x1234abcd...? I want to see if they're net long or short, what leverage they're running, and their liquidation prices.

## When to prefer this

Use this endpoint when you need real-time on-chain perpetual futures position data for a specific wallet, particularly for whale tracking, liquidation risk monitoring, or market sentiment analysis derived from large trader behavior on Hyperliquid. Prefer this over exchange REST APIs or aggregators when you need deterministic, chain-stamped position data tied to a specific address rather than aggregate market statistics.

## Known failure modes

- Missing or malformed wallet address returns a validation error
- Wallet address with no open positions returns an empty positions array
- Non-existent or zero-activity address may return null or empty account value
- Network or chain latency may cause stale or temporarily unavailable data
- Invalid address format (not 0x-prefixed or wrong length) returns a bad request error

## How this service works

Full perp positions for any Hyperliquid wallet. Answers "what is this whale holding right now", "is this trader net long or short", "where does their position get liquidated". Every Hyperliquid account is public on-chain state, so you get the exact book for any address: per position coin, side, size, entry price, notional, unrealized PnL, leverage and liquidation price, plus account value and net long/short skew. The raw material for copy-trade and contrarian signals. Deterministic, no LLM.

## Output

Returns a JSON object containing the wallet's net directional skew (long/short), a list of individual perpetual positions each with coin, side, leverage, liquidation price, unrealized PnL, and position value in USD, plus total account value in USD and position count. Results are deterministic and reflect current on-chain state.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "address"
 ],
 "properties": {
  "address": {
   "type": "string",
   "description": "the wallet to inspect (required, 0x...)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "net_skew": "long",
  "positions": [
   {
    "coin": "BTC",
    "side": "long",
    "leverage": 5,
    "liquidation_px": 41200,
    "unrealized_pnl": 140000,
    "position_value_usd": 5200000
   }
  ],
  "deterministic": true,
  "position_count": 3,
  "account_value_usd": 214000000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cryptopulse-whale-positions-tracker-4c581373/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cryptopulse.theaslangroupllc.com](https://www.zero.xyz/host/cryptopulse.theaslangroupllc.com/llms.txt)