{"slug":"alphapipeline-eu-onrender-com-v1-derivatives-whale-position-096450","title":"Audit a Hyperliquid wallet address you already know","host":"alphapipeline-eu.onrender.com","method":"GET","resource":"https://alphapipeline-eu.onrender.com/v1/derivatives/whale-position-audit","category":"code","description":"Audit a Hyperliquid wallet address you already know: every open perpetual position with side, size, leverage, unrealized PnL, liquidation price, and distance-to-liquidation percentage. Does not discover or rank wallets - Hyperliquid's public API has no leaderboard endpoint, so this only audits an ad","price_listed":0.02,"price_asked":0.02,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":331,"reported_calls_30d":0,"reported_payers_30d":0,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"address":"0x31ca8395cf837de08b24da3f660e77761dfb974"},"type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"address":{"description":"Hyperliquid/EVM wallet address to audit (0x...).","type":"string"}},"required":["address"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"account_value_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Account Value Usd"},"data_source":{"title":"Data Source","type":"string"},"generated_at":{"properties":{"kst":{"title":"Kst","type":"string"},"utc":{"title":"Utc","type":"string"}},"required":["utc","kst"],"title":"TimestampPair","type":"object"},"margin_usage_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Margin Usage Pct"},"notice":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Notice"},"open_position_count":{"title":"Open Position Count","type":"integer"},"positions":{"default":[],"items":{"properties":{"coin":{"title":"Coin","type":"string"},"distance_to_liquidation_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"abs(mark_price - liquidation_price) / mark_price * 100. Null when Hyperliquid reports no liquidation price for this position.","title":"Distance To Liquidation Pct"},"entry_price":{"title":"Entry Price","type":"number"},"leverage":{"title":"Leverage","type":"number"},"leverage_type":{"description":"cross or isolated, as reported by Hyperliquid.","title":"Leverage Type","type":"string"},"liquidation_price":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Liquidation Price"},"mark_price":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Derived as position_value_usd / size, since clearinghouseState does not return a live mark price directly. Not a separately-fetched live quote.","title":"Mark Price"},"max_leverage":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Hyperliquid's own reported leverage ceiling for this asset/account setting - not the leverage actually in use (see 'leverage' for that).","title":"Max Leverage"},"position_value_usd":{"title":"Position Value Usd","type":"number"},"return_on_equity_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Hyperliquid's own reported return-on-equity for this position, as a percentage. This is Hyperliquid's own ROE definition, which can differ from a naive unrealized_pnl_usd / margin_used calculation.","title":"Return On Equity Pct"},"side":{"description":"LONG or SHORT, derived from the sign of Hyperliquid's szi (signed size).","title":"Side","type":"string"},"size":{"title":"Size","type":"number"},"unrealized_pnl_usd":{"title":"Unrealized Pnl Usd","type":"number"}},"required":["coin","side","size","entry_price","position_value_usd","leverage","leverage_type","unrealized_pnl_usd"],"title":"WhalePosition","type":"object"},"title":"Positions","type":"array"},"risk_flags":{"default":[],"items":{"type":"string"},"title":"Risk Flags","type":"array"},"total_margin_used_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Total Margin Used Usd"},"total_notional_position_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Total Notional Position Usd"},"wallet_address":{"title":"Wallet Address","type":"string"},"withdrawable_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Withdrawable Usd"}},"required":["generated_at","wallet_address","open_position_count","data_source"],"title":"WhalePositionAuditResponse","type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-30","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.02,"price_match":true,"latency_ms":331,"error":null}],"description_full":"Audit a Hyperliquid wallet address you already know: every open perpetual position with side, size, leverage, unrealized PnL, liquidation price, and distance-to-liquidation percentage. Does not discover or rank wallets - Hyperliquid's public API has no leaderboard endpoint, so this only audits an address you supply. Paid in USDC on Base.","last_updated":"2026-09-30T15:38:10.188Z","schemes":["exact"]}