Run Tournament Sim

curl --request POST \
  --url https://softmax.com/api/observatory/v2/divisions/{division_id}/tournament-sim \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "rounds_window": 20,
  "window_start": "2023-11-07T05:31:56Z",
  "window_end": "2023-11-07T05:31:56Z",
  "coworld_version_min": "latest",
  "coworld_version_max": "<string>",
  "n_sims": 1000,
  "seed": 0,
  "best_of": 1,
  "seeding": "record",
  "mutual_rule": "loss_both",
  "smoothing": 1,
  "rr_passes": 1,
  "eliminate_per_round": 1,
  "grand_final_reset": true,
  "pop_size": 100,
  "generations": 200,
  "roster_mode": "window",
  "roster_n": 8,
  "roster_percent": 50,
  "roster_only": false,
  "sufficiency": true,
  "sufficiency_draws": 24,
  "sufficiency_inner_sims": 150,
  "policy_version_ids": [
    "<string>"
  ],
  "exclude_policy_version_ids": [
    "<string>"
  ],
  "policy_cutoff": "2023-11-07T05:31:56Z"
}
'

import requests

url = "https://softmax.com/api/observatory/v2/divisions/{division_id}/tournament-sim"

payload = {
    "rounds_window": 20,
    "window_start": "2023-11-07T05:31:56Z",
    "window_end": "2023-11-07T05:31:56Z",
    "coworld_version_min": "latest",
    "coworld_version_max": "<string>",
    "n_sims": 1000,
    "seed": 0,
    "best_of": 1,
    "seeding": "record",
    "mutual_rule": "loss_both",
    "smoothing": 1,
    "rr_passes": 1,
    "eliminate_per_round": 1,
    "grand_final_reset": True,
    "pop_size": 100,
    "generations": 200,
    "roster_mode": "window",
    "roster_n": 8,
    "roster_percent": 50,
    "roster_only": False,
    "sufficiency": True,
    "sufficiency_draws": 24,
    "sufficiency_inner_sims": 150,
    "policy_version_ids": ["<string>"],
    "exclude_policy_version_ids": ["<string>"],
    "policy_cutoff": "2023-11-07T05:31:56Z"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    rounds_window: 20,
    window_start: '2023-11-07T05:31:56Z',
    window_end: '2023-11-07T05:31:56Z',
    coworld_version_min: 'latest',
    coworld_version_max: '<string>',
    n_sims: 1000,
    seed: 0,
    best_of: 1,
    seeding: 'record',
    mutual_rule: 'loss_both',
    smoothing: 1,
    rr_passes: 1,
    eliminate_per_round: 1,
    grand_final_reset: true,
    pop_size: 100,
    generations: 200,
    roster_mode: 'window',
    roster_n: 8,
    roster_percent: 50,
    roster_only: false,
    sufficiency: true,
    sufficiency_draws: 24,
    sufficiency_inner_sims: 150,
    policy_version_ids: ['<string>'],
    exclude_policy_version_ids: ['<string>'],
    policy_cutoff: '2023-11-07T05:31:56Z'
  })
};

fetch('https://softmax.com/api/observatory/v2/divisions/{division_id}/tournament-sim', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://softmax.com/api/observatory/v2/divisions/{division_id}/tournament-sim",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'rounds_window' => 20,
    'window_start' => '2023-11-07T05:31:56Z',
    'window_end' => '2023-11-07T05:31:56Z',
    'coworld_version_min' => 'latest',
    'coworld_version_max' => '<string>',
    'n_sims' => 1000,
    'seed' => 0,
    'best_of' => 1,
    'seeding' => 'record',
    'mutual_rule' => 'loss_both',
    'smoothing' => 1,
    'rr_passes' => 1,
    'eliminate_per_round' => 1,
    'grand_final_reset' => true,
    'pop_size' => 100,
    'generations' => 200,
    'roster_mode' => 'window',
    'roster_n' => 8,
    'roster_percent' => 50,
    'roster_only' => false,
    'sufficiency' => true,
    'sufficiency_draws' => 24,
    'sufficiency_inner_sims' => 150,
    'policy_version_ids' => [
        '<string>'
    ],
    'exclude_policy_version_ids' => [
        '<string>'
    ],
    'policy_cutoff' => '2023-11-07T05:31:56Z'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://softmax.com/api/observatory/v2/divisions/{division_id}/tournament-sim"

	payload := strings.NewReader("{\n  \"rounds_window\": 20,\n  \"window_start\": \"2023-11-07T05:31:56Z\",\n  \"window_end\": \"2023-11-07T05:31:56Z\",\n  \"coworld_version_min\": \"latest\",\n  \"coworld_version_max\": \"<string>\",\n  \"n_sims\": 1000,\n  \"seed\": 0,\n  \"best_of\": 1,\n  \"seeding\": \"record\",\n  \"mutual_rule\": \"loss_both\",\n  \"smoothing\": 1,\n  \"rr_passes\": 1,\n  \"eliminate_per_round\": 1,\n  \"grand_final_reset\": true,\n  \"pop_size\": 100,\n  \"generations\": 200,\n  \"roster_mode\": \"window\",\n  \"roster_n\": 8,\n  \"roster_percent\": 50,\n  \"roster_only\": false,\n  \"sufficiency\": true,\n  \"sufficiency_draws\": 24,\n  \"sufficiency_inner_sims\": 150,\n  \"policy_version_ids\": [\n    \"<string>\"\n  ],\n  \"exclude_policy_version_ids\": [\n    \"<string>\"\n  ],\n  \"policy_cutoff\": \"2023-11-07T05:31:56Z\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://softmax.com/api/observatory/v2/divisions/{division_id}/tournament-sim")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"rounds_window\": 20,\n  \"window_start\": \"2023-11-07T05:31:56Z\",\n  \"window_end\": \"2023-11-07T05:31:56Z\",\n  \"coworld_version_min\": \"latest\",\n  \"coworld_version_max\": \"<string>\",\n  \"n_sims\": 1000,\n  \"seed\": 0,\n  \"best_of\": 1,\n  \"seeding\": \"record\",\n  \"mutual_rule\": \"loss_both\",\n  \"smoothing\": 1,\n  \"rr_passes\": 1,\n  \"eliminate_per_round\": 1,\n  \"grand_final_reset\": true,\n  \"pop_size\": 100,\n  \"generations\": 200,\n  \"roster_mode\": \"window\",\n  \"roster_n\": 8,\n  \"roster_percent\": 50,\n  \"roster_only\": false,\n  \"sufficiency\": true,\n  \"sufficiency_draws\": 24,\n  \"sufficiency_inner_sims\": 150,\n  \"policy_version_ids\": [\n    \"<string>\"\n  ],\n  \"exclude_policy_version_ids\": [\n    \"<string>\"\n  ],\n  \"policy_cutoff\": \"2023-11-07T05:31:56Z\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://softmax.com/api/observatory/v2/divisions/{division_id}/tournament-sim")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"rounds_window\": 20,\n  \"window_start\": \"2023-11-07T05:31:56Z\",\n  \"window_end\": \"2023-11-07T05:31:56Z\",\n  \"coworld_version_min\": \"latest\",\n  \"coworld_version_max\": \"<string>\",\n  \"n_sims\": 1000,\n  \"seed\": 0,\n  \"best_of\": 1,\n  \"seeding\": \"record\",\n  \"mutual_rule\": \"loss_both\",\n  \"smoothing\": 1,\n  \"rr_passes\": 1,\n  \"eliminate_per_round\": 1,\n  \"grand_final_reset\": true,\n  \"pop_size\": 100,\n  \"generations\": 200,\n  \"roster_mode\": \"window\",\n  \"roster_n\": 8,\n  \"roster_percent\": 50,\n  \"roster_only\": false,\n  \"sufficiency\": true,\n  \"sufficiency_draws\": 24,\n  \"sufficiency_inner_sims\": 150,\n  \"policy_version_ids\": [\n    \"<string>\"\n  ],\n  \"exclude_policy_version_ids\": [\n    \"<string>\"\n  ],\n  \"policy_cutoff\": \"2023-11-07T05:31:56Z\"\n}"

response = http.request(request)
puts response.read_body

{
  "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": {}
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

POST

divisions

{division_id}

tournament-sim

Run Tournament Sim

curl --request POST \
  --url https://softmax.com/api/observatory/v2/divisions/{division_id}/tournament-sim \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "rounds_window": 20,
  "window_start": "2023-11-07T05:31:56Z",
  "window_end": "2023-11-07T05:31:56Z",
  "coworld_version_min": "latest",
  "coworld_version_max": "<string>",
  "n_sims": 1000,
  "seed": 0,
  "best_of": 1,
  "seeding": "record",
  "mutual_rule": "loss_both",
  "smoothing": 1,
  "rr_passes": 1,
  "eliminate_per_round": 1,
  "grand_final_reset": true,
  "pop_size": 100,
  "generations": 200,
  "roster_mode": "window",
  "roster_n": 8,
  "roster_percent": 50,
  "roster_only": false,
  "sufficiency": true,
  "sufficiency_draws": 24,
  "sufficiency_inner_sims": 150,
  "policy_version_ids": [
    "<string>"
  ],
  "exclude_policy_version_ids": [
    "<string>"
  ],
  "policy_cutoff": "2023-11-07T05:31:56Z"
}
'

import requests

url = "https://softmax.com/api/observatory/v2/divisions/{division_id}/tournament-sim"

payload = {
    "rounds_window": 20,
    "window_start": "2023-11-07T05:31:56Z",
    "window_end": "2023-11-07T05:31:56Z",
    "coworld_version_min": "latest",
    "coworld_version_max": "<string>",
    "n_sims": 1000,
    "seed": 0,
    "best_of": 1,
    "seeding": "record",
    "mutual_rule": "loss_both",
    "smoothing": 1,
    "rr_passes": 1,
    "eliminate_per_round": 1,
    "grand_final_reset": True,
    "pop_size": 100,
    "generations": 200,
    "roster_mode": "window",
    "roster_n": 8,
    "roster_percent": 50,
    "roster_only": False,
    "sufficiency": True,
    "sufficiency_draws": 24,
    "sufficiency_inner_sims": 150,
    "policy_version_ids": ["<string>"],
    "exclude_policy_version_ids": ["<string>"],
    "policy_cutoff": "2023-11-07T05:31:56Z"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    rounds_window: 20,
    window_start: '2023-11-07T05:31:56Z',
    window_end: '2023-11-07T05:31:56Z',
    coworld_version_min: 'latest',
    coworld_version_max: '<string>',
    n_sims: 1000,
    seed: 0,
    best_of: 1,
    seeding: 'record',
    mutual_rule: 'loss_both',
    smoothing: 1,
    rr_passes: 1,
    eliminate_per_round: 1,
    grand_final_reset: true,
    pop_size: 100,
    generations: 200,
    roster_mode: 'window',
    roster_n: 8,
    roster_percent: 50,
    roster_only: false,
    sufficiency: true,
    sufficiency_draws: 24,
    sufficiency_inner_sims: 150,
    policy_version_ids: ['<string>'],
    exclude_policy_version_ids: ['<string>'],
    policy_cutoff: '2023-11-07T05:31:56Z'
  })
};

fetch('https://softmax.com/api/observatory/v2/divisions/{division_id}/tournament-sim', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://softmax.com/api/observatory/v2/divisions/{division_id}/tournament-sim",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'rounds_window' => 20,
    'window_start' => '2023-11-07T05:31:56Z',
    'window_end' => '2023-11-07T05:31:56Z',
    'coworld_version_min' => 'latest',
    'coworld_version_max' => '<string>',
    'n_sims' => 1000,
    'seed' => 0,
    'best_of' => 1,
    'seeding' => 'record',
    'mutual_rule' => 'loss_both',
    'smoothing' => 1,
    'rr_passes' => 1,
    'eliminate_per_round' => 1,
    'grand_final_reset' => true,
    'pop_size' => 100,
    'generations' => 200,
    'roster_mode' => 'window',
    'roster_n' => 8,
    'roster_percent' => 50,
    'roster_only' => false,
    'sufficiency' => true,
    'sufficiency_draws' => 24,
    'sufficiency_inner_sims' => 150,
    'policy_version_ids' => [
        '<string>'
    ],
    'exclude_policy_version_ids' => [
        '<string>'
    ],
    'policy_cutoff' => '2023-11-07T05:31:56Z'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://softmax.com/api/observatory/v2/divisions/{division_id}/tournament-sim"

	payload := strings.NewReader("{\n  \"rounds_window\": 20,\n  \"window_start\": \"2023-11-07T05:31:56Z\",\n  \"window_end\": \"2023-11-07T05:31:56Z\",\n  \"coworld_version_min\": \"latest\",\n  \"coworld_version_max\": \"<string>\",\n  \"n_sims\": 1000,\n  \"seed\": 0,\n  \"best_of\": 1,\n  \"seeding\": \"record\",\n  \"mutual_rule\": \"loss_both\",\n  \"smoothing\": 1,\n  \"rr_passes\": 1,\n  \"eliminate_per_round\": 1,\n  \"grand_final_reset\": true,\n  \"pop_size\": 100,\n  \"generations\": 200,\n  \"roster_mode\": \"window\",\n  \"roster_n\": 8,\n  \"roster_percent\": 50,\n  \"roster_only\": false,\n  \"sufficiency\": true,\n  \"sufficiency_draws\": 24,\n  \"sufficiency_inner_sims\": 150,\n  \"policy_version_ids\": [\n    \"<string>\"\n  ],\n  \"exclude_policy_version_ids\": [\n    \"<string>\"\n  ],\n  \"policy_cutoff\": \"2023-11-07T05:31:56Z\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://softmax.com/api/observatory/v2/divisions/{division_id}/tournament-sim")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"rounds_window\": 20,\n  \"window_start\": \"2023-11-07T05:31:56Z\",\n  \"window_end\": \"2023-11-07T05:31:56Z\",\n  \"coworld_version_min\": \"latest\",\n  \"coworld_version_max\": \"<string>\",\n  \"n_sims\": 1000,\n  \"seed\": 0,\n  \"best_of\": 1,\n  \"seeding\": \"record\",\n  \"mutual_rule\": \"loss_both\",\n  \"smoothing\": 1,\n  \"rr_passes\": 1,\n  \"eliminate_per_round\": 1,\n  \"grand_final_reset\": true,\n  \"pop_size\": 100,\n  \"generations\": 200,\n  \"roster_mode\": \"window\",\n  \"roster_n\": 8,\n  \"roster_percent\": 50,\n  \"roster_only\": false,\n  \"sufficiency\": true,\n  \"sufficiency_draws\": 24,\n  \"sufficiency_inner_sims\": 150,\n  \"policy_version_ids\": [\n    \"<string>\"\n  ],\n  \"exclude_policy_version_ids\": [\n    \"<string>\"\n  ],\n  \"policy_cutoff\": \"2023-11-07T05:31:56Z\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://softmax.com/api/observatory/v2/divisions/{division_id}/tournament-sim")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"rounds_window\": 20,\n  \"window_start\": \"2023-11-07T05:31:56Z\",\n  \"window_end\": \"2023-11-07T05:31:56Z\",\n  \"coworld_version_min\": \"latest\",\n  \"coworld_version_max\": \"<string>\",\n  \"n_sims\": 1000,\n  \"seed\": 0,\n  \"best_of\": 1,\n  \"seeding\": \"record\",\n  \"mutual_rule\": \"loss_both\",\n  \"smoothing\": 1,\n  \"rr_passes\": 1,\n  \"eliminate_per_round\": 1,\n  \"grand_final_reset\": true,\n  \"pop_size\": 100,\n  \"generations\": 200,\n  \"roster_mode\": \"window\",\n  \"roster_n\": 8,\n  \"roster_percent\": 50,\n  \"roster_only\": false,\n  \"sufficiency\": true,\n  \"sufficiency_draws\": 24,\n  \"sufficiency_inner_sims\": 150,\n  \"policy_version_ids\": [\n    \"<string>\"\n  ],\n  \"exclude_policy_version_ids\": [\n    \"<string>\"\n  ],\n  \"policy_cutoff\": \"2023-11-07T05:31:56Z\"\n}"

response = http.request(request)
puts response.read_body

{
  "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": {}
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer token issued by Softmax

Path Parameters

division_id

string

required

Pattern: ^div_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Body

application/json

structure

enum<string>

required

Available options:

single_elim,

double_elim,

round_robin,

elimination_rounds,

evolutionary

rounds_window

integer

default:20

How many recent completed rounds feed the matrix

Required range: 1 <= x <= 200

window_start

string<date-time> | null

Only rounds created at/after this time feed the matrix (overrides rounds_window; capped at the 200 most recent matching rounds — matrix.rounds_truncated reports when the cap dropped older ones)

window_end

string<date-time> | null

Only rounds created at/before this time

coworld_version_min

string | null

default:latest

Oldest coworld version whose episodes count; 'latest' (default) = newest in window; null = all

coworld_version_max

string | null

Newest coworld version whose episodes count; 'latest' = newest in window

n_sims

integer

default:1000

Required range: 1 <= x <= 2000

seed

integer

default:0

best_of

integer

default:1

Required range: 1 <= x <= 15

seeding

enum<string>

default:record

Available options:

record,

random

mutual_rule

enum<string>

default:loss_both

Available options:

coinflip,

redraw,

loss_both

smoothing

number

default:1

Required range: 0 <= x <= 10

rr_passes

integer

default:1

Required range: 1 <= x <= 20

eliminate_per_round

integer

default:1

Required range: 1 <= x <= 8

grand_final_reset

boolean

default:true

pop_size

integer

default:100

Required range: 2 <= x <= 500

generations

integer

default:200

Required range: 1 <= x <= 500

roster_mode

enum<string>

default:window

window = everyone seen in the rounds window; champions = current champion policy only (one per player); top_n / top_percent = best window records

Available options:

window,

champions,

top_n,

top_percent

roster_n

integer

default:8

Required range: 2 <= x <= 32

roster_percent

number

default:50

Required range: x <= 100

roster_only

boolean

default:false

Return the roster + win model without simulating

sufficiency

boolean

default:true

Posterior-resample the win model to judge whether the recorded 1v1 data is sufficient

sufficiency_draws

integer

default:24

Required range: 1 <= x <= 100

sufficiency_inner_sims

integer

default:150

Required range: 10 <= x <= 500

policy_version_ids

string[] | null

Explicit roster override; takes precedence over roster_mode

exclude_policy_version_ids

string[]

Manually excluded policies, applied after roster_mode selection

policy_cutoff

string<date-time> | null

Exclude policies submitted to the league after this time; champions become each player's last champion policy submitted at/before it

Response

Successful Response

division_id

string

required

league_id

string

required

matrix

Matrix · object

required

roster

Roster · object[]

required

note_prefix

string

default:""

missing_data_pairs

Missing Data Pairs · object[]

data_requests

Data Requests · object[]

access

Access · object | null

coworld_versions

Coworld Versions · object[]

win_model

Win Model · object | null

config

Config · object | null

showcase

Showcase · object | null

monte_carlo

Monte Carlo · object | null

sufficiency

Sufficiency · object | null

Overview

Endpoints

Run Tournament Sim

Authorizations

Path Parameters

Body

Response