# Hyperliquid Account Portfolio Lookup

> Hyperliquid Account Portfolio Lookup is a paid API for AI agents from klymax402.com, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-14).

Retrieves the current account state for a Hyperliquid wallet, including open positions, account value, withdrawable balance, and margin usage.

## Facts

- Endpoint: GET https://klymax402.com/api/hl-portfolio/api/account
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-account-portfolio-lookup-9936577d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9Qj-6LakCmFywFrKlA33B

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-account-portfolio-lookup-9936577d
```

Example prompt: Can you pull up the current portfolio state for my Hyperliquid account at 0xABCDEF1234567890abcdef1234567890abcdef12 — I want to see my open positions, account value, and how much I can withdraw?

## When to prefer this

Use this endpoint when you need a real-time snapshot of a specific Hyperliquid perpetuals account — including open positions, margin, and withdrawable balance. Prefer this over generic crypto balance APIs when the user is specifically trading on Hyperliquid. Best suited for portfolio dashboards, risk monitoring agents, or pre-trade margin checks on the Hyperliquid platform.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty result
- Address with no Hyperliquid activity may return empty positions array
- Network or upstream Hyperliquid API unavailability causes timeout or 5xx error
- Rate limiting may occur under high request volume

## How this service works

One MCP endpoint gives your AI agent access to 100 APIs -- crypto, DeFi, web, AI, finance and utilities. No API keys, USDC on Base from $0.003/call.

## Output

Returns a JSON object containing: a list of open positions (with details per position), total notional position value, overall account value in USD, withdrawable balance, and total margin currently in use.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "description": "Hyperliquid wallet address (0x...) to retrieve account state for"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "positions": [],
  "totalNtlPos": "example",
  "accountValue": "example",
  "withdrawable": "example",
  "totalMarginUsed": "example"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-account-portfolio-lookup-9936577d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from klymax402.com](https://www.zero.xyz/host/klymax402.com/llms.txt)