Skip to content
onelayer.
All tools

Tool detail

Hyperliquid Account Intelligence

Returns a Hyperliquid account's perpetuals state — open positions, margin summary and withdrawable balance — for a given 0x address.

Categories: Derivatives data

Use when

  • check a Hyperliquid wallet's open perp positions and margin
  • look up a Hyperliquid account's withdrawable balance
  • inspect another trader's Hyperliquid position sizes by address

Not for

  • not trade fills or order history (see /fills, /open-orders)
  • not spot balances or staking (see /spot, /staking)

Inputs

GET query param: address (string, required, pattern 0x + 40 hex chars).

Admitted input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "0x-prefixed 20-byte Hyperliquid account address"
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false
}

Endpoint

Method
GET
URL
https://hyperliquid-accounts.use.x402atlas.com/state

Payment

Protocol
x402
Listed price
0.01 USDC per call on Base
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
GET https://hyperliquid-accounts.use.x402atlas.com/state
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z