What is chanlun-trade-signal?

chanlun-trade-signal is a trading analysis tool built around a technical analysis method called ChanLun, which studies the structure of price movement to identify buy and sell points for Bitcoin against USDT. It pulls public market data from the OKX exchange in read-only mode, meaning it does not need an API key and cannot place trades on your behalf. The core of the project breaks price charts down into layers: fractals mark local highs and lows, these connect into strokes, strokes group into segments, and segments form what ChanLun calls centers. The buy and sell point logic compares the strength of price movement entering and leaving these centers, producing three tiers of buy and sell signals for both uptrends and downtrends. The system also checks multiple timeframes together, five minute, thirty minute, four hour, and daily charts, so a signal on one timeframe can be checked against the others. MACD and trading volume indicators serve as supporting checks alongside this core structure analysis. Beyond signal detection, the tool includes a basic risk planning module that suggests an entry price zone, a stop-loss level, and how much margin to use, based on the detected setup. Results appear through a web frontend built with TradingView's charting library, served locally after running a Python script and viewed in a browser. To use it, someone installs the Python dependencies with pip, runs the server script, and opens a local web page where candlestick charts and the buy or sell signals appear. The project also exposes a small set of HTTP endpoints for fetching candle data and running single or multi timeframe analysis, so it could be called from other scripts instead of only viewed in the browser. The README documents the buy and sell point conditions in both Chinese and English and notes that the project accepts cryptocurrency donations to a listed wallet address. It is licensed under MIT.