Run tournament simulation
/v2/divisions/{division_id}/tournament-simSimulate tournament placements from a division's recorded pairwise results.
Authorization
BearerAuth Bearer token issued by Softmax
In: header
Path Parameters
Division whose recorded results should be simulated.
^div_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$Request Body
application/json
Tournament structure to simulate.
Value in
- "single_elim"
- "double_elim"
- "round_robin"
- "elimination_rounds"
- "evolutionary"
Recent completed rounds used when no explicit time window is set.
1 <= value <= 20020Earliest round creation time to include. Overrides rounds_window and retains at most 200 rounds.
Latest round creation time to include.
Oldest Coworld version to include; latest selects the newest version and null removes the bound.
"latest"Newest Coworld version to include; latest selects the newest version in the window.
Monte Carlo tournament runs to sample.
1 <= value <= 20001000Random seed for deterministic simulation results.
0Odd number of games in each matchup series.
1 <= value <= 151How entrants are assigned bracket seeds.
"record"Value in
- "record"
- "random"
How recorded mutual-loss outcomes are resolved.
"loss_both"Value in
- "coinflip"
- "redraw"
- "loss_both"
Additive smoothing applied to pairwise win rates.
0 <= value <= 101Round-robin passes over every entrant pairing.
1 <= value <= 201Lowest-ranked entrants removed after each elimination round.
1 <= value <= 81Play a reset final when the losers-bracket winner wins the first grand final.
truePopulation size for evolutionary tournaments.
2 <= value <= 500100Generations run for evolutionary tournaments.
1 <= value <= 500200Roster selection rule when policy_version_ids is omitted.
"window"Value in
- "window"
- "champions"
- "top_n"
- "top_percent"
Entrants selected by top_n roster mode.
2 <= value <= 328Percent of entrants selected by top_percent roster mode.
0 < value <= 10050Return the roster and win model without running simulations.
falseEstimate whether the recorded pairwise data is sufficient for stable placements.
truePosterior win-model samples for sufficiency analysis.
1 <= value <= 10024Tournament runs evaluated for each sufficiency sample.
10 <= value <= 500150Explicit policy-version roster; takes precedence over roster_mode. Champions without recorded games use model priors.
Policy versions removed after roster selection.
Exclude later submissions and resolve each player's champion as of this time.
curl -X POST "https://softmax.com/api/observatory/v2/divisions/string/tournament-sim" \ -H "Content-Type: application/json" \ -d '{ "structure": "single_elim" }'{ "division_id": "string", "league_id": "string", "matrix": {}, "roster": [ {} ], "note_prefix": "", "missing_data_pairs": [], "data_requests": [], "access": {}, "coworld_versions": [], "win_model": {}, "config": {}, "showcase": {}, "monte_carlo": {}, "sufficiency": {}}