TypeScript CLIs for Limitless Exchange on Base. Three read-only tools: historical market export, whale trade scanner, and cross-venue ETH 15m order book monitor (Limitless vs Polymarket).
| CLI | Function | Output |
|---|---|---|
fetch-history |
OHLCV-style history download | data/history_<slug>_<interval>.csv |
whale-scanner |
Poll large trades across markets | stdout stream |
live-eth-15min |
Side-by-side ETH 15m books | stdout monitor |
Core paths use public HTTP only — no wallet required. .env.example placeholders are reserved for future order placement.
git clone https://github.com/apex-dao/limitless-trading-bot.git
cd limitless-trading-bot
npm install
cp .env.example .env # optional# History
npm run dev:fetch-history -- --slug eth-up-down-15m --interval 1h
# Whale scanner
npm run dev:whale-scanner -- --min-usd 500 --top 250 --poll 30
npm run dev:whale-scanner -- --poll 1 --max-cycles 1 # smoke
# Cross-venue books
npm run dev:live-eth-15min -- --max-runtime-secs 30Intervals for fetch-history: 1h | 6h | 1d | 1w | 1m | all
npm run build
npm run start:fetch-history -- --slug <slug> --interval 1d
npm run start:whale-scanner -- --min-usd 1000
npm run start:live-eth-15min--slug <market-slug> Required
--interval <1h|6h|1d|1w|1m|all> History window
--min-usd 500 Minimum trade size (USD)
--top 250 Markets to watch
--poll 30 Poll interval (seconds)
--concurrency 6 Parallel requests
--refresh-markets 300 Market list refresh (seconds)
--max-cycles 1 Stop after N cycles
--max-runtime-secs 30 Auto-stop timer
src/
├── cli/
│ ├── fetch-history.ts
│ ├── whale-scanner.ts
│ └── live-eth-15min.ts
├── lib/
│ ├── limitless.ts
│ ├── polymarket.ts
│ ├── orderbook.ts
│ ├── history.ts
│ └── http.ts
└── types/market.ts
flowchart LR
WH[whale-scanner] --> L[Limitless API]
FH[fetch-history] --> L
ETH[live-eth-15min] --> L
ETH --> P[Polymarket API]
FH --> CSV[data/*.csv]
npm run lint
npm run test
npm run build
npm run smoke # fetch-history + whale-scanner + live-eth-15minLIMITLESS_API_KEY=
PRIVATE_KEY=
DRY_RUN=trueLegacy Python scripts were replaced by src/cli/ TypeScript. Use npm scripts above.
- Cross-venue book comparison is research-only; executable arb requires latency, fees, and capital not modeled here.
live-eth-15mincompares public books; no order routing.
ISC — see package.json.