# direkturcrypto/polymarket-terminal architecture

> Architecture diagram of the GitHub repository direkturcrypto/polymarket-terminal, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/direkturcrypto/polymarket-terminal
- Repository: https://github.com/direkturcrypto/polymarket-terminal

## Overview

Polymarket Terminal runs three documented trading strategies: a maker-rebate market maker, a wallet copy trader, and an orderbook sniper. Their command-line entry points coordinate market discovery or trade monitoring, order execution, and (where applicable) position management and redemption. The graph also includes the legacy market-maker entry point and shared client, configuration, state, and terminal UI layers. Connections are based on README statements and SOURCE INDEX references; unsampled modules are represented only where the README or index supports their role.

Main entry points: [`src/bot.js`](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/bot.js) (Copy trader), [`src/maker-mm-bot.js`](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/maker-mm-bot.js) (Maker MM runner), [`src/sniper.js`](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/sniper.js) (Sniper runner), [`src/sniper-tui.js`](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/sniper-tui.js) (Sniper TUI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_strategies["Strategy entry points"]
  node_copy["Copy trader<br/>[bot.js]"]
  node_maker["Maker MM runner<br/>[maker-mm-bot.js]"]
  node_maker_tui["Maker MM TUI<br/>[maker-mm.js]"]
  node_sniper["Sniper runner<br/>[sniper.js]"]
  node_sniper_tui["Sniper TUI<br/>[sniper-tui.js]"]
  node_classic_mm["Classic MM<br/>[mm-bot.js]"]
  node_classic_tui["Classic MM TUI<br/>[mm.js]"]
end

subgraph group_market["Market monitoring"]
  node_mm_discovery["MM discovery<br/>[mmDetector.js]"]
  node_sniper_discovery["Sniper discovery<br/>[sniperDetector.js]"]
  node_copy_watch["Wallet monitoring<br/>[watcher.js]"]
  node_copy_ws["Trade stream<br/>[wsWatcher.js]"]
  node_mm_fill["MM fill watcher<br/>[mmWsFillWatcher.js]"]
  node_sniper_schedule["Session schedule<br/>[schedule.js]"]
  node_sniper_sizing["Sniper sizing<br/>[sniperSizing.js]"]
end

subgraph group_trading["Execution and positions"]
  node_maker_exec["Maker executor"]
  node_classic_exec["Classic MM executor<br/>[mmExecutor.js]"]
  node_copy_exec["Copy execution<br/>[executor.js]"]
  node_sniper_exec["Sniper execution<br/>[sniperExecutor.js]"]
  node_ctf["CTF operations<br/>[ctf.js]"]
  node_redeemer["Position redemption<br/>[redeemer.js]"]
  node_auto_sell["Auto sell<br/>[autoSell.js]"]
  node_positions["Position tracking<br/>[position.js]"]
end

subgraph group_shared["Shared infrastructure"]
  node_client["CLOB client<br/>[client.js]"]
  node_config["Configuration<br/>[index.js]"]
  node_dashboard["Terminal dashboard<br/>[dashboard.js]"]
  node_state[("Local state<br/>[state.js]")]
  node_sim_stats["Simulation stats<br/>[simStats.js]"]
  node_logger["Logging<br/>[logger.js]"]
  node_proxy["API proxy<br/>[proxy.js]"]
end

node_user(("Operator"))
node_polymarket["Polymarket APIs"]
node_polygon["Polygon RPC"]

node_user -->|"starts"| node_copy
node_user -->|"starts"| node_maker
node_user -->|"starts"| node_maker_tui
node_user -->|"starts"| node_sniper
node_user -->|"starts"| node_sniper_tui
node_user -.->|"starts"| node_classic_mm
node_user -.->|"starts"| node_classic_tui
node_copy -->|"initializes"| node_client
node_copy -->|"delegates to"| node_copy_exec
node_copy -->|"delegates to"| node_redeemer
node_copy -->|"uses"| node_positions
node_copy -->|"starts"| node_copy_ws
node_copy -->|"reads"| node_config
node_maker -->|"initializes"| node_client
node_maker -->|"starts"| node_mm_discovery
node_maker -->|"delegates to"| node_maker_exec
node_maker -->|"starts"| node_mm_fill
node_maker -->|"reads"| node_config
node_maker_tui -->|"starts"| node_mm_discovery
node_maker_tui -->|"delegates to"| node_maker_exec
node_maker_tui -->|"starts"| node_mm_fill
node_maker_tui -->|"renders"| node_dashboard
node_sniper -->|"initializes"| node_client
node_sniper -->|"starts"| node_sniper_discovery
node_sniper -->|"delegates to"| node_sniper_exec
node_sniper -->|"uses"| node_sniper_schedule
node_sniper -->|"uses"| node_sniper_sizing
node_sniper_tui -->|"starts"| node_sniper_discovery
node_sniper_tui -->|"delegates to"| node_sniper_exec
node_sniper_tui -->|"uses"| node_sniper_schedule
node_sniper_tui -->|"uses"| node_sniper_sizing
node_sniper_tui -->|"renders"| node_dashboard
node_classic_mm -->|"starts"| node_mm_discovery
node_classic_mm -->|"delegates to"| node_classic_exec
node_classic_mm -->|"starts"| node_mm_fill
node_classic_tui -->|"delegates to"| node_classic_exec
node_classic_tui -->|"renders"| node_dashboard
node_copy -->|"starts"| node_copy_watch
node_copy_exec -->|"uses"| node_client
node_copy_exec -->|"uses"| node_positions
node_copy_exec -->|"delegates to"| node_auto_sell
node_copy_exec -->|"delegates to"| node_ctf
node_copy_exec -->|"uses"| node_copy_watch
node_maker_exec -->|"uses"| node_client
node_maker_exec -->|"merges positions"| node_ctf
node_maker_exec -->|"listens for fills"| node_mm_fill
node_classic_exec -->|"uses"| node_client
node_classic_exec -->|"splits positions"| node_ctf

click node_copy "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/bot.js"
click node_maker "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/maker-mm-bot.js"
click node_maker_tui "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/maker-mm.js"
click node_sniper "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/sniper.js"
click node_sniper_tui "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/sniper-tui.js"
click node_classic_mm "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/mm-bot.js"
click node_classic_tui "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/mm.js"
click node_mm_discovery "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/mmDetector.js"
click node_sniper_discovery "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/sniperDetector.js"
click node_copy_watch "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/watcher.js"
click node_copy_ws "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/wsWatcher.js"
click node_mm_fill "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/mmWsFillWatcher.js"
click node_sniper_schedule "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/schedule.js"
click node_sniper_sizing "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/sniperSizing.js"
click node_maker_exec "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/makerRebateExecutor.js"
click node_classic_exec "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/mmExecutor.js"
click node_copy_exec "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/executor.js"
click node_sniper_exec "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/sniperExecutor.js"
click node_ctf "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/ctf.js"
click node_redeemer "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/redeemer.js"
click node_auto_sell "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/autoSell.js"
click node_positions "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/position.js"
click node_client "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/client.js"
click node_config "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/config/index.js"
click node_dashboard "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/ui/dashboard.js"
click node_state "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/utils/state.js"
click node_sim_stats "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/utils/simStats.js"
click node_logger "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/utils/logger.js"
click node_proxy "https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/utils/proxy.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_copy,node_maker,node_maker_tui,node_sniper,node_sniper_tui,node_classic_mm,node_classic_tui toneBlue
class node_mm_discovery,node_sniper_discovery,node_copy_watch,node_copy_ws,node_mm_fill,node_sniper_schedule,node_sniper_sizing toneAmber
class node_maker_exec,node_classic_exec,node_copy_exec,node_sniper_exec,node_ctf,node_redeemer,node_auto_sell,node_positions,node_polymarket toneMint
class node_client,node_config,node_dashboard,node_state,node_sim_stats,node_logger,node_proxy toneRose
class node_user,node_polygon toneIndigo
```

## Components

### Strategy entry points

- [Copy trader](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/bot.js): `src/bot.js`
- [Maker MM runner](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/maker-mm-bot.js): `src/maker-mm-bot.js`
- [Maker MM TUI](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/maker-mm.js): `src/maker-mm.js`
- [Sniper runner](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/sniper.js): `src/sniper.js`
- [Sniper TUI](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/sniper-tui.js): `src/sniper-tui.js`
- [Classic MM](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/mm-bot.js): `src/mm-bot.js`
- [Classic MM TUI](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/mm.js): `src/mm.js`

### Market monitoring

- [MM discovery](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/mmDetector.js): `src/services/mmDetector.js`
- [Sniper discovery](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/sniperDetector.js): `src/services/sniperDetector.js`
- [Wallet monitoring](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/watcher.js): `src/services/watcher.js`
- [Trade stream](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/wsWatcher.js): `src/services/wsWatcher.js`
- [MM fill watcher](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/mmWsFillWatcher.js): `src/services/mmWsFillWatcher.js`
- [Session schedule](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/schedule.js): `src/services/schedule.js`
- [Sniper sizing](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/sniperSizing.js): `src/services/sniperSizing.js`

### Execution and positions

- [Maker executor](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/makerRebateExecutor.js): `src/services/makerRebateExecutor.js`
- [Classic MM executor](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/mmExecutor.js): `src/services/mmExecutor.js`
- [Copy execution](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/executor.js): `src/services/executor.js`
- [Sniper execution](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/sniperExecutor.js): `src/services/sniperExecutor.js`
- [CTF operations](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/ctf.js): `src/services/ctf.js`
- [Position redemption](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/redeemer.js): `src/services/redeemer.js`
- [Auto sell](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/autoSell.js): `src/services/autoSell.js`
- [Position tracking](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/position.js): `src/services/position.js`

### Shared infrastructure

- [CLOB client](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/services/client.js): `src/services/client.js`
- [Configuration](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/config/index.js): `src/config/index.js`
- [Terminal dashboard](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/ui/dashboard.js): `src/ui/dashboard.js`
- [Local state](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/utils/state.js): `src/utils/state.js`
- [Simulation stats](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/utils/simStats.js): `src/utils/simStats.js`
- [Logging](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/utils/logger.js): `src/utils/logger.js`
- [API proxy](https://github.com/direkturcrypto/polymarket-terminal/blob/main/src/utils/proxy.js): `src/utils/proxy.js`

### Other components

- **Operator**
- **Polymarket APIs**
- **Polygon RPC**

## Connections

- Operator → Copy trader: starts (evidence: `README.md`)
- Operator → Maker MM runner: starts (evidence: `README.md`)
- Operator → Maker MM TUI: starts (evidence: `README.md`)
- Operator → Sniper runner: starts (evidence: `README.md`)
- Operator → Sniper TUI: starts (evidence: `README.md`)
- Operator → Classic MM: starts
- Operator → Classic MM TUI: starts
- Copy trader → CLOB client: initializes (evidence: `src/bot.js`)
- Copy trader → Copy execution: delegates to (evidence: `src/bot.js`)
- Copy trader → Position redemption: delegates to (evidence: `src/bot.js`)
- Copy trader → Position tracking: uses (evidence: `src/bot.js`)
- Copy trader → Trade stream: starts (evidence: `src/bot.js`)
- Copy trader → Configuration: reads (evidence: `src/bot.js`)
- Maker MM runner → CLOB client: initializes (evidence: `src/maker-mm-bot.js`)
- Maker MM runner → MM discovery: starts (evidence: `src/maker-mm-bot.js`)
- Maker MM runner → Maker executor: delegates to (evidence: `src/maker-mm-bot.js`)
- Maker MM runner → MM fill watcher: starts (evidence: `src/maker-mm-bot.js`)
- Maker MM runner → Configuration: reads (evidence: `src/maker-mm-bot.js`)
- Maker MM TUI → MM discovery: starts (evidence: `src/maker-mm.js`)
- Maker MM TUI → Maker executor: delegates to (evidence: `src/maker-mm.js`)
- Maker MM TUI → MM fill watcher: starts (evidence: `src/maker-mm.js`)
- Maker MM TUI → Terminal dashboard: renders (evidence: `src/maker-mm.js`)
- Sniper runner → CLOB client: initializes (evidence: `src/sniper.js`)
- Sniper runner → Sniper discovery: starts (evidence: `src/sniper.js`)
- Sniper runner → Sniper execution: delegates to (evidence: `src/sniper.js`)
- Sniper runner → Session schedule: uses (evidence: `src/sniper.js`)
- Sniper runner → Sniper sizing: uses (evidence: `src/sniper.js`)
- Sniper TUI → Sniper discovery: starts (evidence: `src/sniper-tui.js`)
- Sniper TUI → Sniper execution: delegates to (evidence: `src/sniper-tui.js`)
- Sniper TUI → Session schedule: uses (evidence: `src/sniper-tui.js`)
- Sniper TUI → Sniper sizing: uses (evidence: `src/sniper-tui.js`)
- Sniper TUI → Terminal dashboard: renders (evidence: `src/sniper-tui.js`)
- Classic MM → MM discovery: starts (evidence: `src/mm-bot.js`)
- Classic MM → Classic MM executor: delegates to (evidence: `src/mm-bot.js`)
- Classic MM → MM fill watcher: starts (evidence: `src/mm-bot.js`)
- Classic MM TUI → Classic MM executor: delegates to (evidence: `src/mm.js`)
- Classic MM TUI → Terminal dashboard: renders (evidence: `src/mm.js`)
- Copy trader → Wallet monitoring: starts (evidence: `src/bot.js`)
- Copy execution → CLOB client: uses (evidence: `src/services/executor.js`)
- Copy execution → Position tracking: uses (evidence: `src/services/executor.js`)
- Copy execution → Auto sell: delegates to (evidence: `src/services/executor.js`)
- Copy execution → CTF operations: delegates to (evidence: `src/services/executor.js`)
- Copy execution → Wallet monitoring: uses (evidence: `src/services/executor.js`)
- Maker executor → CLOB client: uses (evidence: `src/services/makerRebateExecutor.js`)
- Maker executor → CTF operations: merges positions (evidence: `README.md`)
- Maker executor → MM fill watcher: listens for fills (evidence: `src/services/makerRebateExecutor.js`)
- Classic MM executor → CLOB client: uses (evidence: `src/services/mmExecutor.js`)
- Classic MM executor → CTF operations: splits positions (evidence: `src/services/mmExecutor.js`)
