Hyperliquid account, positions and PnL

$0.01 per call · failed calls are never charged · no account or subscription: pay per call with a card key or USDC

Any Hyperliquid account by address: perp account value, notional, margin used, withdrawable, leverage and unrealized PnL; every open position with side, size, entry, value, PnL, ROE, liquidation price, leverage and cumulative funding since open (Hyperliquid's cumFunding); spot balances; and up to 50 open orders. Public on-chain data from Hyperliquid's info API, read live. Use to track a trader, a vault or your own agent's book.

Run it free (25 free calls) Buy credits by card (from $1) Example result (JSON)

Try it with your own inputs

The account's 0x address

Uses one of your 25 free calls. Nothing is charged, and a call that fails is not counted.

Inputs

NameTypeDescription
address (required)stringThe account's 0x address

Request

Over HTTP, with a card key from /credits:

curl -H "Authorization: Bearer adt_…" "https://agent-data-tools.revmesh2074.workers.dev/hyperliquid/account?address=0x31ca8395cf837de08b24da3f660e77761dfb974b"

Or one of your 25 free calls, no key:

curl "https://agent-data-tools.revmesh2074.workers.dev/hyperliquid/account?address=0x31ca8395cf837de08b24da3f660e77761dfb974b&trial=1"

Without a key, the same URL answers 402 Payment Required with x402 and MPP terms, so an agent with a wallet pays per call in USDC (Base, Polygon, Arbitrum or Solana over x402; Base or Tempo over MPP) and retries.

Example result

{
  "address": "0x31ca8395cf837de08b24da3f660e77761dfb974b",
  "perps": {
    "accountValueUsd": 3026839.66,
    "notionalUsd": 3356515.67,
    "marginUsedUsd": 167825.78,
    "maintenanceMarginUsd": 33565.16,
    "withdrawableUsd": 2691188.1,
    "leverage": 1.11,
    "unrealizedPnlUsd": 0.32,
    "positions": [
      {
        "coin": "BTC",
        "side": "long",
        "size": 0.01658,
        "entryPrice": 75767.4,
        "positionValueUsd": 1256.55,
        "unrealizedPnlUsd": 0.32,
        "returnOnEquity": 0.0052,
        "liquidationPrice": null,
        "leverage": 20,
        "marginMode": "cross",
        "marginUsedUsd": 62.83,
        "cumFundingSinceOpen": 0
      }
    ]
  },
  "spot": [
    {
      "coin": "USDC",
      "total": 1200.5,
      "onHold": 0,
      "entryNotionalUsd": 0
    }
  ],
  "openOrders": {
    "count": 1,
    "orders": [
      {
        "coin": "ETH",
        "side": "sell",
        "price": 2400,
        "size": 1.1,
        "type": "Limit",
        "reduceOnly": false,
        "triggerPrice": null,
        "placedAt": "2026-11-06T04:00:00.000Z",
        "id": 123456
      }
    ]
  },
  "asOf": "2026-11-06T05:00:00.000Z",
  "source": "Hyperliquid public info API"
}

From an AI agent (MCP)

Add the MCP server to Claude, Cursor or any MCP client. This tool is hyperliquid_account, and the first 25 successful calls are free:

https://agent-data-tools.revmesh2074.workers.dev/mcp

Related tools