Automated trading bot for Polymarket crypto up/down markets. Beat Spike watches short-term price momentum on Binance or Chainlink, enters only when the move crosses the slug-open beat price, and buys in the direction of the spike (UP on a down→up cross, DOWN on an up→down cross).

Default mode is paper trading — no live orders until you configure credentials and enable execution.

Each Polymarket up/down market has a beat price (the reference price at market open). Beat Spike runs a two-stage pipeline:

1. Momentum trigger — On the configured signal feed, |price_now − price_{now−lookback}| must exceed a USD threshold (e.g. $24 for BTC with a 3s lookback).
2. Beat-cross direction — The lookback window must cross the slug-open beat:
   • Price moves below → above beat → buy UP
   • Price moves above → below beat → buy DOWN
   • No cross → trade rejected

Orders are placed on the Polymarket CLOB (limit by default) during a configurable entry window (e.g. 240s after slug open on 5m BTC markets).

Feed tick
  → |Δ| ≥ threshold?          (momentum spike)
  → ref and now straddle beat?
      → cross up   → BUY UP
      → cross down → BUY DOWN
  → CLOB order on chosen token

The bot reads feeds from the dashboard server by default (feeds.source: server), so start the server before the bot.

• Git
• Python 3.10+ with python3 and venv on your PATH
• Node.js 18+ and npm (for the web dashboard)
• make (Linux/macOS; on Windows use WSL or Git Bash)

Optional for production-style background runs: PM2 (npm install -g pm2).

git clone https://github.com/zerosupercycle/Beat-Spike.git
cd Beat-Spike

make install

This creates a Python virtualenv, installs bot and server requirements, installs web npm packages, and copies .env.example to .env if .env does not exist yet.

Paper mode works out of the box. To customize behavior, edit config/default.yaml.

For live trading, set wallet and CLOB credentials in .env (see Environment variables) and set bot.mode: live plus execution.enabled: true in config.

Open three terminals from the project root:

# Terminal 1 — feeds + API (start this first)
make server

# Terminal 2 — paper trading bot
make bot

# Terminal 3 — dashboard UI
make web

Then open http://localhost:5174 for the dashboard.

Verify the server is up:

make health

Run all services in the background:

make pm2-start    # server + bot + web + monitor
make pm2-status
make pm2-logs
make pm2-stop

Primary config: config/default.yaml

Per-asset thresholds live under strategy.by_asset. Signal feed options: binance or chainlink.

Set in .env (see .env.example):

Legacy DAWN_* env names are still accepted as fallbacks.

1. Set wallet and CLOB credentials in .env.
2. Set execution.enabled: true and bot.mode: live in config (or via env).
3. Confirm risk limits under risk if enabled.
4. Run make server then make bot.

Never commit .env or private keys.

Coinbase is not supported — use Binance or Chainlink.

config/monitor.yaml watches Polymarket profiles for up/down buys and captures price charts. It is disabled by default. Add your own profile URLs to targets and set enabled: true to use it.

bot/           Trading logic, feeds, Polymarket CLOB integration
server/        FastAPI dashboard + feed aggregator
web/           React/Vite dashboard
config/        YAML configuration
data/          Runtime logs and snapshots (gitignored in production)

Run make help for all targets. Common commands:

• make install — Install dependencies
• make server / make bot / make web — Run components
• make bot-stop — Stop a running bot
• make web-build — Production UI build
• make clean — Remove venv and node_modules

This software is for educational and research purposes. Trading on prediction markets involves financial risk. You are responsible for compliance with applicable laws and Polymarket terms of service. Use at your own risk.