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.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.
Fetching SuperVaults
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 % |
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.Trade history
To retrieve the 50 most recent trades executed by any vault connected to a SuperVault:| 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:Overview banner
Displays the SuperVault name, chain, currency, and top-level performance figures.
Strategy
Shows the strategy description for this SuperVault.
Summary cards
A summary grid showing your balance, max drawdown, TVL, and chain.
Deposit & withdraw
Deposit and withdrawal controls, including a link to the contract on BscScan and a display of fees and max capital.
Performance chart
Performance chart built from the monthly performance data.
Trade history
Table of the 50 most recent trades across all connected vaults.
Depositing into a SuperVault
The deposit and withdrawal flow for SuperVaults is identical to standard vaults and uses the samePOST /vaults/deposit and POST /vaults/withdraw endpoints with the SuperVault’s id as the vaultId. See Depositing and withdrawing for full details.