Skip to main content

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

​
Fetching perpetual vaults

Use the following endpoint to retrieve all active perpetual vaults: 
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:
FieldDescription
idVault identifier — use this in all subsequent API calls
nameDisplay name
currency1Token you deposit and withdraw
currency2Asset being traded
leverageMultiplier applied to trade P&L calculations
perfFeesPerformance fee percentage
depositFeeFee charged on deposit
withdrawalFeeFee charged on withdrawal
riskLevelText risk classification
safetyLevelNumeric safety rating
maxCapMaximum accepted TVL
tvlCurrent total value locked
perf3 / perf6 / perf123-, 6-, and 12-month performance %
mddMaximum 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
Connect your wallet before navigating to the perp vaults section to see your personalised stats automatically populated.

​
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 for the full step-by-step guide.
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.

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