{"uid":"cap_9MW7hGvzDeNMJDVZw1SOy","slug":"sitecheck-hyperliquid-perps-account-lookup-add30ab8","name":"SiteCheck Hyperliquid Perps Account Lookup","description":"A Hyperliquid account by address: account value, margin used and withdrawable amount in USD, and each open position with side, size, entry and mark price, unrealised PnL, leverage and liquidation price. Read-only. Information only, not financial advice.","url":"https://api.sitecheck-api.workers.dev/api/perps/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"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"Hyperliquid account address, 0x…"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"source":"https://api.hyperliquid.xyz/info (clearinghouseState)","address":"0x0000000000000000000000000000000000000001","checkedAt":"2026-10-14T07:00:22.556Z","positions":[],"disclaimer":"Information only, not financial advice.","marginUsedUsd":0,"accountValueUsd":0.1,"withdrawableUsd":0.1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NHpuWaYW8WfPpqT8_l7_k","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a Hyperliquid perpetuals account's open positions, margin usage, account value, and withdrawable balance for a given 0x wallet address.","exampleAgentPrompt":"What are the open perpetuals positions and account value for my Hyperliquid wallet 0x1234567890abcdef1234567890abcdef12345678?","exampleUseCases":[{"title":"Monitor personal Hyperliquid perps exposure","prompt":"Can you check my Hyperliquid perps account at 0xAbCd1234abcd1234abcd1234abcd1234abcd1234 and tell me my open positions, how much margin I'm using, and how much I can withdraw right now?"},{"title":"Risk dashboard for a trader's portfolio","prompt":"Pull the Hyperliquid perpetuals account data for wallet 0xDeAdBeEf00000000000000000000000000000001 — I need the account value, margin used, and any open positions so I can assess risk exposure."},{"title":"Verify counterparty's Hyperliquid account activity","prompt":"Look up the Hyperliquid perps account for address 0x0000000000000000000000000000000000000099 and tell me if they have any open positions or significant account value."}],"resultDescription":"Returns a JSON object sourced from Hyperliquid's clearinghouseState API, containing: the queried address, a timestamp of when the check was performed, an array of open perpetual positions (each with details such as asset, size, entry price, unrealized PnL), total margin used in USD, total account value in USD, and withdrawable USD balance. Includes a disclaimer that the data is informational only.","failureModes":["Invalid or malformed address (not a valid 0x Ethereum-style address) — likely returns an error or empty result","Address with no Hyperliquid account — returns zero account value and empty positions array","Hyperliquid API downtime — upstream fetch fails and may return a 5xx or timeout","Payment not settled — x402 payment required error if USDC not provided"],"whenToPreferThis":"Use this endpoint when you need real-time Hyperliquid perpetuals account data (positions, margin, balance) for a specific 0x wallet address. Prefer this over querying Hyperliquid directly when working within a pay-per-call agent framework that handles authentication and payment via x402. Best suited for monitoring, risk assessment, or displaying account state for any Hyperliquid perps trader.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T06:44:30.894Z","isFirstParty":false,"canonicalSlug":"sitecheck-hyperliquid-perps-account-lookup-add30ab8"}