---
title: "Submit Ensemble Backtest"
method: POST
path: "/v1/backtests/ensemble"
---

# Submit Ensemble Backtest

`POST /v1/backtests/ensemble`

## Request

- Base URL: `https://api.quantradin.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.quantradin.com/v1/backtests/ensemble`
- Auth: none declared

#39 MULTI-STRATEGY ENSEMBLE: grade 2..8 strategies and blend them.
Body = `members: [{"strategy_id": 5} | {"strategy_spec": {...}}, ...]`
plus `weights: "equal" | [0.5, 0.3, 0.2]` (one positive number per
member, normalised for you).

Every member is graded by the SAME run_backtest a single run uses —
there is no second grading path — and each keeps its OWN honest
verdict. What the ensemble adds is the blended equity curve on a common
date axis, the CORRELATION matrix between the members (measured on
per-step CHANGES over the shared window, never on the cumulative
curves) and the diversification benefit: blended volatility against the
weighted mean of the members' own. "ENSEMBLE" is the row label, like
"PORTFOLIO" — never a judgement.

Auth: same resolution as POST /v1/backtests. Polled via the SAME
GET /v1/backtests/{run_id}; the row's kind is 'ensemble'.

## Headers

- `x-vega-key` string, nullable

## Request body

- EnsembleBacktestRequest: POST /v1/backtests/ensemble (#39) — 2..8 strategies plus how to weight them. Every member is graded by the SAME run_backtest as a single run; what the ensemble adds is the blended curve, the correlation matrix and the diversification benefit. Bounds are enforced in plain words by vega_engine.validate.validate_ensemble.
  - `members` EnsembleMember[], required
    - `strategy_spec` object, nullable
    - `strategy_id` integer, nullable
  - `weights` union
    - number[]
    - string

## Response `200`

Successful Response

- EnsembleBacktestQueued
  - `run_id` string, required
  - `status` string
  - `kind` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/quantradin/apis/vega-api.md) · [All operations](https://skmtc.dev/quantradin/apis/vega-api/llms.txt) · [OpenAPI document](https://skmtc.dev/quantradin/apis/vega-api/revisions/47add154ef38?raw)
