caishen

Caishen Trading Platform

Version: 1.0
Last Updated: 2026-02-01
Attribution: Guillaume D.Isabelle

Caishen is a comprehensive Fractal Breakout Trading Platform designed to empower traders with advanced analysis and automated strategy management capabilities. It leverages chaos theory indicators (Bill Williams methodology) to identify and act on fractal breakout opportunities in the market.

Core Creative Intent

Caishen enables users to:

Create strategic entry orders based on fractal breakout patterns.
Perform visual analysis of market chaos indicators across multiple timeframes.
Manage the lifecycle of trading strategies automatically with state machine logic.
Capture historical trading data snapshots for review and learning.

Desired Outcomes:

Users naturally identify high-probability trading opportunities through visual chart analysis.
Entry orders are placed at fractal breakout levels with proper risk management.
Strategy states advance automatically based on market price action.
A complete audit trail of trading decisions and market snapshots is maintained.

Service Architecture

The platform employs a Domain-Driven Service Architecture with a clear separation of concerns across Presentation, Service, and Data Layers.

┌─────────────────────────────────────────────────────────────────┐
│                    PRESENTATION LAYER                           │
│  ┌─────────────────┐  ┌─────────────────┐  ┌─────────────────┐ │
│  │  WinForms UI    │  │  Express API    │  │  Console Apps   │ │
│  │  (Charting)     │  │  (REST/JSON)    │  │  (CLI Tools)    │ │
│  └─────────────────┘  └─────────────────┘  └─────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                    SERVICE LAYER                                │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐  │
│  │   ADS   │ │   SDS   │ │   PDS   │ │   CDS   │ │   IDS   │  │
│  │Analysis │ │Strategy │ │ Price   │ │ Chaos   │ │Indicator│  │
│  │ Data    │ │  Data   │ │  Data   │ │  Data   │ │  Data   │  │
│  │ Service │ │ Service │ │ Service │ │ Service │ │ Service │  │
│  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘  │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐                          │
│  │  BITT   │ │   SE    │ │   THS   │                          │
│  │Timeline │ │ SEngine │ │Historic │                          │
│  │ Service │ │ (Chart) │ │Snapshot │                          │
│  └─────────┘ └─────────┘ └─────────┘                          │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                    DATA LAYER                                   │
│  ┌─────────────────┐  ┌─────────────────┐  ┌─────────────────┐ │
│  │   SQL Server    │  │    MongoDB      │  │  JSON Files     │ │
│  │   (Entities)    │  │  (TimeSeries)   │  │   (CDB DTOs)    │ │
│  └─────────────────┘  └─────────────────┘  └─────────────────┘ │
└─────────────────────────────────────────────────────────────────┘

Core Services:

Component	Description
ADS	Analysis Data Services - Chart data creation and analysis
SDS	Strategic Data Services - Entry order management
PDS	Price Data Services - Market data processing
CDS	Chaos Data Services - Fractals and chaos indicators
IDS	Indicator Data Services - Technical indicators
BITT	Timeline Services - Market charting timeline
SE	SEngine - Charting engine core
THS	Timeline History Services - Snapshots

Key Concepts

POV (Point of View): A specific market instrument at a specific timeframe (e.g., EUR-USD_H4).
CDB (Chaos Data Builder): The central data structure containing all chaos indicator values for a given POV.
BDBO (Bill Williams Divergent Bar Breakout): A fractal breakout entry order with defined breakout price, direction, and state machine logic.
CRSI (Currency Relative Strength Index): Provides relative strength comparison across currency pairs.
TLID (Timeline ID): Unique identifier for historical data snapshots (e.g., yyMMddHHmm).

Fractal Breakout Trading Workflow

The Caishen platform supports an end-to-end workflow for fractal breakout trading, encompassing:

Data Acquisition: Fetching real-time and historical price data.
Analysis: Building ChaosDataBuilder (CDB) with all Bill Williams chaos indicators (Alligator, AO, AC, Fractals, Zones, Gator).
Signal Detection: Identifying initiating fractal signals and divergence patterns.
Strategy Creation: User confirms trade setup, and a BDBO strategy is created, capturing the market snapshot.
Monitoring: Continuous checking of price against breakout levels.
Execution: Automatic submission of entry orders upon breakout detection.
Management: Tracking order status and strategy lifecycle.
Completion: Strategy closure and preservation of timeline for review.

Technology Stack

Original Implementation (C#/.NET):

.NET Framework 4.8, Entity Framework (SQL Server), WinForms UI, WCF Services.

Target Implementation (Python/TypeScript):

Python: Core services, data processing, indicators.
TypeScript: Web UI, REST API.
Persistence: PostgreSQL or MongoDB.
API Layer: FastAPI or Express.

JGT Ecosystem Bridge

Caishen integrates with the JGT Ecosystem to provide a unified trading platform. This bridge enables:

Combined Caishen charting with JGT analysis, including a Medicine Wheel visual interface.
Display of FDB (Fractal Divergent Bar) signals detected by jgtml in Caishen-style charts.
Seamless strategy creation from chart analysis to jgtfxcon order execution.
Visualization of three-universe coherence directly on the charting interface.

Further Documentation

For detailed specifications on each component, data schema, API, and workflow, please refer to the rispecs directory: