skl2910/limitless-trading-bot

This repository contains three command-line tools for monitoring and analyzing activity on Limitless, a prediction market platform where people buy and sell positions on future events. It is a TypeScript rewrite of earlier Python scripts, meaning the same ideas have been translated into a different programming language that runs on Node.js. The first tool, fetch-history, downloads historical price data for a specific market and saves it as a CSV file you can open in a spreadsheet. You pick the market by its identifier and choose a time interval, such as hourly or daily, and the tool pulls down the records for you. The second tool, whale-scanner, watches prediction markets in real time and flags large trades as they happen. A "whale" in financial slang means someone placing a very big bet. You can set a minimum dollar threshold and control how often it polls for new data. It focuses on the most active markets on the platform. The third tool, live-eth-15min, monitors ETH price markets across both Limitless and Polymarket simultaneously, looking for price differences between the two venues. When the same underlying outcome is priced differently on two platforms, there may be an opportunity to profit from that gap, which traders call an arbitrage edge. All three tools use public, read-only data endpoints, so no account or API key is required to run them. The repository includes setup instructions for installing dependencies, building the TypeScript code, and running each tool. Linting, testing, and a smoke-test command are also available for development purposes.