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

# vaultSummaries | Hyperliquid Info API

> Hyperliquid vaultSummaries: list summary information for every vault on the platform.

<CardGroup cols={2}>
  <Card title="Credit Cost"> 1 per call</Card>
  <Card title="Processing"> Realtime</Card>
</CardGroup>

The Hyperliquid info endpoint with `type: "vaultSummaries"` is used to list summary information for every vault on the platform.

<Tip>
  Estimate your monthly cost for this API using the [Pricing Calculator](/docs/pricing-calculator?endpoint=%2Fapi-reference%2Fhyperliquid-info%2Fvault-summaries).
</Tip>

<Info>
  * Wire-equal to `POST api.hyperliquid.xyz/info` with `{"type": "vaultSummaries"}`.
  * Returns one entry per vault on the platform. The array may be empty depending on platform state.
  * `relationship.type` distinguishes standalone vaults (`"normal"`) from parent/child vault relationships.
  * This is a global, non-user-keyed type; `tvl` is a decimal string.
  * For a single vault's full breakdown (portfolio history, followers, APR), use <a href="https://goldrush.dev/docs/api-reference/hyperliquid-info/vault-details" target="_blank" rel="noopener noreferrer">vaultDetails</a>.
</Info>

Returns summary information for every vault on the platform, one entry per vault: its name, address, leader, total value locked, closed flag, relationship type, and creation time. Use `vaultDetails` for a single vault's full breakdown.

## Endpoint

```
POST https://hypercore.goldrushdata.com/info
Authorization: Bearer <GOLDRUSH_API_KEY>
Content-Type: application/json
```

## Request

<ParamField body="type" type="string" required>
  Always `"vaultSummaries"`.
</ParamField>

### Example

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://hypercore.goldrushdata.com/info \
    -H "Authorization: Bearer $GOLDRUSH_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "type": "vaultSummaries"
    }'
  ```

  ```typescript TypeScript theme={null}
  const response = await fetch("https://hypercore.goldrushdata.com/info", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.GOLDRUSH_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      type: "vaultSummaries",
    }),
  });

  const vaults = await response.json();
  ```

  ```python Python theme={null}
  import os, requests

  response = requests.post(
      "https://hypercore.goldrushdata.com/info",
      headers={"Authorization": f"Bearer {os.environ['GOLDRUSH_API_KEY']}"},
      json={"type": "vaultSummaries"},
  )

  vaults = response.json()
  ```
</CodeGroup>

## Response

An array of vault-summary objects, one per vault. May be empty depending on platform state.

```json theme={null}
[
  {
    "name": "BlockChain OG",
    "vaultAddress": "0xb9612144b6783f43191c09a7e56333f805ae12dd",
    "leader": "0xc7c6cf1f1a5c5ccb025416b24bbfa678dc5922e7",
    "tvl": "101.0",
    "isClosed": false,
    "relationship": {
      "type": "normal"
    },
    "createTimeMillis": 1773644731666
  }
]
```

### Field descriptions

<Note>
  `tvl` is returned as a **decimal string**, preserving upstream precision. Do not parse it as a float - keep it as a string or use a fixed-precision decimal type.
</Note>

<ResponseField name="name" type="string">Vault name.</ResponseField>

<ResponseField name="vaultAddress" type="string">Vault contract address (0x-prefixed hex).</ResponseField>

<ResponseField name="leader" type="string">Vault leader (manager) address.</ResponseField>

<ResponseField name="tvl" type="string">Total value locked in the vault, in USD, as a decimal string.</ResponseField>

<ResponseField name="isClosed" type="boolean">Whether the vault is closed.</ResponseField>

<ResponseField name="relationship" type="object">
  Relationship metadata for the vault.

  <Expandable title="properties">
    <ResponseField name="type" type="string">Relationship type (e.g. `"normal"` for a standalone vault, or `"parent"` / `"child"` for linked vaults).</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="createTimeMillis" type="int">Vault creation timestamp (Unix ms).</ResponseField>

*Last reviewed: 2026-07-24*