{"uid":"cap_QMFhie7hMJpNc76Es36iO","slug":"agents-x402stock-xyz-hyperliquid-perp-dex-live-account-state-63d7d092","name":"Hyperliquid Perp DEX Live Account State","description":"Live on-chain account state for any wallet on the Hyperliquid perp DEX, by 0x address: account value, total notional, margin used, withdrawable; every open perp position (size, long/short, leverage, entry, unrealized PnL, liquidation price, margin); and resting open orders (up to `?limit=`, default 200; `open_orders_count` is the total). Read-only public chain data, no key. From x402stock","url":"https://agents.x402stock.xyz/api/v1/perps/account/{address}","method":"GET","headers":{},"bodySchema":{"type":"object","required":["address"],"properties":{"limit":{"type":"integer","default":200,"maximum":1000,"minimum":0},"address":{"type":"string","description":"Solana account address (base58)."}}},"responseSchema":{"type":"object","required":["source","as_of","venue","market","address","account_value","total_notional_position","total_raw_usd","total_margin_used","maintenance_margin_used","withdrawable","positions","open_orders_count","open_orders"],"properties":{"as_of":{"type":"string"},"venue":{"type":"string"},"market":{"type":"string","const":"perp"},"source":{"type":"string","const":"x402stock"},"address":{"type":"string"},"positions":{"type":"array","items":{"type":"object","required":["coin","size","side","leverage","leverage_type","entry_price","position_value","unrealized_pnl","return_on_equity","liquidation_price","margin_used","max_leverage","funding_since_open"],"properties":{"coin":{"type":"string"},"side":{"anyOf":[{"enum":["long","short"],"type":"string"},{"type":"null"}]},"size":{"anyOf":[{"type":"number"},{"type":"null"}]},"leverage":{"anyOf":[{"type":"number"},{"type":"null"}]},"entry_price":{"anyOf":[{"type":"number"},{"type":"null"}]},"margin_used":{"anyOf":[{"type":"number"},{"type":"null"}]},"max_leverage":{"type":"number"},"leverage_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"position_value":{"anyOf":[{"type":"number"},{"type":"null"}]},"unrealized_pnl":{"anyOf":[{"type":"number"},{"type":"null"}]},"return_on_equity":{"anyOf":[{"type":"number"},{"type":"null"}]},"liquidation_price":{"anyOf":[{"type":"number"},{"type":"null"}]},"funding_since_open":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}},"open_orders":{"type":"array","items":{"type":"object","required":["coin","side","limit_price","size","orig_size","order_id","timestamp"],"properties":{"coin":{"type":"string"},"side":{"anyOf":[{"enum":["buy","sell"],"type":"string"},{"type":"null"}]},"size":{"anyOf":[{"type":"number"},{"type":"null"}]},"order_id":{"type":"number"},"orig_size":{"anyOf":[{"type":"number"},{"type":"null"}]},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]},"limit_price":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}},"withdrawable":{"anyOf":[{"type":"number"},{"type":"null"}]},"account_value":{"anyOf":[{"type":"number"},{"type":"null"}]},"total_raw_usd":{"anyOf":[{"type":"number"},{"type":"null"}]},"open_orders_count":{"type":"number"},"total_margin_used":{"anyOf":[{"type":"number"},{"type":"null"}]},"maintenance_margin_used":{"anyOf":[{"type":"number"},{"type":"null"}]},"total_notional_position":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.02","displayCostAsset":"USD","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":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hCro4hvZh54sjerIFk6XJ","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.x402stock.xyz","brandSlug":"agents-x402stock-xyz-mpp","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"Returns live on-chain account state for any wallet on the Hyperliquid perpetuals DEX, including account value, margin, open positions, and resting orders.","exampleAgentPrompt":"Pull the live Hyperliquid perp account state for wallet 0x1234abcd... — I want to see the account value, all open positions with their unrealized PnL and liquidation prices, and any resting open orders.","exampleUseCases":[{"title":"Monitor trader liquidation risk","prompt":"Check the Hyperliquid perp account for 0xabc123... and tell me if any of their open positions are close to their liquidation price — include their current leverage and margin used."},{"title":"Audit portfolio exposure on Hyperliquid","prompt":"What coins is wallet 0xdef456... currently long or short on Hyperliquid, what's the total notional size, and how much margin are they using?"},{"title":"Track unrealized PnL for a known trader","prompt":"Look up the Hyperliquid perp account for 0x789ghi... and give me their unrealized PnL across all open positions along with their return on equity."}],"resultDescription":"A JSON object containing a timestamp, venue and market identifiers, the wallet address, account-level financials (account value, total notional, raw USD, margin used, maintenance margin, withdrawable), an array of open perpetual positions (coin, side, size, leverage, leverage type, entry price, position value, unrealized PnL, return on equity, liquidation price, margin used, max leverage, funding since open), a count of total open orders, and an array of resting open orders (coin, side, limit price, size, original size, order ID, timestamp).","failureModes":["Invalid or malformed 0x address returns an error or empty positions array","Address with no Hyperliquid activity returns zeroed account fields and empty arrays","limit parameter exceeds maximum of 1000, returning a validation error","Network or on-chain data unavailability causes a timeout or upstream error","Non-existent address may return a valid schema with all-zero balances"],"whenToPreferThis":"Use this endpoint when you need live, on-chain perpetuals account data from the Hyperliquid DEX for any public wallet address without requiring an API key. Prefer this over generic crypto portfolio endpoints when the specific need is Hyperliquid perp positions, margin state, or resting limit orders. It is the right choice for risk monitoring, copy-trading research, or liquidation analysis on Hyperliquid.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-11T18:44:37.824Z","isFirstParty":false}