Market Asset Analysis

Market Asset Analysis — Deep Dive

> ⛔ CRITICAL: LẤY GIÁ TỪ SCRIPT/API — KHÔNG BAO GIỜ WEBSEARCH GIÁ > > Hành động ĐẦU TIÊN: chạy python scripts/analyze_all.py [TICKER1] [TICKER2] ... > Script dùng VPS API (realtime) + yfinance (fallback) để lấy giá CHÍNH XÁC từ sàn + phân tích kỹ thuật + cơ bản + dự báo. > Nếu script fail: dùng WebFetch gọi https://bgapidatafeed.vps.com.vn/getliststockdata/[TICKER] > > KHÔNG BAO GIỜ WebSearch giá. WebSearch chỉ cho: tin tức, sentiment, analyst, bear case.

🧠 BƯỚC 0 — ĐỌC JOURNAL TRƯỚC KHI PHÂN TÍCH (Learning Loop)

Skill này có bộ nhớ dài hạn lưu tại ~/.claude/skills-data/market-analyst/. Mỗi lần phân tích đều được ghi journal và Claude phải đọc track record cũ trước khi đưa ra recommendation mới.

Quy trình BẮT BUỘC:

1. Trước phân tích — chạy: python scripts/journal_manager.py context [TICKER] --price [GIA_HIEN_TAI]

• Trả về: track record cũ, calibration score, lessons learned, lịch sử thesis
• Nếu bull_hit_rate /dev/null

python scripts/analyze_all.py VIX SSI DIG

Script sử dụng VPS API (realtime, không cần package) + yfinance (fallback) để lấy:
- ✅ Giá REALTIME chính xác từ sàn (VPS API: `bgapidatafeed.vps.com.vn`)
- ✅ OHLC, volume, khối ngoại mua/bán, order book, room ngoại
- ✅ Phân tích kỹ thuật: RSI, MACD, Bollinger, Ichimoku, VWAP, Elliott Wave, S/R
- ✅ Phân tích cơ bản: P/E, ROE, margins, Piotroski F-Score (từ yfinance)
- ✅ Dự báo 3 kịch bản Bull/Base/Bear
- ✅ `IMPORTANT_INSTRUCTIONS` — liệt kê những gì CẦN và KHÔNG CẦN WebSearch

**Lưu ý giá VPS API:** Trả theo đơn vị nghìn (18.1 = 18,100 VND). Script tự convert.

**Ưu tiên 2 — Nếu script fail (ví dụ trong Claude.ai sandbox):** Dùng **WebFetch** gọi VPS API trực tiếp:

WebFetch URL: https://bgapidatafeed.vps.com.vn/getliststockdata/[TICKER] Prompt: "Trả về JSON: lastPrice, r, c, f, highPrice, lowPrice, openPrice, lot, fBVol, fSVolume, fRoom, avePrice"

Gọi TỪNG MÃ MỘT. Nếu fail, THỬ LẠI 1 lần.

**Ưu tiên 3 — Fallback cuối cùng:** WebSearch giá từ `finance.vietstock.vn` hoặc `cafef.vn`.

### Crypto — Dùng CoinGecko API qua WebFetch

Khi phân tích crypto (BTC, ETH, SOL, etc.), dùng WebFetch gọi CoinGecko:

WebFetch URL: https://api.coingecko.com/api/v3/simple/price?ids=[COINID]&vscurrencies=usd&include24hrchange=true&includemarketcap=true Prompt: "Trả về giá USD, market cap, % thay đổi 24h"

Coin IDs: bitcoin, ethereum, solana, binancecoin, ripple, cardano, avalanche-2, polkadot, chainlink, dogecoin, etc.

Chi tiết crypto (supply, ATH, categories):

WebFetch URL: https://api.coingecko.com/api/v3/coins/[COINID] Prompt: "Trả về: currentprice, marketcap, 24hchange, 7dchange, totalsupply, circulating_supply, ATH, ATL"

Historical chart (7/30/90/365 ngày):

WebFetch URL: https://api.coingecko.com/api/v3/coins/[COINID]/marketchart?vs_currencies=usd&days=30 Prompt: "Trả về price data points theo ngày"

Fear & Greed Index (crypto sentiment):

WebFetch URL: https://api.alternative.me/fng/?limit=7&format=json Prompt: "Trả về Fear & Greed Index: value, classification, 7 ngày gần nhất"

### VN Historical Data (đa khung thời gian)

Khi cần data lịch sử VN stocks (cho phân tích kỹ thuật multi-timeframe):

WebFetch URL: https://histdatafeed.vps.com.vn/tradingview/history?symbol=[TICKER]&resolution=D&from=[UNIXSTART]&to=[UNIXEND] Prompt: "Trả về OHLCV bars: date, open, high, low, close, volume"

Lưu ý: Giá từ historical API chưa điều chỉnh chia cổ tức — dùng cho trend/pattern, không so sánh giá tuyệt đối.

## Bước 2: WebSearch BỔ SUNG (CHỈ cho tin tức & sentiment)

WebSearch KHÔNG dùng để lấy:
- ❌ Giá cổ phiếu (đã có từ VPS API)
- ❌ OHLC, volume, khối ngoại (đã có từ VPS API)

WebSearch CHỈ dùng cho:
- ✅ Tin tức mới nhất
- ✅ Analyst consensus & khuyến nghị
- ✅ Bear case / rủi ro / contrarian
- ✅ Insider activity
- ✅ Bối cảnh vĩ mô
- ✅ RSI, MACD, chỉ báo kỹ thuật, P/E, ROE (nếu cần)

### Tại sao cần nhiều nguồn

Một nguồn duy nhất dễ bị bias — analyst có thể bullish vì đang hold, tin tức có thể outdated. Cross-validation từ nhiều nguồn giúp phát hiện inconsistency và tăng confidence.

### Queries cho cổ phiếu VN (ví dụ [TICKER]):

"[ticker] KQKD quý gần nhất doanh thu lợi nhuận" "[ticker] triển vọng 2026 analyst khuyến nghị" "[ticker] tin tức mới nhất" "[ticker] rủi ro thách thức 2026" ← BẮT BUỘC: search rủi ro "[ticker] bear case riskier downside" ← BẮT BUỘC: search bear case "[ticker] khối ngoại mua bán insider" "ngành [sector] triển vọng rủi ro 2026" "[ticker] đối thủ cạnh tranh so sánh"

### Queries cho crypto:

"[coin] on-chain metrics whale activity" "[coin] risks regulatory concerns" ← BẮT BUỘC "[coin] bearish analysis 2026" ← BẮT BUỘC "[coin] upcoming catalysts roadmap"

### Nguồn data bổ sung
- Script/VPS API đã cung cấp giá realtime — dùng làm nền tảng
- WebSearch cho phân tích kỹ thuật, cơ bản, sentiment, và bối cảnh

### Đánh giá "Price-in" cho mỗi finding

Mỗi thông tin tìm được, đánh giá: thị trường đã biết và phản ánh vào giá chưa? Điều này quan trọng vì tin tốt đã price-in thì không còn là catalyst, và tin xấu đã price-in thì không còn là rủi ro.

- "KQKD Q1 tốt hơn kỳ vọng" → nếu giá đã tăng 20% trước earnings → phần lớn đã price-in
- "Rủi ro trade war" → nếu giá đã giảm 15% → một phần đã price-in, nhưng nếu tariff thực sự áp dụng thì có thể giảm thêm

## Bước 3: Chấm điểm (dựa trên data từ Script/API + WebSearch)

Cho điểm 0-100 cho từng hạng mục:
- **Technical Score**: RSI, MACD, Ichimoku Cloud, VWAP, trend alignment, S/R proximity, volume patterns
- **Fundamental Score**: Valuation vs peers, growth quality, balance sheet (stocks only)
- **Sentiment Score**: Tin tức gần đây, dòng tiền tổ chức, retail sentiment
- **Overall Health Score**: Weighted average (Tech 25%, Fund 35%, Sent 20%, macro context 20%)

Grade: A (80-100), B (60-79), C (40-59), D (20-39), F (0-19)

## Bước 4: Dự báo 3 kịch bản

Mỗi phân tích phải kết thúc bằng forecast — không có forecast thì phân tích chỉ mang tính mô tả, không actionable.

| Kịch bản | Xác suất | Target | Return | Trigger cụ thể |
|-----------|----------|--------|--------|-----------------|
| Bull | 25-30% | [giá] | +X% | [điều kiện gì phải xảy ra] |
| Base | 45-55% | [giá] | +Y% | [kịch bản trung tâm] |
| Bear | 20-30% | [giá] | -Z% | [rủi ro nào hiện thực hóa] |

**Expected Return = Sum(probability x return)**. Ghi rõ con số này.

## Bước 5: Tạo React Dashboard — LIGHT THEME

### Quy tắc giao diện

- Nền: `bg-white` hoặc `bg-gray-50`
- Cards: `bg-white shadow-sm border border-gray-200 rounded-lg`
- Header: gradient nhẹ hoặc `bg-white border-b`
- Text: `text-gray-900` chính, `text-gray-600` phụ
- **Không dùng:** `bg-gray-900`, `bg-slate-800`, `bg-slate-900`, dark gradient

### Cấu trúc dashboard

**Header Section:**
- SVG donut gauge (score 0-100) bên trái
- Tên tài sản, giá hiện tại, % thay đổi, sector, exchange bên phải
- Grade badge (A/B/C/D/F) color-coded
- Price-in assessment badge: "CHƯA PRICE-IN" / "ĐÃ PRICE-IN PHẦN LỚN" / "OVERPRICED"

**Sub-scores Row:**
- 3-4 progress bars: Technical | Fundamental | Sentiment | Macro
- Mỗi bar có label + score + fill color theo mức

**Key Findings:**
- Cards color-coded với severity badges: CRITICAL (đỏ), HIGH (cam), MEDIUM (xanh dương), OK (xanh lá)
- CRITICAL findings lên đầu
- Mỗi finding: 1-2 câu viết chuyên gia, dùng số liệu, ghi rõ price-in status
- BAO GỒM CẢ FINDINGS TIÊU CỰC — nếu chỉ có tin tốt, chưa research đủ

**3 Kịch bản Forecast:**
- Visual: 3 cards ngang (Bull xanh, Base xanh dương, Bear đỏ)
- Mỗi card: xác suất %, target giá, return %, trigger condition
- Expected Return hiển thị lớn, bold

**Quick Actions:**
- Actionable với timeframe badges (ngắn hạn, trung hạn, dài hạn)
- Cụ thể: "Đặt alert 15,500 (support mạnh)", không chung chung

**Expandable Deep Analysis (useState toggle):**
- Phân tích kỹ thuật chi tiết
- Phân tích cơ bản chi tiết
- Contrarian / Bear case tổng hợp
- Bối cảnh vĩ mô

**Disclaimer** ở cuối

### Expert Voice

Viết như senior analyst brief cho institutional client:
- Đi thẳng vào kết luận, evidence sau
- Số liệu cụ thể, so sánh peer rõ ràng
- "Giá đang test hỗ trợ 16,500 — nếu break, target 14,800 (-12%). Tuy nhiên RSI 28 ở weekly cho thấy oversold, bounce probability cao nếu volume tăng."

### Tech Implementation
- Tailwind CSS, inline SVG cho gauges/progress bars
- useState cho expandable sections
- sendPrompt() cho nút tương tác
- Không cần external libraries

## References
- `references/market-analyst-guide.md` — Framework tư duy chuyên gia
- `references/indicator_guide.md` — Indicators và cách đọc
- `references/ichimoku_guide.md` — Ichimoku Cloud chi tiết
- `references/vwap_guide.md` — VWAP và bands
- `references/elliott_wave_guide.md` — Elliott Wave theory
- `references/candlestick_patterns.md` — Mô hình nến
- `references/fundamental_ratios.md` — Chỉ số tài chính
- `references/deep_research.md` — Multi-source research strategy
- `references/expert_persona.md` — Expert reasoning pattern
- `references/vn_market_guide.md` — Đặc thù thị trường VN
- `references/macro_calendar.md` — Sự kiện vĩ mô
- `references/crypto_glossary.md` — Crypto/DeFi terminology
- `references/upgrade_rules.md` — Quy tắc nâng cấp v5

---
## Nhắc lại: Script trước, WebSearch sau
Nếu bạn chưa chạy `python scripts/analyze_all.py`, DỪNG LẠI và chạy script ngay bây giờ.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ThanhDatNgo2003](https://github.com/ThanhDatNgo2003)
- **Source:** [ThanhDatNgo2003/claude-market-skills](https://github.com/ThanhDatNgo2003/claude-market-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.