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

# Queue a backtest run

> Creates a queued backtest job for a ready strategy version. Poll the backtest detail endpoint for status and results.



## OpenAPI

````yaml /openapi/traseq-public-agent.json post /public/v1/backtests
openapi: 3.0.0
info:
  title: Traseq Agent API
  description: >-
    Public, versioned API for external integrations and AI agents. Includes API
    key management and machine-readable OpenAPI.
  version: 1.0.0
  contact: {}
servers: []
security: []
tags:
  - name: API Keys
    description: Workspace-scoped API key management
  - name: Agent API
    description: Public API for external integrations and AI agents
paths:
  /public/v1/backtests:
    post:
      tags:
        - Agent API
      summary: Queue a backtest run
      description: >-
        Creates a queued backtest job for a ready strategy version. Poll the
        backtest detail endpoint for status and results.
      operationId: PublicOpenApiController_runBacktest
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - strategyVersionId
                - config
              properties:
                strategyVersionId:
                  type: string
                  format: uuid
                config:
                  type: object
                  required:
                    - timeframe
                    - signalInstrument
                  properties:
                    timeframe:
                      type: string
                      example: 1h
                    signalInstrument:
                      type: object
                      required:
                        - symbol
                      properties:
                        symbol:
                          type: string
                          example: BTCUSDT
                    range:
                      type: object
                      properties:
                        start:
                          type: integer
                          example: 1704067200000
                        end:
                          type: integer
                          example: 1735689600000
                    initialBalance:
                      type: number
                      example: 10000
                    execution:
                      type: object
                      properties:
                        entryOrderRole:
                          type: string
                          enum:
                            - maker
                            - taker
                          example: taker
                        exitOrderRole:
                          type: string
                          enum:
                            - maker
                            - taker
                          example: taker
                        riskOrderRole:
                          type: string
                          enum:
                            - maker
                            - taker
                          example: taker
                        feeModel:
                          type: object
                          properties:
                            kind:
                              type: string
                              enum:
                                - tiered_maker_taker
                              example: tiered_maker_taker
                            tiers:
                              type: array
                              items:
                                type: object
                                required:
                                  - minCumulativeNotional
                                  - makerRate
                                  - takerRate
                                properties:
                                  minCumulativeNotional:
                                    type: number
                                    example: 0
                                  makerRate:
                                    type: number
                                    example: 0.001
                                  takerRate:
                                    type: number
                                    example: 0.001
                        slippage:
                          oneOf:
                            - type: object
                              required:
                                - kind
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - none
                                  example: none
                            - type: object
                              required:
                                - kind
                                - unit
                                - value
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - fixed
                                  example: fixed
                                unit:
                                  type: string
                                  enum:
                                    - bps
                                    - ticks
                                  example: bps
                                value:
                                  type: number
                                  example: 5
                            - type: object
                              required:
                                - kind
                                - reference
                                - multiplier
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - volatility_scaled
                                  example: volatility_scaled
                                reference:
                                  type: string
                                  enum:
                                    - atr_pct
                                    - bar_range_pct
                                  example: atr_pct
                                multiplier:
                                  type: number
                                  example: 0.25
                                atrPeriod:
                                  type: integer
                                  example: 14
                                minBps:
                                  type: number
                                  example: 0
                                maxBps:
                                  type: number
                                  example: 25
                    ambiguityResolution:
                      type: string
                      enum:
                        - multi_resolution
                        - pessimistic
                        - bar_direction
                        - distance
                      example: multi_resolution
                    ambiguityFallback:
                      type: string
                      enum:
                        - pessimistic
                        - bar_direction
                        - distance
                      example: pessimistic
      responses:
        '201':
          description: Backtest job created
      security:
        - traseq-api-key: []
components:
  securitySchemes:
    traseq-api-key:
      type: apiKey
      in: header
      name: x-api-key
      description: Workspace API key for public agent API access

````