# 4. Lưu ý khi dùng

## Đơn vị & thời gian

- Giá cổ phiếu, ETF, chứng quyền: **VND**; chỉ số và phái sinh: **điểm**. Nến ngày là giá **đã điều chỉnh** (cổ tức, chia tách); nến phút là giá **thô**.
- BCTC: **tỷ VND**; EPS: đồng/cổ phiếu. Khoá có hậu tố `_pct` là phần trăm.
- Thời gian theo giờ Việt Nam (UTC+7); `meta.as_of` cho biết số liệu tính đến lúc nào.
- Trong phiên, khối ngoại và khối lượng là số **chưa chốt**; số chốt có từ ~08:00 sáng hôm sau.

## Đọc kết quả

- Mọi công cụ trả `{status, data, meta}`; lỗi có `error.code` và `error.hint` — AI nên làm theo gợi ý.
- Còn trang tiếp → `meta.next_cursor`; bị kẹp tham số → `meta.clamped`; quá 200 KB → `meta.truncated`.

## Mẹo dùng hiệu quả

- Hỏi thẳng bằng tiếng Việt; AI tự chọn công cụ. Câu phổ biến chỉ cần 1–2 lượt gọi.
- Không chắc tên mã/chỉ tiêu: "tìm chỉ tiêu lãi suất liên ngân hàng" → `search` → `call_function`.
- Dữ liệu độc quyền: "AlgolabX dự báo VN-Index thế nào?" → `get_intelligence`.

## Lệnh "/" dựng sẵn

Claude Code: `/mcp__algolab__<tên>` · Claude Desktop/claude.ai: menu "+" → Algolab.

| Lệnh | Nội dung |
|---|---|
| `/algolab` | Hub: tổng quan thị trường + hạn mức, hoặc hỏi tự do. |
| `/stock` | Snapshot nhanh một mã: giá, 30 phiên, tín hiệu kỹ thuật. |
| `/analysis` | Phân tích toàn diện một mã: hồ sơ, định giá, BCTC, kỹ thuật, khuyến nghị CTCK, tin tức. |
| `/market` | Tổng quan toàn diện thị trường: chỉ số, độ rộng, khối ngoại, phái sinh, tin, dự báo, vĩ mô. |
| `/ideas` | Tìm cơ hội đầu tư: sàng lọc 3 giai đoạn bằng tín hiệu, khuyến nghị và cơ bản. |
| `/forecast` | ★ Dự báo VN-Index các tháng tới của AlgolabX. |
| `/macro` | Vĩ mô Việt Nam + thế giới, đào sâu mọi chỉ tiêu. |
| `/news` | Tin tức kèm sentiment; trống = tin nóng toàn thị trường. |
| `/portfolio` | Soi danh mục nhiều mã so với VN-Index. |
| `/report` | Báo cáo phân tích CTCK: danh sách, đồng thuận, đọc toàn văn. |
| `/warrants` | Chứng quyền: giá, giá thực hiện, đáo hạn, ITM/OTM. |
| `/derivatives` | Phái sinh VN30F: basis, OI, dòng lệnh, lịch sử, tín hiệu 4 mô hình. |

## Prompt mẫu cho Project (Claude / ChatGPT)

```
Bạn là trợ lý phân tích chứng khoán Việt Nam. Luôn lấy số liệu từ công cụ Algolab MCP, ghi rõ mốc thời gian
và nguồn. Hỏi về thị trường → get_market_overview; về một mã → get_company_profile. Dữ liệu ngoài 10 công cụ
chính → search rồi call_function. Không đưa khuyến nghị mua/bán cá nhân hoá.
```

## Miễn trừ

Thông tin tham khảo, không phải khuyến nghị đầu tư. Dự báo và tín hiệu AlgolabX là sản phẩm định lượng, không bảo đảm kết quả tương lai.