{"uid":"cap_dbYT5EjPBjrf5SzFU6D1U","slug":"vextorium-hyperliquid-positions-7445ba58","name":"Vextorium Hyperliquid Positions","description":"558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.","url":"https://api.vextorium.com/v1/hyperliquid-positions?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","description":"Positions to return, largest first (default 20)"},"wallet":{"type":"string","description":"EVM address (0x...)"}}},"responseSchema":{"type":"json","example":{"source":"Hyperliquid (on-chain open data)","wallet":"0x010461c14e146ac35fe42271bdc1134ee31c703a","positions":[{"side":"short","size":257798,"asset":"WIF","input":0.248962,"roe_pct":-49.54,"leverage":20,"margin_type":"cross","used_margin_usd":3288.600187,"liquidation_price":12.101198661,"position_value_usd":65772.00374,"unrealized_pnl_usd":-1589.906025,"cumulative_funding_usd":-1415.618832},{"side":"long","size":251595,"asset":"APEX","input":0.264139,"roe_pct":-88.66,"leverage":20,"margin_type":"cross","used_margin_usd":3175.506292,"liquidation_price":null,"position_value_usd":63510.12585,"unrealized_pnl_usd":-2946.152408,"cumulative_funding_usd":3578.168162}],"open_positions":177,"used_margin_usd":223737.93189,"withdrawable_usd":2681703.459226,"account_value_usd":3129179.323074,"total_notional_usd":4474758.638828,"total_unrealized_pnl_usd":4167.69}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.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_qhd2ftnODK_iwYB6X4dLr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all open perpetual futures positions and account-level margin stats for a given EVM wallet address on Hyperliquid","exampleAgentPrompt":"Pull the top 20 open Hyperliquid positions for wallet 0x010461c14e146ac35fe42271bdc1134ee31c703a and show me the unrealized PnL, leverage, and liquidation price for each.","exampleUseCases":[{"title":"Monitor a whale trader's positions","prompt":"Look up the open Hyperliquid perp positions for wallet 0xAbC123...def456 — I want to see what assets they're trading, which direction (long or short), and whether any positions are near liquidation."},{"title":"Audit portfolio risk before market open","prompt":"Fetch my Hyperliquid positions for wallet 0x010461c14e146ac35fe42271bdc1134ee31c703a and tell me my total used margin, withdrawable balance, and which positions have the worst unrealized PnL."},{"title":"Track funding costs on open trades","prompt":"Get the top 10 Hyperliquid positions for address 0x9fD3...22A1 and show me the cumulative funding paid or received on each one so I can see which trades are being dragged down by funding rates."}],"resultDescription":"Returns a JSON object with the wallet address, total open position count, account value in USD, withdrawable balance, total notional, total unrealized PnL, used margin, and an array of individual positions each containing asset name, long/short side, size, entry price (input), leverage, margin type (cross/isolated), used margin in USD, position value in USD, unrealized PnL in USD, ROE %, liquidation price, and cumulative funding in USD — sorted by position size descending.","failureModes":["Invalid or malformed EVM wallet address returns an error or empty positions array","Wallet has no open Hyperliquid positions — returns empty positions array with zeroed account stats","Hyperliquid API downtime or rate limiting causes timeout or 5xx error","Limit parameter out of range may return default count or validation error","Non-EVM address format (e.g. Solana pubkey) will fail schema validation"],"whenToPreferThis":"Use this endpoint when you need real-time on-chain open position data specifically from Hyperliquid perpetuals for any EVM wallet, including margin utilization, liquidation prices, and funding accruals. Prefer it over generic portfolio trackers when you need Hyperliquid-specific derivatives data rather than spot balances or data from other DEXes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:45:23.472Z","isFirstParty":false,"canonicalSlug":"vextorium-hyperliquid-positions-7445ba58"}