{"uid":"cap_lT5AdtcSKRw17IG2FVZnh","slug":"hyperliquid-perpetual-positions-by-wallet-6d577991","name":"Hyperliquid Perpetual Positions by Wallet","description":"Open perpetual positions of any wallet on Hyperliquid: side, size, entry, unrealized PnL, ROE, leverage, liquidation price, margin and funding paid, plus account value and withdrawable. Live open on-chain data.","url":"https://api.vextorium.com/hyperliquid-posiciones-pago?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["wallet"],"properties":{"limite":{"type":"integer","description":"Positions to return, largest first (default 20)"},"wallet":{"type":"string","description":"EVM address (0x...)"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":["object","null"],"properties":{"fuente":{"type":["string","null"]},"wallet":{"type":["string","null"]},"posiciones":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"lado":{"type":["null","string"]},"activo":{"type":["null","string"]},"tamano":{"type":["null","number"]},"entrada":{"type":["null","number"]},"roe_pct":{"type":["null","number"]},"tipo_margen":{"type":["null","string"]},"apalancamiento":{"type":["null","number"]},"margen_usado_usd":{"type":["null","number"]},"precio_liquidacion":{"type":["null","number"]},"valor_posicion_usd":{"type":["null","number"]},"pnl_no_realizado_usd":{"type":["null","number"]},"funding_acumulado_usd":{"type":["null","number"]}}}},"retirable_usd":{"type":["number","null"]},"margen_usado_usd":{"type":["number","null"]},"valor_cuenta_usd":{"type":["number","null"]},"nocional_total_usd":{"type":["number","null"]},"posiciones_abiertas":{"type":["number","null"]},"pnl_no_realizado_total_usd":{"type":["number","null"]}}}}}}},"responseSchema":{"type":"json","example":{"fuente":"Hyperliquid (datos abiertos on-chain)","wallet":"0x010461c14e146ac35fe42271bdc1134ee31c703a","posiciones":[{"lado":"short","activo":"WIF","tamano":257798,"entrada":0.248962,"roe_pct":-49.54,"tipo_margen":"cross","apalancamiento":20,"margen_usado_usd":3288.600187,"precio_liquidacion":12.101198661,"valor_posicion_usd":65772.00374,"pnl_no_realizado_usd":-1589.906025,"funding_acumulado_usd":-1415.618832},{"lado":"long","activo":"APEX","tamano":251595,"entrada":0.264139,"roe_pct":-88.66,"tipo_margen":"cross","apalancamiento":20,"margen_usado_usd":3175.506292,"precio_liquidacion":null,"valor_posicion_usd":63510.12585,"pnl_no_realizado_usd":-2946.152408,"funding_acumulado_usd":3578.168162},{"lado":"short","activo":"CELO","tamano":608173,"entrada":0.101061,"roe_pct":-41.73,"tipo_margen":"cross","apalancamiento":20,"margen_usado_usd":3137.26042,"precio_liquidacion":5.1245912217,"valor_posicion_usd":62745.20841,"pnl_no_realizado_usd":-1282.3637,"funding_acumulado_usd":-618.210384},{"lado":"short","activo":"TRB","tamano":2963.26,"entrada":20.2717,"roe_pct":-21.34,"tipo_margen":"cross","apalancamiento":20,"margen_usado_usd":3035.563544,"precio_liquidacion":1051.0735067276,"valor_posicion_usd":60711.27088,"pnl_no_realizado_usd":-640.808578,"funding_acumulado_usd":-3166.17309},{"lado":"long","activo":"EIGEN","tamano":227889.95,"entrada":0.2534,"roe_pct":84.93,"tipo_margen":"cross","apalancamiento":20,"margen_usado_usd":3010.426239,"precio_liquidacion":null,"valor_posicion_usd":60208.52479,"pnl_no_realizado_usd":2452.717414,"funding_acumulado_usd":288.53426}],"retirable_usd":2681703.459226,"margen_usado_usd":223737.93189,"valor_cuenta_usd":3129179.323074,"nocional_total_usd":4474758.638828,"posiciones_abiertas":177,"pnl_no_realizado_total_usd":4167.69}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4DLyfH5WuwzA3sXx2Trg9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all open perpetual positions for any Hyperliquid wallet address, including side, size, entry price, unrealized PnL, ROE, leverage, liquidation price, margin, funding paid, account value, and withdrawable balance.","exampleAgentPrompt":"Show me all open perpetual positions for the Hyperliquid wallet 0x010461c14e146ac35fe42271bdc1134ee31c703a — I want to see each position's side, size, entry price, unrealized PnL, leverage, liquidation price, and the account's total value and withdrawable balance.","exampleUseCases":[{"title":"Whale wallet position monitoring","prompt":"Look up the open Hyperliquid perp positions for wallet 0x010461c14e146ac35fe42271bdc1134ee31c703a and tell me which ones have the biggest unrealized losses and how close they are to liquidation."},{"title":"Trader risk assessment","prompt":"What's the total account value, margin used, and overall unrealized PnL for Hyperliquid wallet 0xABC123... right now? I want to understand their overall risk exposure across all open perps."},{"title":"Copy trading research","prompt":"Can you pull the top 10 largest open perpetual positions for Hyperliquid wallet 0xDEF456... so I can see what assets they're trading, whether they're long or short, and what leverage they're using?"}],"resultDescription":"Returns a JSON object with a list of open perpetual positions (each with asset, side, size, entry price, unrealized PnL, ROE%, leverage, margin type, margin used in USD, liquidation price, position value in USD, and accumulated funding in USD), plus account-level summary fields: total account value, withdrawable balance, margin used, total notional, number of open positions, and total unrealized PnL — all sourced live from Hyperliquid on-chain data.","failureModes":["Invalid or malformed wallet address returns an error or empty positions array","Wallet with no open positions returns empty positions list with zeroed account fields","Hyperliquid API unavailability causes upstream fetch failure","Rate limiting or payment failure returns HTTP 402 or 429","Non-EVM address format causes validation error"],"whenToPreferThis":"Use this endpoint when you need live, on-chain perpetual position data for any Hyperliquid wallet address, especially when you need comprehensive per-position details (PnL, ROE, liquidation price, funding) alongside account-level metrics. Prefer this over generic blockchain explorers which don't decode Hyperliquid's proprietary position state, and over centralized exchange APIs which don't cover Hyperliquid's decentralized perp protocol.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:41:47.855Z","isFirstParty":false,"canonicalSlug":"hyperliquid-perpetual-positions-by-wallet-6d577991"}