# moss-site/moss-trade-bot-skills architecture

> Architecture diagram of the GitHub repository moss-site/moss-trade-bot-skills, 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/moss-site/moss-trade-bot-skills
- Repository: https://github.com/moss-site/moss-trade-bot-skills

## Overview

Moss is a crypto-trading strategy factory: users describe a strategy, Moss evaluates it with historical-market backtests, then supports iterative tuning and live execution. The repository tree contains several version snapshots; this map uses v1.0.27 for the general-purpose workflow and includes the separately visible Ambush live-trading subsystem from v1.0.25-beta. Backtesting, evolution, and natural-language generation are documented capabilities, but their implementation details are not sampled here, so those links are documented rather than source-verified.

Main entry points: [`moss-trade-bot-factory-1.0.27/scripts/core/backtest.py`](https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.27/scripts/core/backtest.py) (Backtesting), [`moss-trade-bot-factory-1.0.25-beta/scripts/ambush/event_handler.py`](https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.25-beta/scripts/ambush/event_handler.py) (Event Handler), [`moss-trade-bot-factory-1.0.27/scripts/core/fetcher.py`](https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.27/scripts/core/fetcher.py) (Market Data), [`moss-trade-bot-factory-1.0.27/scripts/trading_client.py`](https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.27/scripts/trading_client.py) (Trading Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Market Data"]
  node_fetch_data["Data Fetching<br/>[fetch_data.py]"]
  node_market_data[("Market Data<br/>[fetcher.py]")]
end

subgraph group_strategy["Strategy Analysis"]
  node_natural_language["Strategy Brief<br/>[scripts]"]
  node_strategy_creation["Strategy Creation<br/>[scripts]"]
  node_indicators["Indicators<br/>[indicators.py]"]
  node_regime["Regime Detection<br/>[regime.py]"]
  node_decision["Signal Decisions<br/>[decision.py]"]
  node_engine["Strategy Engine<br/>[engine.py]"]
  node_backtest["Backtesting<br/>[backtest.py]"]
  node_evolution["Strategy Evolution"]
end

subgraph group_execution["Trading Execution"]
  node_live_runner["Live Runner<br/>[live_runner.py]"]
  node_trading_client["Trading Client<br/>[trading_client.py]"]
end

subgraph group_ambush["Ambush Live Mode"]
  node_ambush_inputs["Live Event Sources<br/>[ambush]"]
  node_ambush_handler["Event Handler<br/>[event_handler.py]"]
  node_ambush_decision["Ambush Decisions<br/>[decision.py]"]
  node_ambush_features["Market Features<br/>[features.py]"]
  node_ambush_candles["Candle Data"]
  node_ambush_db[("Live State Store<br/>[live_database.py]")]
end

subgraph group_platform["Platform Services"]
  node_exchange{{"Trading Platform"}}
end

node_user(("Trader"))

node_user -->|"describes strategy"| node_natural_language
node_natural_language -->|"informs"| node_strategy_creation
node_strategy_creation -->|"evaluates in"| node_backtest
node_fetch_data -.->|"prepares data"| node_market_data
node_market_data -->|"supplies history"| node_backtest
node_market_data -.->|"provides prices"| node_indicators
node_indicators -->|"forms signals"| node_decision
node_regime -->|"informs simulation"| node_backtest
node_decision -.->|"guides trades"| node_engine
node_engine -.->|"simulates strategy"| node_backtest
node_backtest -->|"feeds reflection"| node_evolution
node_evolution -->|"retunes strategy"| node_backtest
node_live_runner -.->|"submits trades"| node_trading_client
node_trading_client -->|"calls API"| node_exchange
node_ambush_inputs -->|"dispatches events"| node_ambush_handler
node_ambush_handler -->|"uses decisions"| node_ambush_decision
node_ambush_handler -->|"records state"| node_ambush_db
node_ambush_features -->|"uses indicators"| node_ambush_candles
node_ambush_handler -->|"places orders"| node_trading_client

click node_natural_language "https://github.com/moss-site/moss-trade-bot-skills/tree/main/moss-trade-bot-factory-1.0.27/scripts"
click node_strategy_creation "https://github.com/moss-site/moss-trade-bot-skills/tree/main/moss-trade-bot-factory-1.0.27/scripts"
click node_fetch_data "https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.27/scripts/fetch_data.py"
click node_market_data "https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.27/scripts/core/fetcher.py"
click node_indicators "https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.27/scripts/core/indicators.py"
click node_regime "https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.27/scripts/core/regime.py"
click node_decision "https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.27/scripts/core/decision.py"
click node_engine "https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.27/scripts/core/engine.py"
click node_backtest "https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.27/scripts/core/backtest.py"
click node_evolution "https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.27/scripts/run_evolve_backtest.py"
click node_live_runner "https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.27/scripts/live_runner.py"
click node_trading_client "https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.27/scripts/trading_client.py"
click node_ambush_inputs "https://github.com/moss-site/moss-trade-bot-skills/tree/main/moss-trade-bot-factory-1.0.25-beta/scripts/ambush"
click node_ambush_handler "https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.25-beta/scripts/ambush/event_handler.py"
click node_ambush_decision "https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.25-beta/scripts/ambush/decision.py"
click node_ambush_features "https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.25-beta/scripts/ambush/features.py"
click node_ambush_candles "https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.25-beta/scripts/ambush/hyperliquid_candles.py"
click node_ambush_db "https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.25-beta/scripts/ambush/live_database.py"

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_fetch_data,node_market_data toneBlue
class node_natural_language,node_strategy_creation,node_indicators,node_regime,node_decision,node_engine,node_backtest,node_evolution toneAmber
class node_live_runner,node_trading_client toneMint
class node_ambush_inputs,node_ambush_handler,node_ambush_decision,node_ambush_features,node_ambush_candles,node_ambush_db toneRose
class node_exchange,node_user toneIndigo
```

## Components

### Market Data

- [Data Fetching](https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.27/scripts/fetch_data.py): `moss-trade-bot-factory-1.0.27/scripts/fetch_data.py`
- [Market Data](https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.27/scripts/core/fetcher.py): `moss-trade-bot-factory-1.0.27/scripts/core/fetcher.py`

### Strategy Analysis

- [Strategy Brief](https://github.com/moss-site/moss-trade-bot-skills/tree/main/moss-trade-bot-factory-1.0.27/scripts): `moss-trade-bot-factory-1.0.27/scripts`
- [Strategy Creation](https://github.com/moss-site/moss-trade-bot-skills/tree/main/moss-trade-bot-factory-1.0.27/scripts): `moss-trade-bot-factory-1.0.27/scripts`
- [Indicators](https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.27/scripts/core/indicators.py): `moss-trade-bot-factory-1.0.27/scripts/core/indicators.py`
- [Regime Detection](https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.27/scripts/core/regime.py): `moss-trade-bot-factory-1.0.27/scripts/core/regime.py`
- [Signal Decisions](https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.27/scripts/core/decision.py): `moss-trade-bot-factory-1.0.27/scripts/core/decision.py`
- [Strategy Engine](https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.27/scripts/core/engine.py): `moss-trade-bot-factory-1.0.27/scripts/core/engine.py`
- [Backtesting](https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.27/scripts/core/backtest.py): `moss-trade-bot-factory-1.0.27/scripts/core/backtest.py`
- [Strategy Evolution](https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.27/scripts/run_evolve_backtest.py): `moss-trade-bot-factory-1.0.27/scripts/run_evolve_backtest.py`

### Trading Execution

- [Live Runner](https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.27/scripts/live_runner.py): `moss-trade-bot-factory-1.0.27/scripts/live_runner.py`
- [Trading Client](https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.27/scripts/trading_client.py): `moss-trade-bot-factory-1.0.27/scripts/trading_client.py`

### Ambush Live Mode

- [Live Event Sources](https://github.com/moss-site/moss-trade-bot-skills/tree/main/moss-trade-bot-factory-1.0.25-beta/scripts/ambush): `moss-trade-bot-factory-1.0.25-beta/scripts/ambush`
- [Event Handler](https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.25-beta/scripts/ambush/event_handler.py): `moss-trade-bot-factory-1.0.25-beta/scripts/ambush/event_handler.py`
- [Ambush Decisions](https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.25-beta/scripts/ambush/decision.py): `moss-trade-bot-factory-1.0.25-beta/scripts/ambush/decision.py`
- [Market Features](https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.25-beta/scripts/ambush/features.py): `moss-trade-bot-factory-1.0.25-beta/scripts/ambush/features.py`
- [Candle Data](https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.25-beta/scripts/ambush/hyperliquid_candles.py): `moss-trade-bot-factory-1.0.25-beta/scripts/ambush/hyperliquid_candles.py`
- [Live State Store](https://github.com/moss-site/moss-trade-bot-skills/blob/main/moss-trade-bot-factory-1.0.25-beta/scripts/ambush/live_database.py): `moss-trade-bot-factory-1.0.25-beta/scripts/ambush/live_database.py`

### Platform Services

- **Trading Platform**

### Other components

- **Trader**

## Connections

- Trader → Strategy Brief: describes strategy
- Strategy Brief → Strategy Creation: informs
- Strategy Creation → Backtesting: evaluates in
- Data Fetching → Market Data: prepares data
- Market Data → Backtesting: supplies history
- Market Data → Indicators: provides prices
- Indicators → Signal Decisions: forms signals
- Regime Detection → Backtesting: informs simulation
- Signal Decisions → Strategy Engine: guides trades
- Strategy Engine → Backtesting: simulates strategy
- Backtesting → Strategy Evolution: feeds reflection
- Strategy Evolution → Backtesting: retunes strategy
- Live Runner → Trading Client: submits trades
- Trading Client → Trading Platform: calls API
- Live Event Sources → Event Handler: dispatches events (evidence: `moss-trade-bot-factory-1.0.25-beta/scripts/ambush/event_handler.py`)
- Event Handler → Ambush Decisions: uses decisions (evidence: `moss-trade-bot-factory-1.0.25-beta/scripts/ambush/event_handler.py`)
- Event Handler → Live State Store: records state (evidence: `moss-trade-bot-factory-1.0.25-beta/scripts/ambush/event_handler.py`)
- Market Features → Candle Data: uses indicators (evidence: `moss-trade-bot-factory-1.0.25-beta/scripts/ambush/features.py`)
- Event Handler → Trading Client: places orders (evidence: `moss-trade-bot-factory-1.0.25-beta/scripts/ambush/event_handler.py`)
