What is polymarket-quick-trade?

This project is a quick trading panel for Polymarket, a prediction market platform, combined with an onchain leaderboard that tracks large traders in real time. It is built by someone who describes it as a tool they personally use often, and the README notes it is stable in daily use. The panel is designed around keyboard shortcuts for fast order placement: arrow keys buy up or down positions, Q and W sell all of your up or down positions, and number keys 1 through 5 pick a trade amount from 5 to 100 dollars. You can quickly switch between short-duration BTC and ETH markets on 5 minute, 15 minute, and 1 hour timeframes, and the panel supports configuring multiple trading accounts that you can switch between with one click. The leaderboard's key idea is how it calculates net positions. Instead of relying on Polymarket's own data API, which the author says only captures trades made as a taker, the tool scans TransferSingle events directly from the CTF contract on the Polygon blockchain. This lets it also catch maker orders and direct wallet transfers, producing what the author calls a more complete net position ranking. The leaderboard uses emoji to flag notable addresses: medals for the top three net holders this round, a whale icon for addresses you add to a tracked watchlist (which also pulls that address's Polymarket username and historical profit and loss), a balance icon for addresses holding both sides of a position, and a fire icon for addresses on a winning streak across recent rounds. Tracked wallet addresses can be edited in a text file that hot-reloads without restarting the script, and the tool caches usernames locally to avoid hitting Polymarket's API too often. Each round's full position data, including buy-in block details, is saved to CSV files for further analysis. Running it requires Python 3.10 or newer, an Alchemy API key for reading Polygon chain data, and your Polymarket trading wallet's private key placed in a local environment file that is excluded from version control. Starting the script launches a local web panel at localhost port 8890.