Every vault exposes a set of pre-computed performance metrics that help you evaluate a strategy’s track record. These figures are updated automatically at regular intervals based on the vault’s closed trade history, with leverage applied for perp vaults. Understanding how each metric is derived helps you compare vaults accurately and interpret what the numbers mean for your position.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.
Performance fields explained
3-month performance (%) — the compounded return of all trades that opened within the last 3 months, with the vault’s
leverage multiplier applied. A value of 15.5 means the strategy returned 15.5% over that period.6-month performance (%) — same calculation over the last 6 months.
12-month performance (%) — same calculation over the last 12 months.
Total performance (%) — the average monthly performance across all months for which data exists. This gives a smoothed long-run view of the strategy’s typical monthly returns.
Maximum drawdown (%) — the largest peak-to-trough decline in the vault’s cumulative return since inception. Calculated by walking through all closed trades in chronological order, tracking a running equity curve, and recording the deepest percentage drop from any historical peak. A value of
-12.3 means the worst decline from a peak was 12.3%.Bot vs market (%) — computed as
perf12 minus the 12-month return of currency2 as fetched from CoinGecko. A positive value means the vault outperformed simply buying and holding the traded asset over the same period.For SuperVaults, all performance fields are the average of the corresponding field across all connected member vaults, recomputed automatically at regular intervals.
Querying time-series performance data
To power a performance chart for a specific vault, use the performance data endpoint:The vault ID. If the ID begins with
supervault, the backend aggregates trades from all connected member vaults.Time window for the chart. Accepted values:
| Value | Period |
|---|---|
1M | 30 days |
3M | 90 days |
6M | 180 days |
Year | 365 days |
All | All available history |
| Field | Description |
|---|---|
id | Start timestamp of the data window |
vaultId | The vault ID you queried |
performance | Percentage return for that window, with leverage applied |
Querying personal gains
Your gain for a single vault
Your gain across all vaults
Viewing trade history
openAt descending. Each record includes entry price, close price, and the opening and closing transaction hashes.
This data is rendered as a table in the trade history section of the vault detail view.
Monthly performance breakdown
The vault detail view includes a monthly performance chart showing returns broken down by calendar month. It provides a granular view of seasonality and drawdown periods that the single headline figures do not capture.Safety level and risk level
Each vault carries two complementary risk indicators:safetyLevel(integer) — a numeric score. A higher number indicates a safer, more conservative strategy.riskLevel(string) — a human-readable classification assigned to the vault.