clearinghouseState

post

https://api.hyperliquid.xyzhttps://api.hyperliquid-testnet.xyz

/info

Request clearinghouse state.

Body

application/json

Request clearinghouse state.

typeundefined · enumRequired

Type of request.

Possible values:

userstring · min: 42 · max: 42Required

User address.

Pattern: ^0[xX][0-9a-fA-F]+$

dexstringOptional

DEX name (empty string for main dex).

Responses

200

Account summary for perpetual trading.

application/json

422

Failed to deserialize the JSON body into the target type

text/plain

500

Internal Server Error

application/json

post

/info

HTTPcURLJavaScriptPython

POST /info HTTP/1.1
Host: api.hyperliquid.xyz
Content-Type: application/json
Accept: */*
Content-Length: 56

{
  "type": "clearinghouseState",
  "user": "text",
  "dex": "text"
}

{
  "marginSummary": {
    "accountValue": "text",
    "totalNtlPos": "text",
    "totalRawUsd": "text",
    "totalMarginUsed": "text"
  },
  "crossMarginSummary": {
    "accountValue": "text",
    "totalNtlPos": "text",
    "totalRawUsd": "text",
    "totalMarginUsed": "text"
  },
  "crossMaintenanceMarginUsed": "text",
  "withdrawable": "text",
  "assetPositions": [
    {
      "type": "oneWay",
      "position": {
        "coin": "text",
        "szi": "text",
        "leverage": {
          "type": "isolated",
          "value": 1,
          "rawUsd": "text"
        },
        "entryPx": "text",
        "positionValue": "text",
        "unrealizedPnl": "text",
        "returnOnEquity": "text",
        "liquidationPx": "text",
        "marginUsed": "text",
        "maxLeverage": 1,
        "cumFunding": {
          "allTime": "text",
          "sinceOpen": "text",
          "sinceChange": "text"
        }
      }
    }
  ],
  "time": 1
}