apex-dao/limitless-trading-bot

This repository contains three command-line tools for reading data from Limitless Exchange, a prediction market platform built on the Base blockchain. Prediction markets are platforms where users trade on the outcome of real-world events, similar to placing bets on whether something will happen. This set of tools is read-only, meaning it only fetches and displays data rather than placing any trades. The first tool, fetch-history, downloads price and volume history for a specific market and saves it to a CSV file you can open in a spreadsheet. The second tool, whale-scanner, monitors the exchange in real time and prints alerts whenever a large trade above a threshold you set (in US dollars) happens across any active market. The third tool, live-eth-15min, shows a live side-by-side comparison of the order books for a particular ETH price-direction market on both Limitless and Polymarket, another prediction platform. All three tools work by calling public HTTP APIs, so you do not need to connect a wallet or provide any account credentials to use them. A placeholder file exists for future API keys in case order-placement features are added later, but those features are not present yet. Setup requires Node.js and takes a few commands: clone the repository, install dependencies with npm, and run any of the three tools using the npm dev scripts. The README includes full documentation of every command-line flag for each tool. The authors note that the cross-venue comparison is useful for research but is not a ready-made system for executing trades across platforms, as that would require accounting for fees, latency, and available capital.