prosperity3submit 0.1.0

Command-line submitter for IMC Prosperity 3 algorithms

IMC Prosperity 3 Submitter

This repository contains a command-line submitter for IMC Prosperity 3 algorithms, based on my submitter for Prosperity 2. It uploads the algorithm, monitors its progress, downloads the logs, logs the final profit / loss, and optionally opens the submission in my Prosperity 3 Visualizer, all in one command.

Usage

Basic usage:

# Install the latest version of the submitter
$ pip install -U prosperity3submit

# Submit an algorithm
$ prosperity3submit <path to algorithm file>

Run pip install -U prosperity3submit again when you want to update the submitter to the latest version.

Submitting requires your Prosperity ID token that is stored in the local storage item with the CognitoIdentityServiceProvider.<some id>.<email>.idToken key on the Prosperity website. You can inspect the local storage items of a website by having the website open in the active tab, pressing F12 to open the browser's developer tools, and going to the Application (Chrome) or Storage (Firefox) tab. From there, click on Local Storage in the sidebar and select the website that appears underneath the sidebar entry.

The submitter will prompt you for the token when it needs it. The token is then stored in your system's credentials store for convenience. ID tokens are short-lived, so you'll be prompted somewhat regularly and old tokens persisted in the credentials store do not pose much of a security risk.

By default, the submitter automatically downloads the submission's logs after simulation is done to submissions/<timestamp>.log. You can change this file using the --out <path to log file> option, or disable downloading logs altogether using the --no-logs flag.

If you use my Prosperity 3 Visualizer, the --vis flag will automatically open the submission in the visualizer after the simulation ends successfully.

Development

Follow these steps if you want to make changes to the backtester:

1. Install uv.
2. Clone (or fork and clone) this repository.
3. Open a terminal in your clone of the repository.
4. Create a venv with uv venv and activate it.
5. Run uv sync.
6. Any changes you make are now automatically taken into account the next time you run prosperity3submit inside the venv.