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

# Trading Vaults: Overview and Vault Types

> Learn what trading vaults are, how they work, and the key differences between standard spot vaults, perpetual vaults, and SuperVaults.

Trading vaults are smart contracts that hold your deposited tokens and execute algorithmic trades on your behalf. You deposit a supported token into a vault, the on-chain strategy runs automatically, and you withdraw your balance — plus or minus any gains or losses — whenever you choose. Each vault tracks its own performance history, total value locked (TVL), and fee structure so you can compare vaults before committing funds.

<CardGroup cols={3}>
  <Card title="Standard vaults" icon="coins">
    Spot trading vaults of type `standard`. These vaults trade a currency pair (e.g. BTC/USDT) on-chain and do not use leverage. Suitable for lower-risk algorithmic strategies.
  </Card>

  <Card title="Perpetual vaults" icon="chart-line">
    Leveraged vaults of type `perp`. These vaults trade perpetual futures contracts and apply a leverage multiplier when calculating performance. Higher potential returns come with higher risk.
  </Card>

  <Card title="SuperVaults" icon="layer-group">
    Vault-of-vaults that aggregate multiple trading bots under a single deposit. Performance metrics are averaged across the connected vaults, and the SuperVault contract rebalances allocations automatically.
  </Card>
</CardGroup>

## Vault properties

Every vault exposes a consistent set of fields from the `Vault` entity. Understanding these fields helps you evaluate a vault before depositing.

### Identity and configuration

<ResponseField name="id" type="string">
  Unique identifier for the vault, used in all API calls.
</ResponseField>

<ResponseField name="name" type="string">
  Human-readable display name.
</ResponseField>

<ResponseField name="chain" type="string" default="bsc">
  Blockchain network the vault is deployed on. Defaults to `bsc` (BNB Smart Chain).
</ResponseField>

<ResponseField name="contractAddress" type="string">
  On-chain address of the vault smart contract.
</ResponseField>

<ResponseField name="currency1" type="string">
  The deposit/withdrawal token (e.g. `USDT`, `BUSD`). This is the token you deposit and receive back.
</ResponseField>

<ResponseField name="currency2" type="string">
  The traded asset (e.g. `BTC`, `ETH`). The strategy buys and sells this asset.
</ResponseField>

<ResponseField name="vaultType" type="VaultType enum">
  One of `standard`, `perp`, `POOL1`, `POOL2`, `POOL3`, `VAULT1`, `VAULT2`, or `VAULT3`.
</ResponseField>

<ResponseField name="leverage" type="integer" default="1">
  Leverage multiplier applied when calculating performance. Standard vaults use `1`; perp vaults use higher values.
</ResponseField>

<ResponseField name="isActive" type="boolean" default="true">
  Whether the vault is currently accepting deposits and executing trades.
</ResponseField>

<ResponseField name="isNew" type="boolean" default="false">
  Flags recently launched vaults.
</ResponseField>

### Fees

<ResponseField name="perfFees" type="decimal">
  Performance fee charged as a percentage of profits.
</ResponseField>

<ResponseField name="depositFee" type="decimal" default="0">
  Fee deducted at deposit time, expressed as a percentage of the deposit amount.
</ResponseField>

<ResponseField name="withdrawalFee" type="decimal" default="0">
  Fee deducted at withdrawal time, expressed as a percentage of the withdrawal amount.
</ResponseField>

### Capacity and value

<ResponseField name="maxCap" type="string">
  Maximum total value the vault will accept. Once reached, new deposits are blocked.
</ResponseField>

<ResponseField name="tvl" type="real">
  Current total value locked in the vault, refreshed periodically.
</ResponseField>

### Risk and strategy

<ResponseField name="safetyLevel" type="integer">
  Numeric safety rating assigned to the vault.
</ResponseField>

<ResponseField name="riskLevel" type="string">
  Text risk classification (e.g. `low`, `medium`, `high`).
</ResponseField>

<ResponseField name="strategy" type="string">
  Description of the trading strategy used by the vault.
</ResponseField>

### Performance metrics

The following fields are recalculated every 6 hours from the vault's closed trade history.

<ResponseField name="perf3" type="decimal">
  Compounded performance over the last 3 months, expressed as a percentage.
</ResponseField>

<ResponseField name="perf6" type="decimal">
  Compounded performance over the last 6 months, expressed as a percentage.
</ResponseField>

<ResponseField name="perf12" type="decimal">
  Compounded performance over the last 12 months, expressed as a percentage.
</ResponseField>

<ResponseField name="perfTot" type="decimal">
  Average monthly performance across all recorded months, expressed as a percentage.
</ResponseField>

<ResponseField name="mdd" type="decimal">
  Maximum drawdown — the largest peak-to-trough loss recorded in the vault's history, expressed as a percentage.
</ResponseField>

<ResponseField name="botOverMarket" type="decimal">
  Outperformance relative to the market: `perf12` minus the 12-month return of the traded asset on CoinGecko. A positive value means the vault outperformed simply holding the asset.
</ResponseField>

### SuperVault linkage

<ResponseField name="supervault" type="string">
  ID of the SuperVault this vault belongs to, if any.
</ResponseField>

<ResponseField name="supervaultId" type="integer" default="-1">
  Numeric index of the parent SuperVault. `-1` means no parent.
</ResponseField>

<ResponseField name="supervaultConnected" type="boolean" default="false">
  Whether this vault is actively connected to a SuperVault and contributes its trades to the SuperVault trade history.
</ResponseField>

## Next steps

<CardGroup cols={2}>
  <Card title="Perpetual vaults" icon="chart-line" href="/vaults/perp-vaults">
    Learn about leveraged vault strategies on perpetual futures.
  </Card>

  <Card title="SuperVaults" icon="layer-group" href="/vaults/supervaults">
    Understand vault-of-vaults and automatic rebalancing.
  </Card>

  <Card title="Depositing and withdrawing" icon="arrow-right-arrow-left" href="/vaults/deposit-withdraw">
    Step-by-step guide to moving funds in and out of vaults.
  </Card>

  <Card title="Performance metrics" icon="chart-bar" href="/vaults/performance">
    Understand how vault performance is calculated and displayed.
  </Card>
</CardGroup>