# Hyperliquid Wallet Portfolio Snapshot API

> Hyperliquid Wallet Portfolio Snapshot 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-14).

Returns all open DEX positions for a given Hyperliquid wallet address, including side, notional value, leverage, and long/short exposure across every market

## Facts

- Endpoint: GET https://whaletape.xyz/whale/:address
- 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/hyperliquid-wallet-portfolio-snapshot-api-b8b4acd7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ijLP3H-WS4UcucrJp9RBp

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-wallet-portfolio-snapshot-api-b8b4acd7
```

Example prompt: Pull up all the open Hyperliquid positions for wallet 0x1234abcd...5678 — I want to see every market they're trading, which side they're on, their leverage, and total notional exposure.

## When to prefer this

Use this endpoint when you need a complete snapshot of a single wallet's current open positions across all Hyperliquid markets in one call. Prefer this over flow or leaderboard endpoints when the question is 'what does this specific address hold right now' rather than 'what is the market doing' or 'where is smart money flowing'.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty result
- Wallet with no open positions returns an empty positions array
- Address not found on Hyperliquid returns a 404 or empty response
- Network or upstream Hyperliquid API unavailability causes a timeout or 503
- Payment failure (x402) blocks the request if 0.1 USDC is not provided

## How this service works

Everything one Hyperliquid wallet holds right now, across every dex: open positions, side, notional, leverage and long/short exposure. Point it at any address

## Output

A structured list of all open positions held by the queried wallet across every Hyperliquid DEX market, including the market name, position side (long/short), notional value in USD, leverage multiplier, and gross long/short exposure figures.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-wallet-portfolio-snapshot-api-b8b4acd7/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)