{"uid":"cap_2J6ZZg2_UrG5kSEdXSHhH","slug":"hyperliquid-wallet-report-c469f7f3","name":"Hyperliquid Wallet Report","description":"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.","url":"https://crypto-market-data.zafermemon87.workers.dev/v1/wallet?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GqmSSGiCUBcZ1dJUG75Xp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Monitor a trader's liquidation risk","prompt":"Check the Hyperliquid wallet 0xAbCd1234AbCd1234AbCd1234AbCd1234AbCd1234 and tell me how close any of their open positions are to liquidation — I want the risk labels and liquidation distances for each position."},{"title":"Weekly PnL review for a portfolio","prompt":"Give me the PnL summary for Hyperliquid wallet 0xDeAdBeEfDeAdBeEfDeAdBeEfDeAdBeEfDeAdBeEf — I need the daily, weekly, monthly and all-time figures along with the account value and leverage."},{"title":"Audit a wallet's recent trading activity","prompt":"Show me everything traded in the last 24 hours on Hyperliquid for address 0x9999aaaa9999aaaa9999aaaa9999aaaa9999aaaa, plus the current spot balances they're holding."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:33:34.385Z","isFirstParty":false,"canonicalSlug":"hyperliquid-wallet-report-c469f7f3"}