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

# Perpetual Vaults: Leveraged Trading Strategies

> Discover how perpetual vaults use leverage on futures contracts, what stats you can track, and how to manage deposits and withdrawals safely.

Perpetual vaults are on-chain vaults of type `perp` that execute algorithmic strategies on perpetual futures contracts. Unlike standard spot vaults, they apply a leverage multiplier when compounding trade results, which amplifies both gains and losses compared to the underlying market movement. Perpetual vaults are deployed on the BNB Smart Chain (BSC) network.

<Warning>
  Leveraged trading can result in losses that exceed your initial deposit. Review the vault's risk level, maximum drawdown (MDD), and leverage factor carefully before depositing.
</Warning>

## Fetching perpetual vaults

Use the following endpoint to retrieve all active perpetual vaults:

```http theme={null}
GET /vaults/perp-vaults
```

The response is an array of `Vault` objects filtered to `vaultType = 'perp'`. The backend returns only vaults where `isActive = true` or `tvl > 0`. Results are cached for 60 seconds.

Key fields to inspect in the response:

| Field                        | Description                                             |
| ---------------------------- | ------------------------------------------------------- |
| `id`                         | Vault identifier — use this in all subsequent API calls |
| `name`                       | Display name                                            |
| `currency1`                  | Token you deposit and withdraw                          |
| `currency2`                  | Asset being traded                                      |
| `leverage`                   | Multiplier applied to trade P\&L calculations           |
| `perfFees`                   | Performance fee percentage                              |
| `depositFee`                 | Fee charged on deposit                                  |
| `withdrawalFee`              | Fee charged on withdrawal                               |
| `riskLevel`                  | Text risk classification                                |
| `safetyLevel`                | Numeric safety rating                                   |
| `maxCap`                     | Maximum accepted TVL                                    |
| `tvl`                        | Current total value locked                              |
| `perf3` / `perf6` / `perf12` | 3-, 6-, and 12-month performance %                      |
| `mdd`                        | Maximum drawdown %                                      |

## Viewing your stats

The `VaultsMyStats` component (used in the perp vaults listing view) surfaces the following aggregate figures for your connected wallet:

* **TVL** — combined total value locked across all vaults including staking
* **Total Deposit** — cumulative amount you have deposited across all vaults
* **Current Balance** — current on-chain value of your vault positions
* **Total Gained** — the difference between your current balance and your total deposit
* **Open Position** — whether a trade is currently open in the vault

<Tip>
  Connect your wallet before navigating to the perp vaults section to see your personalised stats automatically populated.
</Tip>

## Vault detail view

Navigating to an individual perpetual vault opens the vault detail page, which shows the following sections:

* **Vault header** — name, chain, currency pair, and key metrics
* **My Deposit** — your current balance in the deposit token
* **TVL** — current total value locked
* **Performance** — 3-month, 6-month, and 12-month performance figures
* **Performance per month** — month-by-month performance breakdown
* **Strategy** — the vault's strategy description
* **Trade history** — the 50 most recent closed trades

## Deposit and withdrawal flow

The deposit and withdrawal process for perpetual vaults follows the same flow as standard vaults. See [Depositing and withdrawing](/vaults/deposit-withdraw) for the full step-by-step guide.

<Note>
  Some perpetual vaults require an unstake request before you can withdraw. Check whether the vault you are withdrawing from has an active unstake flow by calling `GET /vaults/unstake-requests/all/{account}` before initiating a withdrawal.
</Note>

## Performance and risk

Perp vault performance figures incorporate the vault's leverage multiplier, which means a single losing trade has a proportionally larger negative impact than in a spot vault with the same price movement.

For a full explanation of all performance fields and how to query performance data over time, see [Understanding vault performance metrics](/vaults/performance).