Nothing Ever Happens Polymarket Bot: A Python Bot for Polymarket

The 'Nothing Ever Happens Polymarket Bot' is a Python-based tool designed for Polymarket, focusing on buying 'No' in standalone non-sports yes/no markets. This bot is intended purely for entertainment and comes with no warranties, emphasizing user discretion and risk. The bot operates by scanning markets for 'No' entries below a specified price cap, managing open positions, and providing a dashboard for monitoring. It also maintains a live recovery state when order transmission is active.

## Runtime and Safety

The bot's runtime, known as 'nothing_happens', requires specific environment variables for real order transmission: BOT_MODE set to live, LIVE_TRADING_ENABLED to true, and DRY_RUN to false. Without these, the bot defaults to a PaperExchangeClient, simulating trades without real transactions. Additional live-mode setup involves configuring a PRIVATE_KEY, FUNDER_ADDRESS, DATABASE_URL, and POLYGON_RPC_URL.

## Setup and Configuration

To set up, users must install dependencies, copy example configuration files, and adjust settings in a local config.json and .env file. The bot reads non-secret settings from config.json and secrets from .env. Users can specify a different configuration file path if needed.

## Running and Deployment

Locally, the bot runs with a simple Python command, and the dashboard binds to a specified port. For deployment, particularly on Heroku, shell scripts facilitate operations like checking app status, viewing logs, and toggling live trading. Deployment involves setting environment variables and scaling the web dyno appropriately.

## Testing and Scripts

Testing is supported through pytest, ensuring robust functionality. The bot includes scripts for database inspection, exporting data, analyzing wallet history, and parsing logs, aiding in operational oversight and data management.

## Repository Hygiene

The repository is structured to ignore local configurations, ledgers, and deployment artifacts, maintaining a clean and efficient development environment.