> ## 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.

# userVaultEquities | Hyperliquid info

> Reference docs for the userVaultEquities JSON-RPC method on the Hyperliquid info blockchain, available via Chainstack JSON-RPC nodes.

<Info>
  This method is available on Chainstack. Not all Hyperliquid methods are available on Chainstack, as the open-source node implementation does not support them yet — see [Hyperliquid methods](/docs/hyperliquid-methods) for the full availability breakdown.
</Info>

The `info` endpoint with `type: "userVaultEquities"` retrieves detailed information about a user's equity positions across all vaults they have invested in on the Hyperliquid exchange. This endpoint provides comprehensive investment tracking including current values, profit/loss metrics, and withdrawal details for each vault position.

## Parameters

### Request body

* `type` (string, required) — The request type. Must be `"userVaultEquities"` to retrieve user's vault equity positions.
* `user` (string, required) — Address in 42-character hexadecimal format (e.g., `0x2b804617c6f63c040377e95bb276811747006f4b`).

## Response

The response is an array of vault equity objects representing each vault investment:

### Response structure

Each vault equity object contains:

* `vaultAddress` (string) — Contract address of the vault (42-character hexadecimal)
* `equity` (string) — Current total equity value of the user's position in USD

### Understanding vault equity

**Equity value:**

* Represents the current total value of the user's investment in the vault
* Reflects real-time value based on vault performance and share pricing
* Calculated internally by the vault based on the user's share ownership

**Investment tracking:**

* Each vault investment is tracked separately by vault address
* Equity values change based on vault performance and market conditions
* Values are denominated in USD for easy comparison and analysis

**Vault identification:**

* Vault addresses uniquely identify each vault investment
* Can be used with other endpoints (like `vaultDetails`) to get additional vault information
* Allows tracking of investments across multiple vault positions

## Example request

<CodeGroup>
  ```shell Shell theme={"system"}
  curl -X POST \
    -H "Content-Type: application/json" \
    -d '{"type": "userVaultEquities", "user": "0x2b804617c6f63c040377e95bb276811747006f4b"}' \
    https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info
  ```

  ```python Python (hyperliquid-python-sdk) theme={"system"}
  from hyperliquid.info import Info

  info = Info("YOUR_CHAINSTACK_ENDPOINT", skip_ws=True)

  equities = info.user_vault_equities("0x2b804617c6f63c040377e95bb276811747006f4b")
  print(equities)
  ```

  ```typescript TypeScript (@nktkas/hyperliquid) theme={"system"}
  import { HttpTransport, InfoClient } from "@nktkas/hyperliquid";

  const transport = new HttpTransport({ apiUrl: "YOUR_CHAINSTACK_ENDPOINT" });
  const info = new InfoClient({ transport });

  const equities = await info.userVaultEquities({
    user: "0x2b804617c6f63c040377e95bb276811747006f4b",
  });
  console.log(equities);
  ```
</CodeGroup>

<Note>
  **Use your own endpoint in your code.** The code examples use a placeholder Chainstack endpoint (YOUR\_CHAINSTACK\_ENDPOINT) — replace it with your own Hyperliquid node endpoint from the [Chainstack console](https://console.chainstack.com/). The curl above uses a shared public endpoint for quick checks only; do not use it in production.
</Note>

## Example response

```json theme={"system"}
[
  {
    "vaultAddress": "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303",
    "equity": "742500.082809"
  }
]
```

## Use cases

The `info` endpoint with `type: "userVaultEquities"` is essential for applications that need to:

* **Portfolio tracking**: Monitor all vault investments and their current values
* **Investment overview**: Get a consolidated view of vault equity positions
* **Investment dashboards**: Display vault portfolio summaries with current values
* **Asset allocation analysis**: Understand distribution of investments across vaults
* **Investment reporting**: Generate reports showing current vault equity values
* **Portfolio rebalancing**: Make informed decisions about vault allocations based on current equity
* **Investment interfaces**: Build user-friendly vault portfolio management tools
* **Performance monitoring**: Track vault investment values over time
* **Tax reporting**: Track current investment values for tax purposes
* **Vault comparison**: Compare equity values across different vault investments
* **Risk assessment**: Evaluate exposure and concentration across vault positions
* **Investment analytics**: Analyze vault investment distribution and values

This endpoint provides a simple but essential overview of a user's vault investment portfolio, showing current equity values for each vault position. For more detailed vault information (such as performance metrics, shares, or withdrawal details), combine this data with other vault-related endpoints like `vaultDetails`.


## OpenAPI

````yaml openapi/hyperliquid_node_api/hypercore_info/info_uservaultequities.json post /4f8d8f4040bdacd1577bff8058438274/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://hyperliquid-mainnet.core.chainstack.com
security: []
paths:
  /4f8d8f4040bdacd1577bff8058438274/info:
    post:
      tags:
        - hyperliquid operations
      summary: info (userVaultEquities)
      operationId: infoUserVaultEquities
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                type:
                  type: string
                  default: userVaultEquities
                  enum:
                    - userVaultEquities
                  description: Request type to retrieve user's vault equity positions
                user:
                  type: string
                  default: '0x2b804617c6f63c040377e95bb276811747006f4b'
                  description: Address in 42-character hexadecimal format
              required:
                - type
                - user
      responses:
        '200':
          description: User's vault equity positions and investment details
          content:
            application/json:
              schema:
                type: array
                description: List of user's vault investments with equity details
                items:
                  type: object
                  properties:
                    vaultAddress:
                      type: string
                      description: Contract address of the vault
                    equity:
                      type: string
                      description: Current equity value of user's position (USD)
                  required:
                    - vaultAddress
                    - equity
              example:
                - vaultAddress: '0xdfc24b077bc1425ad1dea75bcb6f8158e10df303'
                  equity: '742500.082809'

````