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

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.

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

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

config.json is intentionally local and ignored by git.

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.

python -m bot.main

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

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.

python -m pytest -q

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