Skip to main content

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

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

POST /api/v1/research/backtest
Authorization: Bearer USER_JWT
Content-Type: application/json
{
  "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