Focused async Python bot for Polymarket that buys No on standalone non-sports yes/no markets.

FOR ENTERTAINMENT ONLY. PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USE AT YOUR OWN RISK. THE AUTHORS ARE NOT LIABLE FOR ANY CLAIMS, LOSSES, OR DAMAGES.

• bot/: runtime, exchange clients, dashboard, recovery, and the nothing_happens strategy
• scripts/: operational helpers for deployed instances and local inspection
• tests/: focused unit and regression coverage

Runtime

The bot scans standalone markets, looks for NO entries below a configured price cap, tracks open positions, exposes a dashboard, and persists live recovery state when order transmission is enabled.

The runtime is nothing_happens.

Safety Model

Real order transmission requires all three environment variables:

• BOT_MODE=live
• LIVE_TRADING_ENABLED=true
• DRY_RUN=false

If any of those are missing, the bot uses PaperExchangeClient.

Additional live-mode requirements:

• PRIVATE_KEY
• FUNDER_ADDRESS for signature types 1 and 2
• DATABASE_URL
• POLYGON_RPC_URL for proxy-wallet approvals and redemption

Setup

pip install -r requirements.txt
cp config.example.json config.json
cp .env.example .env

config.json is intentionally local and ignored by git.

Configuration

The runtime reads:

• config.json for non-secret runtime settings
• .env for secrets and runtime flags

The runtime config lives under strategies.nothing_happens. See config.example.json and .env.example.

You can point the runtime at a different config file with CONFIG_PATH=/path/to/config.json.

Running Locally

The dashboard binds $PORT or DASHBOARD_PORT when one is set.

Heroku Workflow

The shell helpers use either an explicit app name argument or HEROKU_APP_NAME.

export HEROKU_APP_NAME=<your-app>
./alive.sh
./logs.sh
./live_enabled.sh
./live_disabled.sh
./kill.sh

Generic deployment flow:

heroku config:set BOT_MODE=live DRY_RUN=false LIVE_TRADING_ENABLED=true -a "$HEROKU_APP_NAME"
heroku config:set PRIVATE_KEY=<key> FUNDER_ADDRESS=<addr> POLYGON_RPC_URL=<url> DATABASE_URL=<url> -a "$HEROKU_APP_NAME"
git push heroku <branch>:main
heroku ps:scale web=1 worker=0 -a "$HEROKU_APP_NAME"

Only run the web dyno. The worker entry exists only to fail fast if it is started accidentally.

Tests

Included Scripts

Repository Hygiene

Local config, ledgers, exports, reports, and deployment artifacts are ignored by default.