# Hyperliquid Perpetual Positions by Wallet > Hyperliquid Perpetual Positions by Wallet is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-13). 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. ## Facts - Endpoint: POST https://api.vextorium.com/hyperliquid-posiciones-pago?utm_source=zero.xyz - Price: $0.005/call - Payment: x402 - Status: unknown - Last checked: 2026-10-13 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/hyperliquid-perpetual-positions-by-wallet-6d577991 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lT5AdtcSKRw17IG2FVZnh Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability hyperliquid-perpetual-positions-by-wallet-6d577991 -d '' ``` Example prompt: 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. ## When to prefer this 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. ## Known failure modes - 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 ## How this service works 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. ## Output 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. ## Request schema (JSON Schema) ```json { "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", … (truncated) ``` ## Response schema (JSON Schema) ```json { "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 } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-perpetual-positions-by-wallet-6d577991/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)