Skip to main content
POST
Post Backtest

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

wait_for_result
boolean
default:false

If true, hold the HTTP connection until the backtest finishes (up to 30 s) and return the completed result inline — like a synchronous endpoint. If 30 s isn't enough, you'll get a 504 with the job_id so you can poll GET /v1/backtest/{job_id} instead. Use false (default) for UI / long jobs.

Body

application/json
strategy
Strategy · object
required
Examples:
event_type
string | null
ticker
string | null
since
string<date-time> | null
until
string<date-time> | null
market_limit
integer
default:50
Required range: x <= 500

Response

Successful Response

job_id
string
required
status
enum<string>
required
Available options:
queued,
running,
complete,
failed
submitted_at
string<date-time>
required
strategy
object
required
params
object
required
universe
object
required
result
null
required
error
null
required