Intro

Template for a Polymarket trading bot execution + monitoring layer (no strategy included).

Includes CLOB order utilities, position tracking (on-chain ERC1155 preferred), scheduled YES+NO merge, and a terminal TUI.

How to run

npm install
npm run dev -- --config config/bot.yaml

LIVE mode:

• Set mode: LIVE in config/bot.yaml
• Copy config/example.env to .env and set POLY_PRIVATE_KEY=0x...
• Run the same command again

Project structure

• config/
  • bot.yaml: runtime config
  • example.env: env template (private key, RPC, optional CLOB API creds)
• src/index.ts: main loop (market resolve, TUI, feeds, book cache, scheduled merge)
• src/execution/: execution layer (Executor)
• src/market/: market resolve + orderbook caching
• src/price/: price feeds and fallback logic
• src/onchain/: on-chain positions + proxy wallet merge/redeem
• src/tui/: terminal UI
• src/tools/: CLI utilities