longbridge-elliott-wave

name

longbridge-elliott-wave

description

Elliott Wave technical timing analysis for individual stocks. Identifies current wave cycle position (impulse 5-wave / corrective ABC), validates with Fibonacci ratios, confirms with momentum indicators (MACD, RSI, volume divergence), and evaluates market environment per market (HK / US / A-share / SGX). Outputs structured natural language report with Fibonacci price zones and actionable reference. Triggers on "波浪分析", "艾略特波浪", "Elliott Wave", "波浪周期", "wave analysis", "技术择时", "technical timing", stock ticker + wave/timing keywords, "现在是第几浪", "处于哪个波浪", "波浪判断", "波浪理论", "浪形分析", "波浪择时".

Elliott Wave Analysis

Response language: match the user's input language — Simplified Chinese / Traditional Chinese / English.

Technical timing skill that positions a stock within its Elliott Wave cycle, confirms with momentum, and contextualizes with market environment. Three modules run sequentially; each result feeds the next.

When to Use

Trigger	Example
Wave position inquiry	"TSLA.US 现在是第几浪" / "700.HK波浪分析"
Technical timing	"NVDA.US 技术择时" / "苹果波浪择时"
Pre-trade check	"我想买，波浪角度看合适吗"
General wave theory	"帮我做个艾略特波浪分析"

Do not trigger if: the user requests fundamental analysis, earnings preview, or valuation — use the relevant skill instead.

Data Sources

All price data comes from the Longbridge CLI. Before the first invocation of any longbridge subcommand in a session, run longbridge <subcommand> --help to confirm available flags, required arguments, and symbol format. Do this for every distinct subcommand you use (e.g. kline, quote, capital, news).

What to fetch

Data	Purpose	Minimum
Daily K-line	Primary wave analysis	≥ 250 bars, JSON
Weekly K-line	Higher-degree wave context	~100 bars, JSON
Current quote	Latest price, range	JSON
Capital flow	Southbound / Northbound flow (if available)	JSON

Symbol validation

Not all ticker-like strings are valid on Longbridge — index codes (e.g. SPX, HSI) are not tradable securities and will return invalid symbol. When you need broad-market data, use a tracking ETF instead (e.g. SPY.US for S&P 500, 2800.HK for HSI). If uncertain whether a symbol is supported, test with a small kline query first and handle the error gracefully.

Practical notes

• Always redirect CLI output to a temp file (e.g. /tmp/kline_day.json) — the CLI may append version notices to stdout that break JSON parsing.
• Use --format json on every call so output is machine-readable.
• Market environment data not available in CLI → use Web Search (see Module C).

Workflow

Step 1 — Pre-flight checks

Before analysis, verify:

1. Run longbridge kline --help and longbridge news --help if you haven't already in this session.
2. Fetch ≥ 300 daily candles for the target symbol in JSON format; save to a temp file.
3. Count returned bars. If < 250 bars → refuse analysis, reply:
   • CN: "历史数据不足250根日K，波浪计数不可靠，建议选择数据更充足的标的。"
   • EN: "Fewer than 250 daily candles available — wave count unreliable."
4. Fetch the 5 most recent news items for the symbol. If recent suspension/resumption or confirmed fraud/delisting → refuse.
5. For A-share: if ticker has "ST" prefix → refuse.

Step 2 — Module A: Wave Cycle Identification

Run scripts/signal_engine.py to compute swing points, wave count, and Fibonacci zones:

python3 scripts/signal_engine.py --kline /tmp/kline_day.json --symbol SYMBOL

The script outputs JSON with:

• stage: wave stage label (see Stage Labels below)
• count_a / count_b: two candidate count scenarios
• agreed: true if both counts give the same stage conclusion
• fib_zones: dict of Fibonacci price levels
• swings: list of recent swing points

If agreed is false → output "结构待确认 / Structure Unconfirmed", do not force a stage label.

Stage Labels (translate to user's language):

Internal	Simplified CN	Traditional CN	English
impulse_early	上升初段	上升初段	Early Impulse
impulse_wave3	主升段（③浪）	主升段（③浪）	Wave 3 Advance
impulse_late	上升末段（⑤浪）	上升末段（⑤浪）	Late Impulse (Wave 5)
top_zone	顶部区域	頂部區域	Top Zone
corrective_abc	调整段（ABC）	調整段（ABC）	ABC Correction
bottom_zone	底部区域	底部區域	Bottom Zone
unconfirmed	结构待确认	結構待確認	Structure Unconfirmed

Step 3 — Module B: Momentum Confirmation

Compute from the same daily K-line data (all calculable from OHLCV, no extra API calls):

Indicator	Parameters	Signal to Report
MACD	12/26/9 EMA	Line vs signal, histogram direction, divergence vs price
RSI	14-period	Level (>70 overbought / <30 oversold), divergence vs price
Volume	Raw volume	Wave 3 highest volume? Wave 5 / C-wave volume vs prior wave
MA trend	20 / 50 SMA	Price above/below each MA; MA slope direction

Critical divergence signals (must flag explicitly):

• Wave 5 top + MACD/RSI bearish divergence → high alert, potential reversal
• C-wave bottom + MACD/RSI bullish divergence → potential bottom
• Wave 3 + volume expansion → confirms wave 3 validity

Each indicator: state its current condition and whether it supports / is neutral toward / contradicts the Module A wave label. Do not sum into a single score.

Step 4 — Module C: Market Environment

Assess macro/market context relevant to the stock's market. Each signal is independent — do not aggregate into a score.

For CLI data in this module, run longbridge <subcommand> --help first if you haven't already. Index codes are not valid symbols on Longbridge — use tracking ETFs instead (see "Suggested proxy" column). If a proxy symbol returns an error, fall back to Web Search.

HK (HKEX)

Signal	How to get	Suggested proxy	Web Search fallback
HSI trend (60-day)	longbridge kline — 60 daily bars	2800.HK (Tracker Fund)	"恒生指数 今日"
Southbound flow	longbridge capital for the target symbol	—	"南向资金 今日净买入"
Short-sell ratio	Not in CLI	—	"[stock name] HK short selling ratio"
Recent policy / regulatory	—	—	Web Search

US (NYSE/NASDAQ)

Signal	How to get	Suggested proxy	Web Search fallback
S&P 500 trend (60-day)	longbridge kline — 60 daily bars	SPY.US	"S&P 500 price today"
VIX level	Not in CLI	—	"VIX current level"
Put/call ratio	Not in CLI	—	"CBOE equity put call ratio"
Sector ETF trend	longbridge kline — 30 daily bars	Relevant sector ETF (e.g. XLK.US, XLE.US)	Web Search

A-share (SSE/SZSE)

Signal	How to get	Suggested proxy	Web Search fallback
Shanghai Composite trend	longbridge kline — 60 daily bars	000001.SH	"上证指数 今日"
Northbound flow	longbridge capital for the target symbol	—	"北向资金 今日"
Margin balance trend	Not in CLI	—	"融资余额"
Recent CSRC/policy signals	—	—	Web Search

SGX

Signal	How to get	Web Search fallback
STI trend	CLI coverage may be limited — try a proxy first, expect errors	"Straits Times Index today"
Stock-specific news	longbridge news for the target symbol	"[company] SGX news"

If a data item is unavailable from both CLI and Web Search, note "数据不可用 / Data unavailable" for that item only. Do not skip the whole module.

Step 5 — Generate Output

Assemble the three-module result into the output template below.

Output Template

The output uses four sections written in natural language — no bullet dumps. Match the user's language (Simplified CN / Traditional CN / English) throughout.

【{Company Name}（{SYMBOL}）】波浪技术分析
分析日期：{today}　｜　当前价：{price}　｜　今日区间：{low} – {high}

【一】波浪结构

当前阶段
{stage_label_natural} · {one-line characterisation}

{2–3 paragraph prose narrative:}
- Para 1: Describe the swing sequence in plain language from the key bottom/origin,
  naming each wave and the price/date of each pivot. Explain why the current move
  matches the identified stage. Avoid jargon — translate wave numbers to meaning.
- Para 2: Confirm with a second counting perspective (different threshold / degree).
  State whether both agree ("两套视角结论一致") or conflict ("结构待确认，建议观望").
- Para 3 (if unconfirmed): Explain what would resolve the ambiguity.

波浪结构示意（ASCII，仅在结构清晰时输出）
价格
  │
{high} ┤                    {stage} ?
  │                      ╱
...                     ╱
{origin}┤  起点╱
  └──────────────────────▶ 时间

斐波那契参考区间

上行延伸目标（基准：{base_swing_low} → {base_swing_high}，波幅 {span}）

| 延伸比例 | 参考价位 | 说明 |
|---------|---------|------|
| 1.618 倍 | {price} | {interpretation} |
| 2.618 倍 | {price} | {interpretation — note if already breached} |
| 3.618 倍 | {price} | {next resistance if prior targets breached} |

回调支撑参考

| 支撑区 | 参考价位 | 说明 |
|-------|---------|------|
| 近期关注 | {price} | 整数关口 / 前期突破区 |
| 中度支撑 | {price} | 内部 38.2% 回撤 |
| 关键支撑 | {price} | 跌破则 {wave} 计数失效 |
| 深度支撑 | {price} | 跌破则整体结构需重新评估 |

失效条件：若日线收盘跌破 {invalidation_price}，{what it means}。

【二】动量与市场环境

动量指标

| 指标 | 当前状态 | 对波浪判断的意义 |
|------|---------|----------------|
| MACD（12/26/9） | 线值 {x} {>/< } 信号线 {y}，柱状图 {z} {扩张/收缩} | {supports/neutral/contradicts + reason} |
| RSI-14 | {value}，{超买/超卖/中性区}，{有/无}背离 | {meaning in context of wave stage} |
| 均线（MA20/MA50） | MA20 {x} / MA50 {y}，价格{领先/滞后}，MA20{向上/走平/向下} | {trend context} |
| 成交量 | 当日 {x}，{高于/低于} 20日均量 {y}（{+/-}%），近3日{放量/缩量} | {confirms or warns} |

{1–2 sentence synthesis: which indicators align, which diverge, and what that means for the wave count.}
{If bearish/bullish divergence detected: ⚠ 检测到 {顶/底}背离——{plain-language explanation of risk}.}

市场背景
{2–4 bullet points from news + Web Search covering catalysts, sector context, macro.
 Each bullet: [emoji] event description → market interpretation.
 End with a note if SPX/VIX data was not fetched: "VIX 及大盘最新状态建议通过 Web Search 确认。"}

【三】综合参考

趋势方向：{one sentence on primary trend and whether counter-trend trades are appropriate now.}

值得关注的区间
{Prose paragraph: describe 1–2 price zones worth watching for entry or caution,
 combining Fibonacci levels + momentum trigger conditions in plain language.}

需要盯住的信号
{3 bullets, each: condition → what it implies for the wave count}

失效观察线：日线收盘跌破 {price}，当前判断需重新评估。

【四】做这个分析前，有几点需要告诉你

{3–4 short paragraphs of plain-language caveats tailored to THIS stock's specific situation:}
- Subjectivity of wave counting and what gives/reduces confidence here
- Fundamental / news drivers and "buy the rumour sell the fact" risk if applicable
- Any unusual price characteristics (e.g. Fibonacci targets already breached, extreme RSI)
- Reminder that daily close matters more than intraday wicks for invalidation levels

---
⚠ 本分析基于历史技术数据，不代表未来表现，不构成投资建议。

Output rules

• No bullet-list dumps in sections 【一】–【三】. Use tables for data, prose for narrative.
• ASCII wave diagram: include when agreed: true; omit when unconfirmed.
• Section 【四】is mandatory — always write stock-specific caveats, never generic boilerplate.
• If agreed: false: replace 【一】prose with "两套计数方案结论不一致，建议观望" and skip the diagram and Fibonacci tables.
• Disclaimer is system-injected at the end; never omit or modify it.

Error Handling

Situation	Response
command not found: longbridge	Fall back to MCP mcp__longbridge__*; if also unavailable, ask user to install longbridge CLI
not logged in / unauthorized	Ask user to run longbridge auth login
< 250 daily candles	Refuse analysis with explanation
Recent suspension / ST stock	Refuse analysis with explanation
Both wave count scenarios conflict, no momentum tiebreak	Output "结构待确认，建议观望" — do not force a label
Web Search unavailable for Module C item	Mark that item as "数据不可用" — continue other items
Other CLI stderr	Surface verbatim — do not silently retry

Script

⚠️ 额外依赖 / Extra dependency required

scripts/signal_engine.py 依赖 pandas 和 numpy，使用前请确认已安装：

pip install pandas numpy

通常已预装；若报 ModuleNotFoundError，运行上述命令后重试。 Requires pandas and numpy — usually pre-installed. Run pip install pandas numpy if you see ModuleNotFoundError.

See scripts/signal_engine.py for the wave engine (ZigZag + 5-wave impulse + ABC correction + Fibonacci validation).

Usage:

python3 scripts/signal_engine.py --kline /tmp/kline_day.json --symbol AAPL.US

MCP fallback

When longbridge CLI is not installed, fall back to MCP tools:

CLI command	MCP tool
longbridge kline <SYMBOL> --period day --format json	mcp__longbridge__candlesticks
longbridge kline <SYMBOL> --period week --format json	mcp__longbridge__candlesticks (period=Week)
longbridge news <SYMBOL> --format json	mcp__longbridge__news

MCP setup: claude mcp add --transport http longbridge https://openapi.longbridge.com/mcp (Quote scope).

Reference Files

File	Contents
references/fibonacci.md	Fibonacci ratio tables for all wave relationships
references/wave-structure.md	Wave structure diagrams, iron rules, corrective variants
references/market-environment.md	Per-market data sources and signal interpretation guide

Related Skills

• longbridge-kline — raw K-line data queries
• longbridge-capital-flow — capital flow data
• idea-generation — fundamental screening to complement technical timing
• earnings-analysis — fundamental event context