fin68 0.1.3__cp312-cp312-macosx_10_13_universal2.whl

fin68/clients/eod/SectorEod.py

@@ -0,0 +1,146 @@
+from __future__ import annotations
+
+"""
+fin68.clients.eod.sector
+========================
+
+Cung cấp lớp `SectorEod` — các endpoint EOD (End-of-Day) cho dữ liệu ngành (ICB Sector Aggregates).
+
+Dữ liệu thể hiện hiệu suất, biến động, và khối lượng giao dịch trung bình của từng ngành
+(ICB Code) hoặc nhóm ngành (Sub-sector). Phù hợp cho phân tích xoay vòng ngành (sector rotation)
+và đánh giá xu hướng thị trường theo nhóm.
+
+Notes
+-----
+- Dữ liệu được lấy qua `private_core.eod_core.fetch_ohlcv()`.
+- Tất cả kết quả trả về dạng `pandas.DataFrame`.
+- Cho phép truy vấn nhiều mã ngành cùng lúc.
+"""
+
+from typing import TYPE_CHECKING, Sequence, Union
+from private_core import eod_core
+from ..base import BaseClient
+from .helper import DateStr, Interval, _EodMixin
+from .icb_types import SectorArg,icbMap
+if TYPE_CHECKING:
+    from pandas import DataFrame
+    from private_core.http_core import HttpSession
+
+
+
+
+class SectorEod(BaseClient, _EodMixin):
+    """
+    Cung cấp các endpoint EOD cho nhóm ngành (ICB Sector/Industry).
+
+    Lớp này giúp truy vấn dữ liệu tổng hợp cho từng ngành (ICB Code) theo ngày, tuần, tháng, v.v.
+
+    Parameters
+    ----------
+    session : HttpSession
+        Phiên HTTP đã xác thực, được truyền từ `EodClient`.
+
+    Notes
+    -----
+    - Cho phép lấy dữ liệu nhiều mã ngành cùng lúc (list[str]).
+    - Hỗ trợ chuẩn hóa khoảng thời gian và kiểm tra `interval`.
+    - Trả về OHLCV (Open, High, Low, Close, Volume) trung bình của từng ngành.
+    - Các mã ngành tuân theo chuẩn phân loại ICB (ví dụ: `ICB01010`, `ICB03020`...).
+    """
+
+    def __init__(self, session: "HttpSession") -> None:
+        """
+        Khởi tạo `SectorEod` với session HTTP đã xác thực.
+
+        Parameters
+        ----------
+        session : HttpSession
+            Phiên HTTP dùng chung từ `EodClient`.
+        """
+        super().__init__(session=session)
+
+    def ohlcv(
+        self,
+        symbol: SectorArg,
+        start: DateStr = None,
+        end: DateStr = None,
+        interval: Interval = "1D",
+    ) -> "DataFrame":
+        """
+        Lấy dữ liệu OHLCV (Open, High, Low, Close, Volume) cho một hoặc nhiều ngành ICB.
+
+        Parameters
+        ----------
+        symbol : str or Sequence[str]
+            Mã ngành hoặc danh sách mã ngành (ví dụ: `"ICB01010"`, `["ICB01010", "ICB03020"]`).
+        start : str, optional
+            Ngày bắt đầu, định dạng `"YYYY-MM-DD"`.  
+            Nếu không truyền, hệ thống sẽ chọn mặc định (thường là 1 năm gần nhất).
+        end : str, optional
+            Ngày kết thúc, định dạng `"YYYY-MM-DD"`.  
+            Nếu không truyền, mặc định là ngày hiện tại.
+        interval : {"1D", "1W", "1M", "3M", "6M", "1Y"}, default "1D"
+            Khoảng thời gian dữ liệu:
+            - `"1D"`: theo ngày  
+            - `"1W"`: theo tuần  
+            - `"1M"`: theo tháng  
+            - `"3M"`, `"6M"`, `"1Y"`: theo quý, nửa năm hoặc năm
+
+        Returns
+        -------
+        DataFrame
+            Bảng dữ liệu OHLCV cho từng mã ngành, gồm:
+            - `icbCode`: mã ngành  
+            - `Date`: ngày giao dịch  
+            - `Open`, `High`, `Low`, `Close`, `Volume`  
+            - Có thể có thêm `MarketCap`, `TurnoverRatio` nếu backend hỗ trợ.
+
+        Raises
+        ------
+        ValueError
+            Nếu ngày bắt đầu > ngày kết thúc hoặc `interval` không hợp lệ.
+        ApiRequestError
+            Nếu backend trả lỗi khi gọi API.
+
+        Examples
+        --------
+        >>> from fin68 import client
+        >>> cli = client(api_key="sk_live_...")
+        >>> df = cli.eod.sector.ohlcv("ICB01010", start="2024-01-01", end="2024-06-30")
+        >>> df.head()
+            icbCode        Date     Open     High      Low    Close   Volume
+        0   ICB01010  2024-01-02  1320.25  1334.11  1305.21  1310.55  9.32e6
+
+        >>> # Lấy đồng thời nhiều ngành
+        >>> cli.eod.sector.ohlcv(["ICB01010", "ICB03020"])
+
+        Notes
+        -----
+        - Phù hợp để phân tích hiệu suất ngành theo thời gian.
+        - Dữ liệu thường được tổng hợp từ trung bình trọng số theo vốn hóa.
+        - Wrapper của `private_core.eod_core.fetch_ohlcv`.
+        """
+        icb_codes=[]
+        if isinstance(symbol, list):
+            for sec in symbol:
+                if sec.lower() not in icbMap:
+                    raise ValueError(f"Không tìm thấy mã ngành cho tên '{sec}'")
+                icb_codes.append(icbMap.get(sec.lower()))
+        else:
+            if symbol.lower() not in icbMap:
+                raise ValueError(f"Không tìm thấy mã ngành cho tên '{symbol}'")
+            icb_codes.append(icbMap.get(symbol.lower()))
+
+
+        if not symbol:
+            raise ValueError(f"Không tìm thấy mã ngành cho tên '{symbol}'")
+        start_date, end_date = self._normalize_range(start, end)
+        interval_value = self._validate_interval(interval)
+        payload = eod_core.fetch_ohlcv(
+            self.session,
+            icb_codes,
+            start=start_date,
+            end=end_date,
+            interval=interval_value,
+        )
+        return self._to_dataframe(payload)

fin68/clients/eod/SectorEod.pyi

@@ -0,0 +1,86 @@
+from __future__ import annotations
+
+"""
+fin68.clients.eod.sector (stub)
+==============================
+
+Type stub cho lớp `SectorEod` — phục vụ autocomplete/typing trong IDE và
+static type checker. Không thực thi logic, chỉ khai báo kiểu & docstring ngắn.
+"""
+
+from typing import TYPE_CHECKING, Sequence, Union
+from ..base import BaseClient
+from .helper import DateStr, Interval,IcbName, _EodMixin
+from .icb_types import SectorArg
+if TYPE_CHECKING:
+    from pandas import DataFrame
+    from private_core.http_core import HttpSession
+
+
+
+class SectorEod(BaseClient, _EodMixin):
+    """
+    Endpoint EOD cho dữ liệu ngành (ICB Sector Aggregates).
+
+    Parameters
+    ----------
+    session : HttpSession
+        Phiên HTTP đã xác thực, truyền từ `EodClient`.
+
+    Notes
+    -----
+    - Hỗ trợ nhiều mã ngành cùng lúc (list[str]).
+    - Chuẩn hóa khoảng thời gian, validate `interval`.
+    - Trả về OHLCV trung bình/tổng hợp cho từng ngành.
+    """
+
+    def __init__(self, session: "HttpSession") -> None: ...
+    """
+    Khởi tạo `SectorEod` với session HTTP đã xác thực.
+
+    Parameters
+    ----------
+    session : HttpSession
+        Phiên HTTP dùng chung từ `EodClient`.
+    """
+
+    def ohlcv(
+        self,
+        symbol: SectorArg,
+        start: DateStr = None,
+        end: DateStr = None,
+        interval: Interval = "1D",
+    ) -> "DataFrame": ...
+    """
+    Lấy dữ liệu OHLCV (Open, High, Low, Close, Volume) cho một hoặc nhiều ngành ICB.
+
+    Parameters
+    ----------
+    symbol : str or Sequence[str]
+        Mã ngành hoặc danh sách mã ngành (VD: "ICB01010", ["ICB01010", "ICB03020"]).
+    start : str, optional
+        Ngày bắt đầu "YYYY-MM-DD". Nếu None, dùng mặc định hệ thống.
+    end : str, optional
+        Ngày kết thúc "YYYY-MM-DD". Nếu None, mặc định là hôm nay.
+    interval : {"1D", "1W", "1M", "3M", "6M", "1Y"}, default "1D"
+        Khoảng thời gian lấy dữ liệu.
+
+    Returns
+    -------
+    DataFrame
+        Gồm các cột cơ bản: `icbCode`, `Date`, `Open`, `High`, `Low`, `Close`, `Volume`.
+
+    Raises
+    ------
+    ValueError
+        Nếu `start > end` hoặc `interval` không hợp lệ.
+    ApiRequestError
+        Nếu backend trả lỗi khi gọi API.
+
+    Examples
+    --------
+    >>> from fin68 import client
+    >>> cli = client(api_key="sk_live_...")
+    >>> cli.eod.sector.ohlcv("ICB01010", start="2024-01-01", end="2024-06-30")
+    >>> cli.eod.sector.ohlcv(["ICB01010", "ICB03020"])
+    """

fin68/clients/eod/StockEod.py

@@ -0,0 +1,134 @@
+from __future__ import annotations
+
+"""
+fin68.clients.eod.stock
+=======================
+
+Cung cấp lớp `StockEod` — tập trung các endpoint EOD dành cho từng mã cổ phiếu riêng lẻ.  
+Bao gồm dữ liệu OHLCV (Open, High, Low, Close, Volume), điều chỉnh giá (adjusted) và
+hỗ trợ các khoảng thời gian khác nhau (ngày, tuần, tháng...).
+
+Notes
+-----
+- Dữ liệu lấy từ `private_core.eod_core.fetch_ohlcv()`.
+- Tất cả kết quả được trả về dưới dạng `pandas.DataFrame`.
+- Tự động kiểm tra và chuẩn hóa ngày bắt đầu/kết thúc, validate interval.
+"""
+
+from typing import TYPE_CHECKING, Sequence, Union
+
+from private_core import eod_core
+from ..base import BaseClient
+from .helper import DateStr, Interval, _EodMixin
+
+if TYPE_CHECKING:
+    from pandas import DataFrame
+    from private_core.http_core import HttpSession
+
+SymbolArg = Union[str, Sequence[str]]
+
+
+class StockEod(BaseClient, _EodMixin):
+    """
+    Cung cấp các endpoint EOD cho từng mã cổ phiếu (equity symbol).
+
+    Lớp này cho phép truy vấn dữ liệu giá, khối lượng và chỉ báo kỹ thuật
+    ở cấp mã cổ phiếu, tương tự như chức năng `get_price_data()` trong các
+    hệ thống tài chính chuyên nghiệp.
+
+    Parameters
+    ----------
+    session : HttpSession
+        Phiên HTTP đã xác thực, được truyền từ `EodClient`.
+
+    Notes
+    -----
+    - Toàn bộ phương thức đều hỗ trợ truy vấn nhiều mã cùng lúc (`list[str]`).
+    - Có thể chọn chế độ `adjusted=True` để lấy dữ liệu điều chỉnh cổ tức/chia tách.
+    - Hàm `_EodMixin` cung cấp các helper cho việc chuẩn hóa khoảng thời gian
+      (`_normalize_range`) và kiểm tra tính hợp lệ của `interval`.
+    """
+
+    def __init__(self, session: "HttpSession") -> None:
+        """
+        Khởi tạo lớp `StockEod` với session HTTP đã được xác thực.
+
+        Parameters
+        ----------
+        session : HttpSession
+            Phiên HTTP dùng chung từ `EodClient`.
+        """
+        super().__init__(session=session)
+
+    def ohlcv(
+        self,
+        symbol: SymbolArg,
+        start: DateStr = None,
+        end: DateStr = None,
+        adjusted: bool = True,
+        interval: Interval = "1D",
+    ) -> "DataFrame":
+        """
+        Lấy dữ liệu OHLCV (Open, High, Low, Close, Volume) cho một hoặc nhiều mã cổ phiếu.
+
+        Parameters
+        ----------
+        symbol : str or Sequence[str]
+            Mã cổ phiếu hoặc danh sách mã cổ phiếu cần lấy dữ liệu (VD: `"HPG"`, `["HPG", "VCB"]`).
+        start : str, optional
+            Ngày bắt đầu, định dạng `"YYYY-MM-DD"`.  
+            Nếu không truyền, hệ thống sẽ tự động lấy ngược về theo khoảng mặc định.
+        end : str, optional
+            Ngày kết thúc, định dạng `"YYYY-MM-DD"`.  
+            Nếu không truyền, mặc định là ngày hiện tại.
+        adjusted : bool, default True
+            Nếu `True`, trả về giá đã điều chỉnh theo cổ tức và chia tách cổ phiếu.
+        interval : {"1D", "1W", "1M", "3M", "6M", "1Y"}, default "1D"
+            Khoảng thời gian dữ liệu cần lấy:
+            - `"1D"`: theo ngày  
+            - `"1W"`: theo tuần  
+            - `"1M"`: theo tháng  
+            - `"3M"`, `"6M"`, `"1Y"`: theo quý, nửa năm, hoặc năm
+
+        Returns
+        -------
+        DataFrame
+            Bảng dữ liệu gồm các cột:
+            - `symbol`: mã cổ phiếu  
+            - `Date`: ngày giao dịch  
+            - `Open`, `High`, `Low`, `Close`, `Volume`  
+            - Các cột bổ sung nếu backend cung cấp (ví dụ: `Adj Close`)
+
+        Raises
+        ------
+        ValueError
+            Khi tham số `start` > `end`, hoặc `interval` không hợp lệ.
+        ApiRequestError
+            Khi backend trả lỗi trong quá trình gọi API.
+
+        Examples
+        --------
+        >>> from fin68 import client
+        >>> cli = client(api_key="sk_live_...")
+        >>> df = cli.eod.stock.ohlcv("HPG", start="2024-01-01", end="2024-06-30")
+        >>> df.head()
+             symbol        Date    Open    High     Low   Close    Volume
+        0      HPG  2024-01-02  27200  27500  26900  27400  15300000
+
+        Notes
+        -----
+        - Tự động validate khoảng thời gian (`start <= end`).
+        - Có thể truy vấn nhiều mã cùng lúc để so sánh hiệu suất.
+        - Hàm này là wrapper của `private_core.eod_core.fetch_ohlcv`.
+        """
+        start_date, end_date = self._normalize_range(start, end)
+        interval_value = self._validate_interval(interval)
+        payload = eod_core.fetch_ohlcv(
+            self.session,
+            symbol,
+            start=start_date,
+            end=end_date,
+            adjusted=adjusted,
+            interval=interval_value,
+        )
+        return self._to_dataframe(payload)

fin68/clients/eod/StockEod.pyi

@@ -0,0 +1,92 @@
+from __future__ import annotations
+
+"""
+fin68.clients.eod.stock (stub)
+==============================
+
+Type stub cho lớp `StockEod` — phục vụ autocomplete/typing trong IDE (VSCode/PyCharm)
+và static type checker (mypy/pyright). Không thực thi logic.
+
+Ghi chú
+-------
+- Docstring giữ chuẩn NumPy style như bản .py.
+- Các thân hàm được thay bằng `...` (ellipsis) theo PEP 484.
+"""
+
+from typing import TYPE_CHECKING, Sequence, Union
+from ..base import BaseClient
+from .helper import DateStr, Interval, _EodMixin
+
+if TYPE_CHECKING:
+    from pandas import DataFrame
+    from private_core.http_core import HttpSession
+
+SymbolArg = Union[str, Sequence[str]]
+
+class StockEod(BaseClient, _EodMixin):
+    """
+    Cung cấp các endpoint EOD cho từng mã cổ phiếu (equity symbol).
+
+    Parameters
+    ----------
+    session : HttpSession
+        Phiên HTTP đã xác thực, được truyền từ `EodClient`.
+
+    Notes
+    -----
+    - Hỗ trợ truy vấn nhiều mã cùng lúc (`list[str]`).
+    - Có `adjusted=True` để lấy giá đã điều chỉnh cổ tức/chia tách.
+    - Kế thừa `_EodMixin` để chuẩn hóa khoảng thời gian và validate interval.
+    """
+
+    def __init__(self, session: "HttpSession") -> None: ...
+    """
+    Khởi tạo `StockEod` với session đã xác thực.
+
+    Parameters
+    ----------
+    session : HttpSession
+        Phiên HTTP dùng chung từ `EodClient`.
+    """
+
+    def ohlcv(
+        self,
+        symbol: SymbolArg,
+        start: DateStr = None,
+        end: DateStr = None,
+        interval: Interval = "1D",
+    ) -> "DataFrame": ...
+    """
+    Lấy dữ liệu OHLCV (Open, High, Low, Close, Volume) cho một hoặc nhiều mã cổ phiếu.
+
+    Parameters
+    ----------
+    symbol : str or Sequence[str]
+        Mã cổ phiếu hoặc danh sách mã (VD: "HPG", ["HPG", "VCB"]).
+    start : str, optional
+        Ngày bắt đầu, định dạng "YYYY-MM-DD". Nếu `None`, dùng mặc định hệ thống.
+    end : str, optional
+        Ngày kết thúc, định dạng "YYYY-MM-DD". Nếu `None`, mặc định là hôm nay.
+    interval : {"1D", "1W", "1M", "3M", "6M", "1Y"}, default "1D"
+        Khoảng thời gian lấy dữ liệu.
+
+    Returns
+    -------
+    DataFrame
+        Gồm các cột cơ bản: `symbol`, `Date`, `Open`, `High`, `Low`, `Close`, `Volume`.
+
+
+    Raises
+    ------
+    ValueError
+        Nếu `start > end` hoặc `interval` không hợp lệ.
+    ApiRequestError
+        Nếu backend trả lỗi khi gọi API.
+
+    Examples
+    --------
+    >>> from fin68 import client
+    >>> cli = client(api_key="sk_live_...")
+    >>> df = cli.eod.stock.ohlcv("HPG", start="2024-01-01", end="2024-06-30")
+    >>> df.head()
+    """

fin68/clients/eod/__init__.py

@@ -0,0 +1,6 @@
+from .helper import DateStr, Interval
+from .MarketEod import MarketEod
+from .SectorEod import SectorEod
+from .StockEod import StockEod
+
+__all__ = ["DateStr", "Interval", "StockEod", "MarketEod", "SectorEod"]

fin68/clients/eod/helper.py

@@ -0,0 +1,65 @@
+from __future__ import annotations
+
+from datetime import date, datetime, timedelta
+from typing import ClassVar, Iterable, Literal, Optional, TypeAlias,Union,Sequence
+
+import pandas as pd
+
+from ...utils import _validate_date_eod
+
+DateStr: TypeAlias = Optional[str]
+Interval = Literal["1D", "1W", "1M", "3M", "6M", "1Y"]
+
+
+
+class _EodMixin:
+    """Common helpers shared across EOD namespaces."""
+
+    _DEFAULT_LOOKBACK_DAYS: ClassVar[int] = 30
+    _ALLOWED_INTERVALS: ClassVar[set[str]] = {"1D", "1W", "1M", "3M", "6M", "1Y"}
+
+    def _normalize_range(self, start: DateStr, end: DateStr) -> tuple[str, str]:
+        """Return a validated (start, end) date pair in ISO format."""
+        today = date.today()
+
+        if end is None:
+            end_date = today
+        else:
+            _validate_date_eod(end, "end")
+            end_date = datetime.strptime(end, "%Y-%m-%d").date()
+
+        if start is None:
+            start_date = end_date - timedelta(days=self._DEFAULT_LOOKBACK_DAYS)
+        else:
+            _validate_date_eod(start, "start")
+            start_date = datetime.strptime(start, "%Y-%m-%d").date()
+
+        if start_date > end_date:
+            raise ValueError(
+                f"start date ({start_date:%Y-%m-%d}) cannot be after end date ({end_date:%Y-%m-%d})."
+            )
+
+        return start_date.strftime("%Y-%m-%d"), end_date.strftime("%Y-%m-%d")
+
+    def _validate_interval(self, interval: Interval) -> Interval:
+        """Ensure the provided interval value is supported by the backend."""
+        if interval not in self._ALLOWED_INTERVALS:
+            allowed = ", ".join(sorted(self._ALLOWED_INTERVALS))
+            raise ValueError(f"interval must be one of {{{allowed}}}, received {interval!r}.")
+        return interval
+
+    @staticmethod
+    def _to_dataframe(rows: Iterable[dict]) -> pd.DataFrame:
+        """Materialise raw rows into a sorted pandas.DataFrame."""
+        frame = pd.DataFrame(rows)
+        if frame.empty:
+            return frame
+
+        if "date" in frame.columns:
+            frame["date"] = pd.to_datetime(frame["date"], errors="coerce")
+
+        sort_cols = [column for column in ("symbol", "date") if column in frame.columns]
+        if sort_cols:
+            frame = frame.sort_values(sort_cols).reset_index(drop=True)
+
+        return frame

fin68/clients/eod/icb_types.py

@@ -0,0 +1,111 @@
+from typing import ClassVar, Iterable, Literal, Optional, TypeAlias,Union,Sequence
+icbMap={'xây dựng': '2357',
+ 'vật liệu xây dựng & nội thất': '2353',
+ 'đường sắt': '2775',
+ 'kho bãi, hậu cần và bảo dưỡng': '2777',
+ 'dịch vụ vận tải': '2779',
+ 'tư vấn & hỗ trợ kd': '2791',
+ 'đào tạo & việc làm': '2793',
+ 'công nghiệp hàng không': '2713',
+ 'quốc phòng': '2717',
+ 'containers & đóng gói': '2723',
+ 'công nghiệp phức hợp': '2727',
+ 'hàng điện & điện tử': '2733',
+ 'thiết bị điện': '2737',
+ 'xe tải & đóng tàu': '2753',
+ 'máy công nghiệp': '2757',
+ 'chuyển phát nhanh': '2771',
+ 'vận tải thủy': '2773',
+ 'nhựa, cao su & sợi': '1353',
+ 'sản phẩm hóa dầu, nông dược & hóa chất khác': '1357',
+ 'lâm sản và chế biến gỗ': '1733',
+ 'sản xuất giấy': '1737',
+ 'nhôm': '1753',
+ 'kim loại màu': '1755',
+ 'thép và sản phẩm thép': '1757',
+ 'khai thác than': '1771',
+ 'đá quý và kim cương': '1773',
+ 'khai khoáng': '1775',
+ 'khai thác vàng': '1777',
+ 'bạch kim & kim loại quý khác': '1779',
+ 'quản lý tài chính': '2795',
+ 'chất thải & môi trường': '2799',
+ 'sản xuất ô tô': '3353',
+ 'phụ tùng ô tô': '3355',
+ 'lốp xe': '3357',
+ 'sản xuất và khai thác dầu khí': '0533',
+ 'tổ hợp dầu khí': '0537',
+ 'thiết bị và dịch vụ dầu khí': '0573',
+ 'ống dẫn dầu': '0577',
+ 'thiết bị năng lượng tái chế': '0583',
+ 'nhiên liệu thay thế': '0587',
+ 'nhà cung cấp thiết bị': '2797',
+ 'sản xuất bia': '3533',
+ 'vang & rượu mạnh': '3535',
+ 'đồ uống & giải khát': '3537',
+ 'nuôi trồng nông & hải sản': '3573',
+ 'thực phẩm': '3577',
+ 'đồ gia dụng lâu bền': '3722',
+ 'đồ gia dụng một lần': '3724',
+ 'thiết bị gia dụng': '3726',
+ 'xây nhà': '3728',
+ 'điện tử tiêu dùng': '3743',
+ 'sản phẩm nghệ thuật': '3745',
+ 'đồ chơi': '3747',
+ 'hàng may mặc': '3763',
+ 'giầy dép': '3765',
+ 'hàng cá nhân': '3767',
+ 'thuốc lá': '3785',
+ 'chăm sóc y tế': '4533',
+ 'thiết bị y tế': '4535',
+ 'dụng cụ y tế': '4537',
+ 'công nghệ sinh học': '4573',
+ 'dược phẩm': '4577',
+ 'phân phối dược phẩm': '5333',
+ 'phân phối thực phẩm': '5337',
+ 'giải trí & truyền thông': '5553',
+ 'dịch vụ truyền thông': '5555',
+ 'sách, ấn bản & sản phẩm văn hóa': '5557',
+ 'nhà hàng và quán bar': '5757',
+ 'vận tải hành khách & du lịch': '5759',
+ 'viễn thông cố định': '6535',
+ 'môi giới bảo hiểm': '8534',
+ 'bảo hiểm phi nhân thọ': '8536',
+ 'tái bảo hiểm': '8538',
+ 'bảo hiểm nhân thọ': '8575',
+ 'bán lẻ hàng may mặc': '5371',
+ 'bán lẻ phức hợp': '5373',
+ 'phân phối nội thất': '5375',
+ 'dịch vụ tiêu dùng chuyên ngành': '5377',
+ 'phân phối hàng chuyên dụng': '5379',
+ 'dịch vụ hàng không': '5751',
+ 'gambling': '5752',
+ 'khách sạn': '5753',
+ 'dịch vụ giải trí': '5755',
+ 'viễn thông di động': '6575',
+ 'ngân hàng': '8355',
+ 'bảo hiểm phức hợp': '8532',
+ 'sản xuất & phân phối điện': '7535',
+ 'phân phối xăng dầu & khí đốt': '7573',
+ 'tiện ích khác': '7575',
+ 'nước': '7577',
+ 'bất động sản': '8633',
+ 'phần mềm': '9537',
+ 'phần cứng': '9572',
+ 'thiết bị văn phòng': '9574',
+ 'bán dẫn': '9576',
+ 'thiết bị viễn thông': '9578',
+ 'tư vấn, định giá, môi giới bất động sản': '8637',
+ 'quỹ ủy thác bđs': '8677',
+ 'quản lý tài sản': '8771',
+ 'tài chính cá nhân': '8773',
+ 'tài chính đặc biệt': '8775',
+ 'môi giới chứng khoán': '8777',
+ 'cầm cố': '8779',
+ 'quỹ đầu tư': '8985',
+ 'dịch vụ máy tính': '9533',
+ 'internet': '9535'}
+SectorArg = Union[
+    Literal['Xây dựng', 'Vật liệu xây dựng & Nội thất', 'Đường sắt', 'Kho bãi, hậu cần và bảo dưỡng', 'Dịch vụ vận tải', 'Tư vấn & Hỗ trợ KD', 'Đào tạo & Việc làm', 'Công nghiệp hàng không', 'Quốc phòng', 'Containers & Đóng gói', 'Công nghiệp phức hợp', 'Hàng điện & điện tử', 'Thiết bị điện', 'Xe tải & Đóng tàu', 'Máy công nghiệp', 'Chuyển phát nhanh', 'Vận tải Thủy', 'Nhựa, cao su & sợi', 'Sản phẩm hóa dầu, Nông dược & Hóa chất khác', 'Lâm sản và Chế biến gỗ', 'Sản xuất giấy', 'Nhôm', 'Kim Loại màu', 'Thép và sản phẩm thép', 'Khai thác Than', 'Đá quý và Kim cương', 'Khai khoáng', 'Khai thác vàng', 'Bạch kim & Kim loại quý khác', 'Quản lý Tài chính', 'Chất thải & Môi trường', 'Sản xuất ô tô', 'Phụ tùng ô tô', 'Lốp xe', 'Sản xuất và Khai thác dầu khí', 'Tổ hợp Dầu khí', 'Thiết bị và Dịch vụ Dầu khí', 'Ống dẫn Dầu', 'Thiết bị năng lượng tái chế', 'Nhiên liệu thay thế', 'Nhà cung cấp thiết bị', 'Sản xuất bia', 'Vang & Rượu mạnh', 'Đồ uống & giải khát', 'Nuôi trồng nông & hải sản', 'Thực phẩm', 'Đồ gia dụng lâu bền', 'Đồ gia dụng một lần', 'Thiết bị gia dụng', 'Xây nhà', 'Điện tử tiêu dùng', 'Sản phẩm nghệ thuật', 'Đồ chơi', 'Hàng May mặc', 'Giầy dép', 'Hàng cá nhân', 'Thuốc lá', 'Chăm sóc y tế', 'Thiết bị y tế', 'Dụng cụ y tế', 'Công nghệ sinh học', 'Dược phẩm', 'Phân phối dược phẩm', 'Phân phối thực phẩm', 'Giải trí & Truyền thông', 'Dịch vụ truyền thông', 'Sách, ấn bản & sản phẩm văn hóa', 'Nhà hàng và quán bar', 'Vận tải hành khách & Du lịch', 'Viễn thông cố định', 'Môi giới bảo hiểm', 'Bảo hiểm phi nhân thọ', 'Tái bảo hiểm', 'Bảo hiểm nhân thọ', 'Bán lẻ hàng may mặc', 'Bán lẻ phức hợp', 'Phân phối nội thất', 'Dịch vụ tiêu dùng chuyên ngành', 'Phân phối hàng chuyên dụng', 'Dịch vụ hàng không', 'Gambling', 'Khách sạn', 'Dịch vụ giải trí', 'Viễn thông di động', 'Ngân hàng', 'Bảo hiểm phức hợp', 'Sản xuất & Phân phối Điện', 'Phân phối xăng dầu & khí đốt', 'Tiện ích khác', 'Nước', 'Bất động sản', 'Phần mềm', 'Phần cứng', 'Thiết bị văn phòng', 'Bán dẫn', 'Thiết bị viễn thông', 'Tư Vấn, Định giá, Môi giới Bất động sản', 'Quỹ ủy thác BĐS', 'Quản lý tài sản', 'Tài chính cá nhân', 'Tài chính đặc biệt', 'Môi giới chứng khoán', 'Cầm cố', 'Quỹ đầu tư', 'Dịch vụ Máy tính', 'Internet'], 
+    Sequence[
+        Literal['Xây dựng', 'Vật liệu xây dựng & Nội thất', 'Đường sắt', 'Kho bãi, hậu cần và bảo dưỡng', 'Dịch vụ vận tải', 'Tư vấn & Hỗ trợ KD', 'Đào tạo & Việc làm', 'Công nghiệp hàng không', 'Quốc phòng', 'Containers & Đóng gói', 'Công nghiệp phức hợp', 'Hàng điện & điện tử', 'Thiết bị điện', 'Xe tải & Đóng tàu', 'Máy công nghiệp', 'Chuyển phát nhanh', 'Vận tải Thủy', 'Nhựa, cao su & sợi', 'Sản phẩm hóa dầu, Nông dược & Hóa chất khác', 'Lâm sản và Chế biến gỗ', 'Sản xuất giấy', 'Nhôm', 'Kim Loại màu', 'Thép và sản phẩm thép', 'Khai thác Than', 'Đá quý và Kim cương', 'Khai khoáng', 'Khai thác vàng', 'Bạch kim & Kim loại quý khác', 'Quản lý Tài chính', 'Chất thải & Môi trường', 'Sản xuất ô tô', 'Phụ tùng ô tô', 'Lốp xe', 'Sản xuất và Khai thác dầu khí', 'Tổ hợp Dầu khí', 'Thiết bị và Dịch vụ Dầu khí', 'Ống dẫn Dầu', 'Thiết bị năng lượng tái chế', 'Nhiên liệu thay thế', 'Nhà cung cấp thiết bị', 'Sản xuất bia', 'Vang & Rượu mạnh', 'Đồ uống & giải khát', 'Nuôi trồng nông & hải sản', 'Thực phẩm', 'Đồ gia dụng lâu bền', 'Đồ gia dụng một lần', 'Thiết bị gia dụng', 'Xây nhà', 'Điện tử tiêu dùng', 'Sản phẩm nghệ thuật', 'Đồ chơi', 'Hàng May mặc', 'Giầy dép', 'Hàng cá nhân', 'Thuốc lá', 'Chăm sóc y tế', 'Thiết bị y tế', 'Dụng cụ y tế', 'Công nghệ sinh học', 'Dược phẩm', 'Phân phối dược phẩm', 'Phân phối thực phẩm', 'Giải trí & Truyền thông', 'Dịch vụ truyền thông', 'Sách, ấn bản & sản phẩm văn hóa', 'Nhà hàng và quán bar', 'Vận tải hành khách & Du lịch', 'Viễn thông cố định', 'Môi giới bảo hiểm', 'Bảo hiểm phi nhân thọ', 'Tái bảo hiểm', 'Bảo hiểm nhân thọ', 'Bán lẻ hàng may mặc', 'Bán lẻ phức hợp', 'Phân phối nội thất', 'Dịch vụ tiêu dùng chuyên ngành', 'Phân phối hàng chuyên dụng', 'Dịch vụ hàng không', 'Gambling', 'Khách sạn', 'Dịch vụ giải trí', 'Viễn thông di động', 'Ngân hàng', 'Bảo hiểm phức hợp', 'Sản xuất & Phân phối Điện', 'Phân phối xăng dầu & khí đốt', 'Tiện ích khác', 'Nước', 'Bất động sản', 'Phần mềm', 'Phần cứng', 'Thiết bị văn phòng', 'Bán dẫn', 'Thiết bị viễn thông', 'Tư Vấn, Định giá, Môi giới Bất động sản', 'Quỹ ủy thác BĐS', 'Quản lý tài sản', 'Tài chính cá nhân', 'Tài chính đặc biệt', 'Môi giới chứng khoán', 'Cầm cố', 'Quỹ đầu tư', 'Dịch vụ Máy tính', 'Internet']]]