# List backtest versions

`GET https://api.cryptohopper.com/v1/backtest/{id}/versions`

Part of [Backtesting](https://www.cryptohopper.com/api-documentation/api-reference/backtesting.md) in the Cryptohopper API reference.

Returns the earlier runs (versions) of one of your backtests, newest first, with date range, balances and profit. Use version_id to get or delete a version.

OAuth scope: `read`

Requires an active subscription or trial; otherwise the request is refused with 403.

## Headers

| Name | Type | Required | Description |
|---|---|---|---|
| `access-token` | string | yes | The OAuth access token of the user. |

## Path parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `id` | string | yes | Backtest ID, as returned by List backtests. |

## Example request

```bash
curl "https://api.cryptohopper.com/v1/backtest/BACKTEST_ID/versions" \
  -H "access-token: YOUR_ACCESS_TOKEN"
```

## Response

Example response (illustrative values):

```json
{
    "data": [
        {
            "backtest_id": "45120",
            "backtest_date": "2026-09-01 10:45:00:17567232001235",
            "start_balance": "1000",
            "end_balance": "1042.5",
            "profit": "4.25",
            "start_date": "2026-08-01 00:00:00",
            "end_date": "2026-08-31 00:00:00",
            "version_id": "2026-09-01_10_45_00_17567232001235"
        }
    ]
}
```

Status codes: 200. Errors return JSON with `status`, `error` and `message`, plus a numeric `code` when the error comes from the API itself rather than the gateway.
