# SiteCheck Hyperliquid Perps Account Lookup

> SiteCheck Hyperliquid Perps Account Lookup is a paid API for AI agents from api.sitecheck-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-19).

Fetches a Hyperliquid perpetuals account's open positions, margin usage, account value, and withdrawable balance for a given 0x wallet address.

## Facts

- Endpoint: GET https://api.sitecheck-api.workers.dev/api/perps/account?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sitecheck-hyperliquid-perps-account-lookup-add30ab8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9MW7hGvzDeNMJDVZw1SOy

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 sitecheck-hyperliquid-perps-account-lookup-add30ab8
```

Example prompt: What are the open perpetuals positions and account value for my Hyperliquid wallet 0x1234567890abcdef1234567890abcdef12345678?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## 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"
   ],
   "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sitecheck-hyperliquid-perps-account-lookup-add30ab8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.sitecheck-api.workers.dev](https://www.zero.xyz/host/api.sitecheck-api.workers.dev/llms.txt)