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

# SuperVaults: Multi-Strategy Vault Portfolios

> Understand how SuperVaults pool multiple trading bots under one deposit, how rebalancing works, and how to explore performance and trade history.

A SuperVault is a vault-of-vaults: a single smart contract that holds your deposit and distributes it across a group of connected individual trading vaults. Instead of choosing and monitoring one strategy at a time, you deposit once into the SuperVault and the system rebalances allocations across all participating vaults automatically. Performance metrics for a SuperVault are computed as the average of the metrics of all its connected vaults.

## Fetching SuperVaults

```http theme={null}
GET /vaults/supervaults
```

Returns all `Supervault` entities where `isActive = true` or `tvl > 0`. Results are cached for 60 seconds. The `Supervault` entity shares most fields with `Vault` but uses a single `currency` field instead of `currency1`/`currency2`, because all connected vaults share the same deposit token.

Key fields returned:

| Field                        | Description                                        |
| ---------------------------- | -------------------------------------------------- |
| `id`                         | SuperVault identifier                              |
| `name`                       | Display name                                       |
| `chain`                      | Blockchain network (defaults to `bsc`)             |
| `contractAddress`            | On-chain contract address                          |
| `currency`                   | Deposit token for this SuperVault                  |
| `perfFees`                   | Performance fee percentage                         |
| `depositFee`                 | Fee charged on deposit                             |
| `withdrawalFee`              | Fee charged on withdrawal                          |
| `safetyLevel`                | Numeric safety rating                              |
| `riskLevel`                  | Text risk classification                           |
| `strategy`                   | Strategy description                               |
| `maxCap`                     | Maximum accepted TVL                               |
| `tvl`                        | Current total value locked                         |
| `perf3` / `perf6` / `perf12` | 3-, 6-, and 12-month average performance %         |
| `perfTot`                    | Average monthly performance across all months      |
| `mdd`                        | Average maximum drawdown % across connected vaults |
| `botOverMarket`              | Average outperformance vs market %                 |

<Note>
  SuperVault performance fields (`perf3`, `perf6`, `perf12`, `perfTot`, `mdd`, `botOverMarket`) are averages computed from all vaults whose `supervault` field matches this SuperVault's `id`. The update runs every 6 hours.
</Note>

## Trade history

To retrieve the 50 most recent trades executed by any vault connected to a SuperVault:

```http theme={null}
GET /vaults/supervault-trades-history/{vaultId}
```

Each record in the response includes:

| Field         | Description                                              |
| ------------- | -------------------------------------------------------- |
| `openAt`      | Timestamp when the trade opened                          |
| `closeAt`     | Timestamp when the trade closed                          |
| `entryPrice`  | Price at trade open                                      |
| `closePrice`  | Price at trade close                                     |
| `openTx`      | Opening transaction hash                                 |
| `closeTx`     | Closing transaction hash                                 |
| `vaultId`     | ID of the individual vault that executed the trade       |
| `tradeSignal` | Signal label from the parent vault's `tradeSignal` field |
| `chain`       | Network the trade occurred on                            |

## How rebalancing works

The SuperVault smart contract distributes your deposit across connected vaults according to its allocation weights. Rebalancing happens automatically on-chain — you do not need to take any action. You can tell which individual vaults are part of a SuperVault by checking the vault detail page, which shows the parent SuperVault relationship.

## SuperVault detail view

The SuperVault detail page shows everything you need to evaluate and manage your position:

<CardGroup cols={2}>
  <Card title="Overview banner" icon="flag">
    Displays the SuperVault name, chain, currency, and top-level performance figures.
  </Card>

  <Card title="Strategy" icon="lightbulb">
    Shows the strategy description for this SuperVault.
  </Card>

  <Card title="Summary cards" icon="table-cells">
    A summary grid showing your balance, max drawdown, TVL, and chain.
  </Card>

  <Card title="Deposit & withdraw" icon="arrow-right-arrow-left">
    Deposit and withdrawal controls, including a link to the contract on BscScan and a display of fees and max capital.
  </Card>

  <Card title="Performance chart" icon="chart-line">
    Performance chart built from the monthly performance data.
  </Card>

  <Card title="Trade history" icon="clock-rotate-left">
    Table of the 50 most recent trades across all connected vaults.
  </Card>
</CardGroup>

## Depositing into a SuperVault

The deposit and withdrawal flow for SuperVaults is identical to standard vaults and uses the same `POST /vaults/deposit` and `POST /vaults/withdraw` endpoints with the SuperVault's `id` as the `vaultId`. See [Depositing and withdrawing](/vaults/deposit-withdraw) for full details.

<Warning>
  Depositing into a SuperVault exposes you to the combined risk of all connected vaults. Review each vault's risk level and strategy before depositing.
</Warning>