# Vextorium Hyperliquid Whale Positioning

> Vextorium Hyperliquid Whale Positioning is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-13).

Returns long/short positioning data for the 150 largest actively trading Hyperliquid accounts, including notional exposure, bias, whale counts, average entry prices, and unrealized PnL per coin.

## Facts

- Endpoint: POST https://api.vextorium.com/hyperliquid-ballenas-pago?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-hyperliquid-whale-positioning-2942e4fb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4x1bogR96EZ7t3tMq57db

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 vextorium-hyperliquid-whale-positioning-2942e4fb -d '<json body>'
```

Example prompt: Show me how the top 150 Hyperliquid whale accounts are positioned on BTC — I want to see the long and short notional, how many whales are on each side, their average entry, and the unrealized PnL.

## When to prefer this

Choose this endpoint when you need real-time whale positioning intelligence specifically on Hyperliquid perpetuals — including directional bias, notional exposure size, and unrealized PnL for the largest accounts. Prefer this over generic market sentiment tools when you want on-chain, account-level data rather than order book snapshots or social sentiment.

## Known failure modes

- Invalid or unrecognized coin symbol returns null or empty monedas array
- Network timeout if Hyperliquid data feed is delayed
- Partial data if fewer than 150 accounts are actively trading at query time
- Missing fields (null values) for coins with insufficient whale activity
- Request body missing required fields returns validation error

## How this service works

How the 150 largest actively trading Hyperliquid accounts are positioned: per coin long and short notional, bias, number of whales on each side, average entry and unrealized PnL; or, for one coin, every whale position with entry, liquidation and leverage.

## Output

Returns an array of coins, each with: long notional USD, short notional USD, long bias percentage, number of whale accounts long, number of whale accounts short, average entry price, and unrealized PnL USD. Also includes total positions analyzed and a data source reference. When a specific coin is queried, returns detailed data for that single coin.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [],
     "properties": {
      "limite": {
       "type": "integer"
      },
      "moneda": {
       "type": "string"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "nota": {
       "type": [
        "string",
        "null"
       ]
      },
      "fuente": {
       "type": [
        "string",
        "null"
       ]
      },
      "monedas": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "moneda": {
          "type": [
           "null",
           "string"
          ]
         },
         "entrada_media": {
          "type": [
           "null",
           "number"
          ]
         },
         "ballenas_cortas": {
          "type": [
           "null",
           "number"
          ]
         },
         "ballenas_largas": {
          "type": [
           "null",
           "number"
          ]
         },
         "sesgo_largo_pct": {
          "type": [
           "null",
           "number"
          ]
         },
         "nocional_corto_usd": {
          "type": [
           "null",
           "number"
          ]
         },
         "nocional_largo_usd": {
          "type": [
           "null",
           "number"
          ]
         },
         "pnl_no_realizado_usd": {
          "type": [
           "null",
           "number"
          ]
         }
        }
       }
      },
      "posiciones_analizadas": {
       "type": [
        "number",
        "null"
       ]
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-hyperliquid-whale-positioning-2942e4fb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)