# Hyperliquid Account Snapshot

> Hyperliquid Account Snapshot is a paid API for AI agents from x402-trading.useotto.xyz, paid per call via x402, $0.001000/call, status unknown (last checked 2026-09-14).

Returns a real-time snapshot of a Hyperliquid perpetual trading account including open positions, balances, and active orders for a given EVM wallet address

## Facts

- Endpoint: GET https://x402-trading.useotto.xyz/hyperliquid-account
- Price: $0.001000/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-trading-useotto-xyz-4d1120e7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_40nUmC51jlxgbtV0-FyG1

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 x402-trading-useotto-xyz-4d1120e7
```

Example prompt: Pull up the current Hyperliquid account snapshot for wallet 0xAbCd1234...5678 — I want to see my open perpetual positions, active orders, and balances right now.

## When to prefer this

Use this endpoint when you need a real-time account snapshot for a specific EVM wallet on Hyperliquid, including live position sizes, margin balances, and open orders. Prefer this over the trading history endpoint when you want current state rather than historical fills or PnL summaries.

## Known failure modes

- Missing or invalid EVM address returns a 400 or validation error
- Address with no Hyperliquid activity may return empty positions and orders arrays
- Hyperliquid API downtime or rate limits may cause 502 or timeout errors
- Malformed address (non-checksummed or wrong length) may fail schema validation

## How this service works

Hyperliquid perpetual trading account snapshot with open positions, balances, and active orders

## Output

Returns a JSON object with account status, open perpetual positions (size, entry price, unrealized PnL), current USDC and margin balances, and any active limit or market orders on Hyperliquid.

## 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": "EVM wallet address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "status": {
       "type": "string"
      },
      "account": {
       "type": "object"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-trading-useotto-xyz-4d1120e7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-trading.useotto.xyz](https://www.zero.xyz/host/x402-trading.useotto.xyz/llms.txt)