> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# batchClearinghouseStates | Hyperliquid info

> The info endpoint with type: "batchClearinghouseStates" retrieves perpetuals account summaries for multiple users in one call. On Hyperliquid info.

<Warning>
  **Not available.** This batch method is not served by the public Hyperliquid API — requests return `null` for every address — and it is not available through Chainstack. To fetch perpetuals account state for multiple users, call [clearinghouseState](/reference/hyperliquid-info-clearinghousestate) once per address. Some third-party providers offer their own batch aggregators built on per-user calls. This page is kept for reference.
</Warning>

The `info` endpoint with `type: "batchClearinghouseStates"` was intended to retrieve perpetuals account summaries for multiple users in one call — positions, margin usage, and account values across many addresses.

## Parameters

### Request body

* `type` (string, required) — Must be `"batchClearinghouseStates"`.
* `users` (array of strings, required) — One or more onchain addresses in 42‑character hexadecimal format.
* `dex` (string, optional) — Perp dex name. Defaults to the empty string which represents the first perp dex.

## Example request

```shell Shell theme={"system"}
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "type": "batchClearinghouseStates",
    "users": [
      "0x31ca8395cf837de08b24da3f660e77761dfb974b",
      "0x2ba553d9f990a3b66b03b2dc0d030dfc1c061036"
    ]
  }' \
  https://api.hyperliquid.xyz/info
```

## Response

Returns an array. Each item matches the `clearinghouseState` schema with fields like `assetPositions`, `marginSummary`, `crossMarginSummary`, `time`, and `withdrawable`.

### Example response

```json theme={"system"}
[
  {
    "assetPositions": [
      {
        "position": {
          "coin": "ETH",
          "cumFunding": {
            "allTime": "514.085417",
            "sinceChange": "0.0",
            "sinceOpen": "0.0"
          },
          "entryPx": "2986.3",
          "leverage": {
            "rawUsd": "-95.059824",
            "type": "isolated",
            "value": 20
          },
          "liquidationPx": "2866.26936529",
          "marginUsed": "4.967826",
          "maxLeverage": 50,
          "positionValue": "100.02765",
          "returnOnEquity": "-0.0026789",
          "szi": "0.0335",
          "unrealizedPnl": "-0.0134"
        },
        "type": "oneWay"
      }
    ],
    "crossMaintenanceMarginUsed": "0.0",
    "crossMarginSummary": {
      "accountValue": "13104.514502",
      "totalMarginUsed": "0.0",
      "totalNtlPos": "0.0",
      "totalRawUsd": "13104.514502"
    },
    "marginSummary": {
      "accountValue": "13109.482328",
      "totalMarginUsed": "4.967826",
      "totalNtlPos": "100.02765",
      "totalRawUsd": "13009.454678"
    },
    "time": 1708622398623,
    "withdrawable": "13104.514502"
  },
  {
    "assetPositions": [],
    "crossMaintenanceMarginUsed": "0.0",
    "crossMarginSummary": {
      "accountValue": "0.0",
      "totalMarginUsed": "0.0",
      "totalNtlPos": "0.0",
      "totalRawUsd": "0.0"
    },
    "marginSummary": {
      "accountValue": "0.0",
      "totalMarginUsed": "0.0",
      "totalNtlPos": "0.0",
      "totalRawUsd": "0.0"
    },
    "time": 1708622398623,
    "withdrawable": "0.0"
  }
]
```

## Use cases

* Fetch multiple users' perpetuals states for portfolio screens or multi‑account dashboards.
* Power backtesting or analytics jobs that require snapshots across many addresses.
* Reduce API round trips by batching reads.


## OpenAPI

````yaml openapi/hyperliquid_node_api/hypercore_info/info_batch_clearinghouse_states.json post /info
openapi: 3.0.0
info:
  title: Hyperliquid Node API
  version: 1.0.0
  description: This is an API for interacting with Chainstack Hyperliquid node.
servers:
  - url: https://api.hyperliquid.xyz
security: []
paths:
  /info:
    post:
      tags:
        - hyperliquid operations
      summary: info (batchClearinghouseStates)
      operationId: infoBatchClearinghouseStates
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                type:
                  type: string
                  default: batchClearinghouseStates
                  example: batchClearinghouseStates
                  enum:
                    - batchClearinghouseStates
                  description: >-
                    Request type to retrieve multiple users' perpetuals account
                    summaries
                users:
                  type: array
                  description: >-
                    Array of onchain addresses in 42-character hexadecimal
                    format
                  default:
                    - '0x5e9ee1089755c3435139848e47e6635505d5a13a'
                    - '0xb7b6f3cea3f66bf525f5d8f965f6dbf6d9b017b2'
                  example:
                    - '0x5e9ee1089755c3435139848e47e6635505d5a13a'
                    - '0xb7b6f3cea3f66bf525f5d8f965f6dbf6d9b017b2'
                  items:
                    type: string
                    example: '0x0000000000000000000000000000000000000001'
                  minItems: 1
                dex:
                  type: string
                  default: ''
                  example: ''
                  description: >-
                    Perp dex name. Defaults to empty string which represents the
                    first perp dex
              required:
                - type
                - users
              default:
                type: batchClearinghouseStates
                users:
                  - '0x5e9ee1089755c3435139848e47e6635505d5a13a'
                  - '0xb7b6f3cea3f66bf525f5d8f965f6dbf6d9b017b2'
                dex: ''
            example:
              type: batchClearinghouseStates
              users:
                - '0x5e9ee1089755c3435139848e47e6635505d5a13a'
                - '0xb7b6f3cea3f66bf525f5d8f965f6dbf6d9b017b2'
              dex: ''
      responses:
        '200':
          description: >-
            Array of users' perpetuals account summaries including positions and
            margin information
          content:
            application/json:
              schema:
                type: array
                nullable: true
                items:
                  type: object
                  properties:
                    assetPositions:
                      type: array
                      description: Array of user's asset positions
                      items:
                        type: object
                        properties:
                          position:
                            type: object
                            properties:
                              coin:
                                type: string
                                description: Asset symbol
                              cumFunding:
                                type: object
                                description: Cumulative funding information
                                properties:
                                  allTime:
                                    type: string
                                  sinceChange:
                                    type: string
                                  sinceOpen:
                                    type: string
                              entryPx:
                                type: string
                                description: Entry price
                              leverage:
                                type: object
                                description: Leverage information
                                properties:
                                  rawUsd:
                                    type: string
                                  type:
                                    type: string
                                  value:
                                    type: number
                              liquidationPx:
                                type: string
                              marginUsed:
                                type: string
                              maxLeverage:
                                type: number
                              positionValue:
                                type: string
                              returnOnEquity:
                                type: string
                              szi:
                                type: string
                              unrealizedPnl:
                                type: string
                          type:
                            type: string
                            description: Position type
                    crossMaintenanceMarginUsed:
                      type: string
                    crossMarginSummary:
                      type: object
                      properties:
                        accountValue:
                          type: string
                        totalMarginUsed:
                          type: string
                        totalNtlPos:
                          type: string
                        totalRawUsd:
                          type: string
                    marginSummary:
                      type: object
                      properties:
                        accountValue:
                          type: string
                        totalMarginUsed:
                          type: string
                        totalNtlPos:
                          type: string
                        totalRawUsd:
                          type: string
                    time:
                      type: number
                    withdrawable:
                      type: string
      deprecated: true

````