# urriki1502/quantum-trader-bot architecture

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

- Interactive diagram: https://gitdiagram.com/urriki1502/quantum-trader-bot
- Repository: https://github.com/urriki1502/quantum-trader-bot

## Overview

QuantumTraderBot is a Solana memecoin discovery and trading system. Its principal workflow is to discover tokens from PumpPortal or blockchain activity, assess token and trading risk, select a strategy, execute trades, and manage exits and portfolio positions. The runtime is coordinated by the bot entry point, with supporting security and operational monitoring. The README documents the broader product capabilities; several implementation files are unsampled, so their relationships are shown only where the README or SOURCE INDEX supports them.

Main entry points: [`QuantumTraderBot/main.py`](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/main.py) (Bot runtime), [`QuantumTraderBot/trading/trading_integration.py`](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/trading/trading_integration.py) (Trading integration), [`QuantumTraderBot/trading/raydium_client.py`](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/trading/raydium_client.py) (Raydium DEX client), [`QuantumTraderBot/network/pump_portal_client.py`](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/network/pump_portal_client.py) (PumpPortal feed)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime"]
  node_bot["Bot runtime<br/>[main.py]"]
  node_config["Configuration<br/>[config_manager.py]"]
  node_state["Component state<br/>[state_manager.py]"]
end

subgraph group_discovery["Discovery and analysis"]
  node_pump["PumpPortal feed"]
  node_chain_scan["On-chain scanner"]
  node_token_analysis["Token analysis<br/>[token_analyzer.py]"]
  node_contract_analysis["Contract analysis"]
  node_signal_analysis["Signal detection"]
end

subgraph group_trading["Trading and portfolio"]
  node_strategy["Strategy manager"]
  node_adaptive["Adaptive strategy"]
  node_trade_flow["Trading integration"]
  node_dex["Raydium DEX client<br/>[raydium_client.py]"]
  node_profit["Profit management"]
  node_portfolio["Portfolio management"]
end

subgraph group_safety["Security and risk"]
  node_risk["Risk controls<br/>[risk_manager.py]"]
  node_wallet_security["Wallet security<br/>[wallet_security.py]"]
  node_security["Security manager"]
  node_mainnet["Mainnet validation"]
end

subgraph group_operations["Operations"]
  node_health["Health monitoring<br/>[health_monitor.py]"]
  node_self_healing["Self-healing"]
  node_alerts["Monitoring and alerts"]
end

node_operator(("Bot operator"))
node_pump_service(("PumpPortal"))
node_solana(("Solana network"))
node_raydium_service(("Solana DEX"))

node_operator -.->|"starts"| node_bot
node_bot -->|"initializes"| node_config
node_bot -->|"registers components"| node_state
node_bot -->|"starts"| node_pump
node_bot -->|"starts"| node_chain_scan
node_bot -->|"starts"| node_trade_flow
node_bot -->|"monitors"| node_health
node_pump -->|"receives feed"| node_pump_service
node_chain_scan -->|"scans chain"| node_solana
node_trade_flow -->|"uses feed"| node_pump
node_trade_flow -->|"uses analysis"| node_chain_scan
node_trade_flow -->|"checks risk"| node_risk
node_trade_flow -->|"evaluates trades"| node_strategy
node_strategy -->|"selects strategy"| node_adaptive
node_trade_flow -->|"executes trades"| node_dex
node_dex -->|"places trades"| node_raydium_service
node_trade_flow -->|"manages exits"| node_profit
node_trade_flow -.->|"manages positions"| node_portfolio
node_bot -->|"initializes"| node_security
node_dex -->|"loads wallet key"| node_security
node_bot -.->|"initializes"| node_mainnet
node_bot -.->|"starts"| node_self_healing
node_bot -->|"starts"| node_alerts
node_bot -.->|"initializes"| node_wallet_security
node_token_analysis -->|"reads state"| node_state
node_token_analysis -->|"reads config"| node_config
node_signal_analysis -.->|"informs decisions"| node_strategy
node_contract_analysis -.->|"informs assessment"| node_risk

click node_bot "https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/main.py"
click node_config "https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/core/config_manager.py"
click node_state "https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/core/state_manager.py"
click node_pump "https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/network/pump_portal_client.py"
click node_chain_scan "https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/network/onchain_analyzer.py"
click node_token_analysis "https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/analysis/ai_core/token_analyzer.py"
click node_contract_analysis "https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/analysis/contract_analyzer.py"
click node_signal_analysis "https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/analysis/ml_signal_detector.py"
click node_strategy "https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/strategy/strategy_manager.py"
click node_adaptive "https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/strategy/adaptive_strategy.py"
click node_trade_flow "https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/trading/trading_integration.py"
click node_risk "https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/trading/risk_manager.py"
click node_dex "https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/trading/raydium_client.py"
click node_profit "https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/trading/dynamic_profit_manager.py"
click node_portfolio "https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/core/portfolio_manager.py"
click node_wallet_security "https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/security/wallet_security.py"
click node_security "https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/core/security_manager.py"
click node_mainnet "https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/core/mainnet_validator.py"
click node_health "https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/monitoring/health_monitor.py"
click node_self_healing "https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/core/self_healing_system.py"
click node_alerts "https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/monitoring/monitoring_system.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_bot,node_config,node_state toneBlue
class node_pump,node_chain_scan,node_token_analysis,node_contract_analysis,node_signal_analysis toneAmber
class node_strategy,node_adaptive,node_trade_flow,node_dex,node_profit,node_portfolio toneMint
class node_risk,node_wallet_security,node_security,node_mainnet toneRose
class node_health,node_self_healing,node_alerts,node_operator,node_pump_service,node_solana,node_raydium_service toneIndigo
```

## Components

### Runtime

- [Bot runtime](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/main.py): `QuantumTraderBot/main.py`
- [Configuration](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/core/config_manager.py): `QuantumTraderBot/core/config_manager.py`
- [Component state](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/core/state_manager.py): `QuantumTraderBot/core/state_manager.py`

### Discovery and analysis

- [PumpPortal feed](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/network/pump_portal_client.py): `QuantumTraderBot/network/pump_portal_client.py`
- [On-chain scanner](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/network/onchain_analyzer.py): `QuantumTraderBot/network/onchain_analyzer.py`
- [Token analysis](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/analysis/ai_core/token_analyzer.py): `QuantumTraderBot/analysis/ai_core/token_analyzer.py`
- [Contract analysis](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/analysis/contract_analyzer.py): `QuantumTraderBot/analysis/contract_analyzer.py`
- [Signal detection](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/analysis/ml_signal_detector.py): `QuantumTraderBot/analysis/ml_signal_detector.py`

### Trading and portfolio

- [Strategy manager](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/strategy/strategy_manager.py): `QuantumTraderBot/strategy/strategy_manager.py`
- [Adaptive strategy](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/strategy/adaptive_strategy.py): `QuantumTraderBot/strategy/adaptive_strategy.py`
- [Trading integration](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/trading/trading_integration.py): `QuantumTraderBot/trading/trading_integration.py`
- [Raydium DEX client](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/trading/raydium_client.py): `QuantumTraderBot/trading/raydium_client.py`
- [Profit management](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/trading/dynamic_profit_manager.py): `QuantumTraderBot/trading/dynamic_profit_manager.py`
- [Portfolio management](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/core/portfolio_manager.py): `QuantumTraderBot/core/portfolio_manager.py`

### Security and risk

- [Risk controls](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/trading/risk_manager.py): `QuantumTraderBot/trading/risk_manager.py`
- [Wallet security](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/security/wallet_security.py): `QuantumTraderBot/security/wallet_security.py`
- [Security manager](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/core/security_manager.py): `QuantumTraderBot/core/security_manager.py`
- [Mainnet validation](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/core/mainnet_validator.py): `QuantumTraderBot/core/mainnet_validator.py`

### Operations

- [Health monitoring](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/monitoring/health_monitor.py): `QuantumTraderBot/monitoring/health_monitor.py`
- [Self-healing](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/core/self_healing_system.py): `QuantumTraderBot/core/self_healing_system.py`
- [Monitoring and alerts](https://github.com/urriki1502/quantum-trader-bot/blob/main/QuantumTraderBot/monitoring/monitoring_system.py): `QuantumTraderBot/monitoring/monitoring_system.py`

### Other components

- **Bot operator**
- **PumpPortal**
- **Solana network**
- **Solana DEX**

## Connections

- Bot operator → Bot runtime: starts
- Bot runtime → Configuration: initializes (evidence: `QuantumTraderBot/main.py`)
- Bot runtime → Component state: registers components (evidence: `QuantumTraderBot/main.py`)
- Bot runtime → PumpPortal feed: starts (evidence: `QuantumTraderBot/main.py`)
- Bot runtime → On-chain scanner: starts (evidence: `QuantumTraderBot/main.py`)
- Bot runtime → Trading integration: starts (evidence: `QuantumTraderBot/main.py`)
- Bot runtime → Health monitoring: monitors (evidence: `QuantumTraderBot/main.py`)
- PumpPortal feed → PumpPortal: receives feed (evidence: `README.md`)
- On-chain scanner → Solana network: scans chain (evidence: `README.md`)
- Trading integration → PumpPortal feed: uses feed (evidence: `QuantumTraderBot/trading/trading_integration.py`)
- Trading integration → On-chain scanner: uses analysis (evidence: `QuantumTraderBot/trading/trading_integration.py`)
- Trading integration → Risk controls: checks risk (evidence: `QuantumTraderBot/trading/trading_integration.py`)
- Trading integration → Strategy manager: evaluates trades (evidence: `QuantumTraderBot/trading/trading_integration.py`)
- Strategy manager → Adaptive strategy: selects strategy (evidence: `QuantumTraderBot/strategy/strategy_manager.py`)
- Trading integration → Raydium DEX client: executes trades (evidence: `QuantumTraderBot/trading/trading_integration.py`)
- Raydium DEX client → Solana DEX: places trades (evidence: `README.md`)
- Trading integration → Profit management: manages exits (evidence: `QuantumTraderBot/trading/trading_integration.py`)
- Trading integration → Portfolio management: manages positions
- Bot runtime → Security manager: initializes (evidence: `QuantumTraderBot/main.py`)
- Raydium DEX client → Security manager: loads wallet key (evidence: `QuantumTraderBot/trading/raydium_client.py`)
- Bot runtime → Mainnet validation: initializes
- Bot runtime → Self-healing: starts
- Bot runtime → Monitoring and alerts: starts (evidence: `QuantumTraderBot/main.py`)
- Bot runtime → Wallet security: initializes
- Token analysis → Component state: reads state (evidence: `QuantumTraderBot/analysis/ai_core/token_analyzer.py`)
- Token analysis → Configuration: reads config (evidence: `QuantumTraderBot/analysis/ai_core/token_analyzer.py`)
- Signal detection → Strategy manager: informs decisions
- Contract analysis → Risk controls: informs assessment
