gitwtfhub

wtf is chanlun-trade-signal?

wepoets1107/chanlun-trade-signal — explained in plain English

Analysis updated 2026-05-18

16PythonAudience · developerComplexity · 3/5LicenseSetup · easy

TL;DR

A Python tool that analyzes BTC/USDT price data using the ChanLun method to detect buy and sell points across multiple timeframes.

Mindmap

mindmap
  root((chanlun-trade-signal))
    What it does
      ChanLun structure analysis
      Buy sell point detection
      BTC USDT signals
    Tech stack
      Python
      OKX market data
      TradingView charts
    Use cases
      Multi timeframe signals
      Risk planning
      Local web dashboard
    Data
      OKX read only
      No API key needed
    Audience
      Crypto traders
      Python developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Detect BTC/USDT buy and sell points using ChanLun stroke and center structure analysis.

REASON 2

Compare trading signals across 5m, 30m, 4H, and daily timeframes at once.

REASON 3

Get suggested entry zones, stop-loss levels, and margin sizing for a detected trade setup.

What's in the stack?

PythonOKX APITradingView Charts

How it stacks up

wepoets1107/chanlun-trade-signal920linjerry-stack/capital-studioadya84/ha-world-cup-2026
Stars161616
LanguagePythonPythonPython
Setup difficultyeasyeasyeasy
Complexity3/53/52/5
Audiencedeveloperresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min

No API key required, just pip install dependencies and run the local server.

Free to use, modify, and distribute for any purpose, including commercial use.

Wtf does this do

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.

Yoink these prompts

Prompt 1
Explain how the ChanLun buy and sell point algorithm works in this chanlun-trade-signal project.
Prompt 2
Walk me through installing and running chanlun-trade-signal locally with Python.
Prompt 3
Show me how to call the /api/analyze/multi-timeframe endpoint from a script.
Prompt 4
Help me understand the difference between strokes, segments, and centers in this ChanLun engine.

Frequently asked questions

wtf is chanlun-trade-signal?

A Python tool that analyzes BTC/USDT price data using the ChanLun method to detect buy and sell points across multiple timeframes.

What language is chanlun-trade-signal written in?

Mainly Python. The stack also includes Python, OKX API, TradingView Charts.

What license does chanlun-trade-signal use?

Free to use, modify, and distribute for any purpose, including commercial use.

How hard is chanlun-trade-signal to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is chanlun-trade-signal for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.