Skip to main content
POST
Create Backtest

Authorizations

X-API-Key
string
header
required

Issue from /v1/keys (or admin-issued for enterprise tier).

Headers

Idempotency-Key
string | null
authorization
string | null
X-API-Key
string | null
POLY_API_KEY
string | null
Poly-API-Key
string | null

Body

application/json
condition_ids
string[]
required
Required array length: 1 - 100 elements
start
string
required
end
string
required
strategy
StrategySpec · object
required
initial_bankroll
string
default:1000
token_ids
Token Ids · object | null

Optional explicit condition_id → token_id map. When omitted, the job resolves tokens from strategy.outcome and archive metadata.

Response

Successful Response

job_id
string
required
status
enum<string>
required
Available options:
pending,
running,
completed,
failed,
cancelled
condition_ids
string[]
required
start
string
required
end
string
required
fill_model
enum<string>
required
Available options:
midpoint,
top_of_book,
depth_walk,
depth_walk_depletion
created_at
string
required
started_at
string | null
completed_at
string | null
error_message
string | null
initial_bankroll
string | null
total_pnl
string | null
total_return_pct
string | null
win_rate
string | null
max_drawdown
string | null
num_trades
integer | null
market_hours_charged
string | null
settlement_scored
boolean
default:false
tick_mode
enum<string> | null
Available options:
grid,
event
ticks_evaluated
integer | null
tick_degraded
boolean
default:false
tick_notice
string | null
is_replay
boolean
default:false
universe_eligible
boolean
default:false
token_ids
Token Ids · object | null