{"uid":"cap_14kcKrVuiuXQtilKWUBkt","slug":"alphapipeline-whale-position-audit-664a6f72","name":"AlphaPipeline Whale Position Audit","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 address you supply. Paid in USDC on Base.","url":"https://alphapipeline-eu.onrender.com/v1/derivatives/whale-position-audit?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"Hyperliquid/EVM wallet address to audit (0x...)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","title":"WhalePositionAuditResponse","required":["generated_at","wallet_address","open_position_count","data_source"],"properties":{"notice":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notice","default":null},"positions":{"type":"array","items":{"type":"object","title":"WhalePosition","required":["coin","side","size","entry_price","position_value_usd","leverage","leverage_type","unrealized_pnl_usd"],"properties":{"coin":{"type":"string","title":"Coin"},"side":{"type":"string","title":"Side","description":"LONG or SHORT, derived from the sign of Hyperliquid's szi (signed size)."},"size":{"type":"number","title":"Size"},"leverage":{"type":"number","title":"Leverage"},"mark_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mark Price","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."},"entry_price":{"type":"number","title":"Entry Price"},"max_leverage":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Leverage","default":null,"description":"Hyperliquid's own reported leverage ceiling for this asset/account setting - not the leverage actually in use (see 'leverage' for that)."},"leverage_type":{"type":"string","title":"Leverage Type","description":"cross or isolated, as reported by Hyperliquid."},"liquidation_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Liquidation Price","default":null},"position_value_usd":{"type":"number","title":"Position Value Usd"},"unrealized_pnl_usd":{"type":"number","title":"Unrealized Pnl Usd"},"return_on_equity_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Return On Equity Pct","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."},"distance_to_liquidation_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Distance To Liquidation Pct","default":null,"description":"abs(mark_price - liquidation_price) / mark_price * 100. Null when Hyperliquid reports no liquidation price for this position."}}},"title":"Positions","default":[]},"risk_flags":{"type":"array","items":{"type":"string"},"title":"Risk Flags","default":[]},"data_source":{"type":"string","title":"Data Source"},"generated_at":{"type":"object","title":"TimestampPair","required":["utc","kst"],"properties":{"kst":{"type":"string","title":"Kst"},"utc":{"type":"string","title":"Utc"}}},"wallet_address":{"type":"string","title":"Wallet Address"},"margin_usage_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Margin Usage Pct","default":null},"withdrawable_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Withdrawable Usd","default":null},"account_value_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Account Value Usd","default":null},"open_position_count":{"type":"integer","title":"Open Position Count"},"total_margin_used_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Margin Used Usd","default":null},"total_notional_position_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Notional Position Usd","default":null}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dINJJ5WESRB7Q04OLx6bs","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Audits all open Hyperliquid perpetual positions for a given wallet address, returning side, size, leverage, unrealized PnL, liquidation price, and distance-to-liquidation percentage.","exampleAgentPrompt":"Can you audit all open Hyperliquid perpetual positions for wallet 0x1234abcd...efgh and show me the side, leverage, unrealized PnL, and how far each position is from liquidation?","exampleUseCases":[{"title":"Liquidation risk check before market open","prompt":"Pull up all open perp positions for Hyperliquid wallet 0xAbCd1234... and tell me which ones are within 10% of their liquidation price — I want to know what's at risk before the US market opens."},{"title":"Copy-trading due diligence on a whale","prompt":"I'm thinking of copy-trading this wallet 0xDeFi5678... — can you show me every open Hyperliquid perpetual position they have right now, including their leverage, entry prices, and unrealized PnL?"},{"title":"Portfolio risk snapshot for my own wallet","prompt":"Give me a full audit of my Hyperliquid positions at address 0xMyWallet9999... — I want to see every open perp, whether I'm long or short, my leverage on each, and how close I am to getting liquidated."}],"resultDescription":"Returns a structured JSON object with the wallet address audited, total open position count, generation timestamp, data source, and an array of positions — each containing coin symbol, LONG/SHORT side, size, entry price, position value in USD, mark price (derived), leverage amount and type (cross/isolated), max leverage ceiling, unrealized PnL in USD, liquidation price, and distance-to-liquidation percentage. May include a notice field for special conditions.","failureModes":["Invalid or malformed wallet address returns an error — address must be a valid 0x EVM address","Wallet with no open positions returns an empty positions array with open_position_count of 0","Hyperliquid API downtime or rate limiting causes upstream fetch failure","Address that has never interacted with Hyperliquid may return empty or error response","Network timeout on the render.com host under high load"],"whenToPreferThis":"Use this endpoint when you already know the specific Hyperliquid wallet address you want to audit and need a comprehensive snapshot of all its open perpetual positions including leverage, PnL, and liquidation proximity. This is not a discovery or ranking tool — it does not surface top wallets or leaderboards. Prefer this over manual Hyperliquid UI inspection when you need structured, programmatic data for analysis, alerting, or copy-trading research.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:35:30.012Z","isFirstParty":false,"canonicalSlug":"alphapipeline-whale-position-audit-664a6f72"}