Shinhan Securities Assistant

Current stats for one industry (Industries API).

Historical stats for an industry (Industries API). Required: industryCode, startDate, endDate (YYYY-MM-DD).

List all industries (Industries API, path /industries). Use for industry codes.

RRG data for an industry (Industries API). Required: industryCode, startDate, endDate (YYYY-MM-DD).

Biểu đồ **giá lịch sử** một mã (nến OHLC, khối lượng, MA20) — widget tương tác. **Gọi khi:** user xem biểu đồ / giá quá khứ / so sánh hiệu suất theo khoảng thời gian. **Bắt buộc:** `start_date`, `end_date` (**YYYY-MM-DD**).

Render **WIDGET bảng danh mục cổ phiếu** (UI table): Khối lượng, giá vốn vs giá thị trường, lợi nhuận từng mã. **QUY TẮC ROUTING (BẮT BUỘC tuân thủ — kiểm tra trước khi gọi):** - ✅ GỌI tool này **CHỈ KHI** trong phiên hội thoại hiện tại **CHƯA TỪNG** gọi `portfolio_get_stock_balance` thành công (tức widget bảng danh mục chưa được hiển thị). - ❌ KHÔNG gọi lại tool này nếu widget đã hiển thị trong phiên — mọi yêu cầu tiếp theo về danh mục (phân tích, số liệu, P/L, rủi ro, top, xếp hạng, theo kỳ…) → dùng `portfolio_get_stock_balance_statistics`. - ❌ KHÔNG gọi tool này khi user chỉ hỏi số liệu/phân tích/so sánh mà không yêu cầu xem bảng. - ⚠️ Ngoại lệ duy nhất được gọi lại: user **yêu cầu rõ ràng mở/hiển thị lại bảng danh mục** (ví dụ "mở lại bảng", "show lại danh mục dạng bảng", "refresh widget"). Tóm tắt: Tool này = **lần đầu hiển thị widget bảng**. Sau đó chuyển hẳn sang `portfolio_get_stock_balance_statistics`.

Phân tích danh mục **CHỈ JSON, KHÔNG render widget**: rủi ro (Beta vs benchmark_index, VaR, Sharpe, biến động), P/L mark-to-market, xếp hạng, theo kỳ. **QUY TẮC ROUTING (BẮT BUỘC tuân thủ — kiểm tra trước khi gọi):** - ✅ GỌI tool này **MẶC ĐỊNH** cho mọi câu hỏi về danh mục (phân tích, số liệu, P/L, rủi ro, top, xếp hạng, theo khoảng thời gian) **KHI** widget bảng `portfolio_get_stock_balance` **ĐÃ ĐƯỢC GỌI** trước đó trong phiên hội thoại. - ✅ GỌI tool này **NGAY CẢ KHI WIDGET CHƯA HIỂN THỊ** nếu user chỉ cần số liệu/phân tích (không yêu cầu xem bảng UI). - ❌ KHÔNG gọi tool này khi user yêu cầu **xem bảng danh mục lần đầu** trong phiên — khi đó dùng `portfolio_get_stock_balance` để render widget trước. Tóm tắt: Tool này = **mọi lần sau khi đã có widget**, hoặc khi nhu cầu thuần phân tích/số liệu (không cần UI bảng). **Lưu ý dữ liệu:** - Xếp hạng / top: dùng `rank_*` và `pro_los_val`; KHÔNG tự sắp `positions[]`. - Bắt buộc **start_date** và **end_date** (YYYY-MM-DD); nếu khoảng thời gian không rõ thì HỎI user trước khi gọi.

Tính **RSI, MACD, Bollinger, MA** từ giá lịch sử — có **widget**. **Khi gọi:** phân tích kỹ thuật một mã. **Tham số:** `period`, `macd_*`, **macd_fast** < **macd_slow**.

Dividend history for a symbol. Optional: count.

Financial data for a symbol by year and quarter. quarter: 1-4 for quarter, 0 for annual.

Chỉ số **tài chính** một mã cổ phiếu (P/E, ROE, EPS, ROA, vốn hóa, …). **Khi gọi:** định giá / phân tích cơ bản. **Không dùng:** giá realtime, khuyến nghị mua bán, danh mục.

**Hồ sơ doanh nghiệp** một mã: tên, ngành ICB, tổng quan, liên hệ, vốn điều lệ, … **Khi gọi:** user cần thông tin hồ sơ doanh nghiệp hoặc lấy các mã ngành ICB để tra cứu.

RRG (Relative Rotation Graph) data for a symbol. Required: startDate, endDate (YYYY-MM-DD).

**Tin / bài viết cộng đồng** gắn một mã (`post_type`: tin vs social, `limit`). **Khi gọi:** user cần lấy tin tức liên quan đến mã CK.

Top **tăng / giảm / thanh khoản** (Gainers, Losers, Actives), lọc sàn (HSX, HNX, UPCOM), giới hạn `count`. **Khi gọi:** user muốn lấy diễn biến chung, dòng tiền thị trường.

Institutional transactions (buy/sell) for a symbol. Optional: startDate, endDate, offset, limit.

TOP stocks by proprietary trading net value. Params: exchange, type (Deal/Putthrough/Total), topType (Buy/Sell/BuySell), count.

Search symbols by keywords. Optional: exchange (HSX, HNX, UPCOM), type (stock, futures, warrant, index, fund, bond), offset, limit.

TOP symbols contributing to index. Params: exchange, type (1: push up, 2: push down), count.