{"uid":"cap_6FsdQ6rITDXTDSTLX0alW","slug":"smartperps-hyperliquid-wallet-analytics-8b55169c","name":"SmartPerps Hyperliquid Wallet Analytics","description":"Wallet tracker API. Live profile of the Hyperliquid account (0x address) you supply: account value, notional, effective leverage, margin usage, long/short/net book, up to 25 open positions (size, entry, leverage, distance to liquidation in whole percent, uPnL; no liquidation prices), 30-day fills summary and top-120 cohort rank. Public on-chain data only; must not be used to target or harass account holders. Fail-closed. Not financial advice. Past performance does not guarantee future results.","url":"https://api.youraitools.co/smartperps/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 account address (0x + 40 hex)"}},"description":"Search intents: hyperliquid wallet tracker, hyperliquid account lookup, wallet positions api, trader pnl lookup, copy trading research, perp wallet profile"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"book":{"type":"object"},"tier":{"type":"string"},"address":{"type":"string"},"last_30d":{"type":"object"},"data_note":{"type":"string"},"positions":{"type":"array"},"checked_at":{"type":"string"},"confidence":{"type":"string"},"disclaimer":{"type":"string"},"cohort_entry":{"type":"object"},"open_positions":{"type":"number"},"sources_failed":{"type":"array"},"margin_used_usd":{"type":"number"},"margin_usage_pct":{"type":"number"},"account_value_usd":{"type":"number"},"effective_leverage":{"type":"number"},"total_notional_usd":{"type":"number"},"in_smart_money_cohort":{"type":"boolean"}}}}}}},"responseSchema":{"type":"json","example":{"book":{"net_usd":-700946583,"long_notional_usd":0,"short_notional_usd":700946583},"tier":"wallet","address":"0x0000000000000000000000000000000000000001","last_30d":{"fills":2000,"fees_usd":73,"truncated":true,"volume_usd":763893,"most_traded":[{"symbol":"xyz:META","volume_usd":453357},{"symbol":"HYPE","volume_usd":165242}],"window_days":30,"closing_fills":64,"realized_pnl_usd":-7535,"winning_closes_pct":76.6},"data_note":"Public on-chain Hyperliquid data only. Liquidation is shown as distance from mark in whole percent, not as a price. Do not use this data to target, front-run liquidations of, or harass account holders.","positions":[{"side":"short","size":106464.1028,"margin":"cross","symbol":"ETH","leverage":5,"entry_price":2322.73,"notional_usd":254365099,"unrealized_pnl_usd":-7077189,"liquidation_distance_pct":74},{"side":"short","size":2637.9539,"margin":"cross","symbol":"BTC","leverage":5,"entry_price":76327.4,"notional_usd":214683283,"unrealized_pnl_usd":-13335028,"liquidation_distance_pct":88}],"checked_at":"2026-10-23T01:08:30.196Z","confidence":"high","disclaimer":"Not financial advice. Past performance does not guarantee future results. Descriptive statistics of public Hyperliquid positions at snapshot time; past PnL of the cohort says nothing about future results and positions can change at any moment. SmartPerps never trades, holds funds or keys.","cohort_entry":{"roi_30d":0.6858,"pnl_30d_usd":114316598,"display_name":null,"rank_30d_pnl":1,"pnl_all_time_usd":179019894},"open_positions":19,"sources_failed":[],"margin_used_usd":148682072,"margin_usage_pct":98.3,"account_value_usd":151226719,"effective_leverage":4.64,"total_notional_usd":700946583,"in_smart_money_cohort":true}},"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_ToXPAu-pK5cL0O6BUA0ge","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 a detailed snapshot of a Hyperliquid perpetuals wallet including open positions, 30-day trading stats, margin usage, PnL, and whether the account is in the 'smart money' cohort.","exampleAgentPrompt":"Pull the current Hyperliquid perps wallet snapshot for address 0x5b5d51203a0f9079f8aeb098a6523a13f298c060 — I want to see their open positions, margin usage, unrealized PnL, and whether they're in the smart money cohort.","exampleUseCases":[{"title":"Whale position monitoring alert","prompt":"Check the Hyperliquid wallet 0x5b5d51203a0f9079f8aeb098a6523a13f298c060 and tell me their current open positions, effective leverage, and how close they are to liquidation — I'm watching this wallet."},{"title":"Smart money cohort vetting","prompt":"Is the Hyperliquid address 0xABCDEF1234567890abcdef1234567890ABCDEF12 in the smart money cohort? What's their 30-day PnL and win rate on closing trades?"},{"title":"Copy trader due diligence","prompt":"Before I start copy trading this Hyperliquid account 0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b, show me their recent performance — 30-day volume, realized PnL, most traded symbols, and their current margin usage."}],"resultDescription":"A JSON object containing: the wallet address, account value in USD, open positions (symbol, side, size, entry price, notional USD, unrealized PnL, leverage, liquidation price, margin type), 30-day stats (fills, fees, volume, realized PnL, winning close percentage, most traded symbols), margin used and usage percentage, effective leverage, total notional, smart money cohort membership and cohort rank/ROI, snapshot timestamp, and a data confidence rating.","failureModes":["Invalid address format (not 0x + 40 hex) returns an error","Address not found on Hyperliquid returns empty or null positions","Hyperliquid data source temporarily unavailable reflected in sources_failed array","Rate limiting or payment failure returns 402 or 429","Stale data possible if checked_at timestamp is old"],"whenToPreferThis":"Use this endpoint when you need a comprehensive, structured snapshot of a specific Hyperliquid perpetuals account — including positions, PnL, leverage, liquidation risk, and smart money classification — all in one call. Prefer it over scraping Hyperliquid directly (no native API key needed, already aggregated) or generic on-chain data providers that don't specialize in perps analytics. Especially valuable when assessing whether to copy-trade a wallet or monitor a known whale address.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T12:43:21.739Z","isFirstParty":false,"canonicalSlug":"smartperps-hyperliquid-wallet-analytics-8b55169c"}