{"uid":"cap_y6W-AL1JN8bHUfKR6M_nD","slug":"hyperliquid-account-positions-90a092cf","name":"Hyperliquid Account Positions","description":"A Hyperliquid wallet's open perp positions (side, size, entry, value, unrealized PnL, leverage, liquidation price, funding), margin summary and spot balances. Use to track whales or your own account.","url":"https://bess-x402.onrender.com/v1/crypto/hyperliquid-account?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":"0x wallet address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Ssg_UgKLIqn-hR25JivtR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a Hyperliquid wallet's open perpetual positions, margin summary, and spot balances including PnL, leverage, and liquidation prices.","exampleAgentPrompt":"Pull up all the open perp positions, margin summary, and spot balances for Hyperliquid wallet 0x1234abcd... — I want to see their leverage, liquidation prices, and unrealized PnL.","exampleUseCases":[{"title":"Whale position surveillance","prompt":"Check what positions the whale at 0xabc123... is running on Hyperliquid right now — I want to see their leverage, entry prices, and how much unrealized PnL they're sitting on."},{"title":"Personal portfolio risk check","prompt":"Show me my open Hyperliquid perp positions for wallet 0xdef456... — especially my liquidation prices and margin summary so I can see if I'm at risk."},{"title":"Funding and carry cost monitoring","prompt":"What are the current funding rates on my open Hyperliquid positions for address 0x789ghi...? I want to know how much carry cost I'm accumulating across all my perps."}],"resultDescription":"Returns a structured breakdown of the wallet's open perpetual futures positions (side, size, entry price, notional value, unrealized PnL, leverage, liquidation price, funding), a margin summary (total equity, used/available margin), and spot token balances held in the account.","failureModes":["Invalid or malformed wallet address returns an error or empty result","Address with no open positions returns empty position arrays","Network or RPC timeouts from Hyperliquid infrastructure may cause transient failures","Address not found on Hyperliquid returns null or empty account data"],"whenToPreferThis":"Use this endpoint when you need real-time perpetual position details, margin health, or spot balances for any Hyperliquid wallet — particularly for whale tracking, risk monitoring, or personal portfolio checks. Prefer this over generic DeFi dashboards when Hyperliquid-specific data (leverage, liquidation price, funding) is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:37:31.431Z","isFirstParty":false,"canonicalSlug":"hyperliquid-account-positions-90a092cf"}