# Market Data (VN Stock Market Analytics)

> Dữ liệu phân tích cổ phiếu Việt Nam: báo cáo tài chính, chỉ báo kỹ thuật, định giá, sức khỏe tài chính, dự đoán ngắn hạn cho ~3.100 cổ phiếu trên HOSE/HNX/UPCOM.

- Base URL: `https://dn.aizia.info`
- MCP server: `https://dn.aizia.info/api/mcp` (Model Context Protocol, Streamable HTTP, POST)
- Ngôn ngữ dữ liệu: Tiếng Việt. Đơn vị tiền tệ: VND (trừ khi ghi rõ).

## MCP Tools (AI agents dùng truy vấn trực tiếp)

Các tool MCP được ưu tiên hơn việc crawl HTML. Gửi POST `initialize` rồi `tools/call` tới `/api/mcp`.

- `search_companies(query, limit)` — tìm công ty theo mã/tên
- `get_company(symbol)` — hồ sơ công ty
- `get_company_snapshot(symbol)` — snapshot đầy đủ (hồ sơ + tài chính + dòng tiền)
- `get_financials_history(symbol, years)` — lịch sử báo cáo tài chính năm
- `get_technical_indicators(symbol, limit, offset)` — RSI, MACD, BB, SMA, ROC, ATR...
- `get_price_history(symbol, limit, offset)` — giá OHLCV hàng ngày
- `get_valuation(symbol)` — định giá (P/E, P/B, EV/EBITDA, DCF, Sum of Parts)
- `get_health(symbol)` — sức khỏe tài chính + vấn đề
- `get_prediction(symbol)` — composite score, BUY/SELL/HOLD
- `get_dividends(symbol)` — lịch sử cổ tức
- `get_shareholders(symbol)` — cổ đông lớn
- `get_industry_comparison(symbol)` — so sánh trung bình ngành
- `get_picks(type)` — gợi ý cổ phiếu (quality/growth/dividend)

Mã cổ phiếu dùng để truy vấn (vd: `ANT`, `VNM`). Mỗi công ty có trang web: `https://dn.aizia.info/c/{SYMBOL}-{ten-cong-ty}`.

## Các trang chính

- `https://dn.aizia.info/` — bảng xếp hạng & thị trường
- `https://dn.aizia.info/tin-hieu-thi-truong` — tín hiệu thị trường (breadth, sector rotation)
- `https://dn.aizia.info/co-tuc` — gợi ý cổ tức cao
- `https://dn.aizia.info/tang-truong-hap-dan` — gợi ý tăng trưởng
- `https://dn.aizia.info/chat-luong-cao` — gợi ý chất lượng
- `https://dn.aizia.info/dinh-gia-hap-dan` — gợi ý định giá hấp dẫn
- `https://dn.aizia.info/backtest` — kết quả backtest thuật toán
- `https://dn.aizia.info/so-sanh` — so sánh cổ phiếu
- `https://dn.aizia.info/co-dong` — thông tin cổ đông

## Lưu ý

- Dữ liệu tài chính là năm tài chính của công ty, đơn vị VND.
- `get_prediction` dựa trên mean-reversion regime hiện tại, chỉ là tham khảo, không phải lời khuyên đầu tư.
- Nếu muốn toàn bộ danh sách mã: `search_companies(query="")` bị giới hạn; thay vào đó crawl sitemap `https://dn.aizia.info/sitemap-main.xml`.