# Hyperliquid Wallet Report > Hyperliquid Wallet Report is a paid API for AI agents from crypto-market-data.zafermemon87.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-29). Returns an enriched Hyperliquid wallet report including open positions with liquidation distance and risk labels, account value, leverage, PnL and volume across multiple timeframes, spot balances, and last 24 hours of trading activity. ## Facts - Endpoint: GET https://crypto-market-data.zafermemon87.workers.dev/v1/wallet?utm_source=zero.xyz - Price: $0.01/call - Payment: x402 - Status: unknown - Last checked: 2026-10-29 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/hyperliquid-wallet-report-c469f7f3 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2J6ZZg2_UrG5kSEdXSHhH 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-report-c469f7f3 ``` Example prompt: Pull the full Hyperliquid wallet report for 0x1234567890abcdef1234567890abcdef12345678 — I want to see open positions with their liquidation distance and risk labels, current account value and leverage, PnL by day and week, spot balances, and the last 24 hours of trades. ## When to prefer this Choose this endpoint when you need a comprehensive, enriched snapshot of a specific Hyperliquid wallet — especially when you need liquidation risk labels alongside raw position data, or when you want PnL and volume across multiple timeframes in a single call rather than stitching together multiple raw API responses. It is purpose-built for Hyperliquid and provides computed risk metrics not available from raw on-chain data. ## Known failure modes - Invalid or malformed wallet address (not 0x + 40 hex chars) returns a 400 error - Wallet address with no Hyperliquid activity may return empty position and trade arrays - Hyperliquid API downtime or rate limiting may cause 502 or 503 responses - Payment failure or insufficient USDC balance results in 402 Payment Required - Non-existent address returns empty data rather than an error ## How this service works Enriched Hyperliquid wallet report: open positions with liquidation distance and a risk label, account value and leverage, PnL and volume by day, week, month and all time, spot balances and the last 24 hours of trading. ## Output Returns a structured JSON object containing: open perpetual positions with individual liquidation distances and risk labels (e.g. safe/warning/danger); total account value and current leverage; PnL and trading volume broken down by day, week, month, and all time; spot token balances; and a chronological list of trades from the past 24 hours. ## 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" ], "type": "string" }, "queryParams": { "type": "object", "required": [ "address" ], "properties": { "address": { "type": "string", "description": "Hyperliquid wallet address, 0x followed by 40 hex characters" } } } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object" } } } } } ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "note": "Public Hyperliquid data, live. Not financial advice.", "risk": { "label": "low", "largest_position": "BTC", "closest_liquidation_pct": 216.15 }, "spot": [ { "coin": "UZEC", "amount": 483.354272741, "entry_value_usd": 600590.38 }, { "coin": "HYPE", "amount": 2644.44201414, "entry_value_usd": 205773.71 } ], "tool": "wallet", "as_of": "2026-10-23T20:23:49Z", "chain": "hyperliquid", "plain": "Account $8.5M; 129 open positions ($12.9M, 1.5x effective leverage); closest liquidation 216.2% away; risk low; PnL $147K today, $2.3M this month.", "account": { "value_usd": 8545053.84, "open_positions": 129, "margin_used_usd": 1073575.11, "withdrawable_usd": 2784690.47, "effective_leverage": 1.5, "position_value_usd": 12852269.52, "maintenance_margin_usd": 536787.55 }, "address": "0x71d0e11ebb6150cebe20cf62f798be1a50108c26", "charged": true, "pnl_usd": { "day": 146951.05, "week": 105757.05, "month": 2253046.05, "all_time": 3729232.23 }, "cached_s": 0, "positions": [ { "coin": "BTC", "side": "SHORT", "size": 44.9758, "leverage": 40, "value_usd": 3659168.12, "mark_price": 81358.6, "entry_price": 81766, "leverage_type": "cross", "margin_used_usd": 91479.2, "liquidation_price": 257217.5908865997, "unrealized_pnl_usd": 18326.15, "return_on_equity_pct": 19.93, "funding_since_open_usd": -1130.35, "distance_to_liquidation_pct": 216.15 }, { "coin": "ETH", "side": "LONG", "size": 1119.7383, "leverage": 25, "value_usd": 2681997.18, "mark_price": 2395.2, "entry_price": 2414.74, "leverage_type": "cross", "margin_used_usd": 107279.89, "liquidation_price": null, "unrealized_pnl_usd": -21880.4, "return_on_equity_pct": -20.23, "funding_since_open_usd": 1216.75, "distance_to_liquidation_pct": null } ], "price_usd": 0.01, "volume_usd": { "day": 43499301, "week": 468506062, "month": 3101605776, "all_time": 17153002944 }, "trading_24h": { "trades": 2000, "fees_usd": -21.2, "top_coins": [ { "coin": "ZEC", "volume_usd": 2438123 }, { "coin": "NEAR", "volume_usd": 746761 } ], "last_trade": "2026-10-23T20:23:50Z", "volume_usd": 5505469, "realized_pnl_usd": 25249.06 } } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-wallet-report-c469f7f3/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from crypto-market-data.zafermemon87.workers.dev](https://www.zero.xyz/host/crypto-market-data.zafermemon87.workers.dev/llms.txt)