> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useforecast.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Backtests

# Backtests

There are two different backtest surfaces in the codebase today.

## 1. User Backtest Objects

**Route:** `GET /api/v1/backtest`

Lists backtests for the authenticated user, newest first.

### Example

```http theme={null}
GET /api/v1/backtest
Authorization: Bearer USER_JWT
```

## 2. Research Backtest Execution

**Route:** `POST /api/v1/research/backtest`

Runs a concrete strategy against the R2-backed research stack.

### Example

```http theme={null}
POST /api/v1/research/backtest
Authorization: Bearer USER_JWT
Content-Type: application/json
```

```json theme={null}
{
  "entry_executable": {
    "name": "sample strategy"
  },
  "objective": "avg_pnl"
}
```

## Documentation Recommendation

Keep these two surfaces separate in the public docs:

* Backtest jobs as product objects
* Research backtest execution as a premium analytics endpoint