fin68 0.1.3__cp310-cp310-macosx_10_9_universal2.whl

fin68/__init__.py

@@ -0,0 +1,323 @@
+from __future__ import annotations
+
+"""
+Fin68 Python Client
+===================
+
+Client cấp cao giúp xác thực API Key, hiển thị thông báo từ backend và cung cấp
+các domain client như :class:`EodClient`. Thiết kế theo pattern "facade" để người
+dùng khởi tạo một lần và làm việc qua thuộc tính `client.eod`, v.v.
+
+Notes
+-----
+- Sử dụng `private_core.HttpSession` để gắn `base_url`, `timeout` và `user-agent`.
+- Tự động gọi `validate_api_key` khi khởi tạo để nhận thông tin phiên bản, cảnh báo
+  và meta của API key.
+- Tất cả cảnh báo/nhắc nâng cấp được hiển thị qua `warnings.warn` hoặc `logging`.
+
+See Also
+--------
+EodClient
+    Domain client cho dữ liệu EOD.
+"""
+
+import logging
+import warnings
+from typing import Optional
+
+from private_core.auth_core import validate_api_key
+from private_core.http_core import BASE_URL, DEFAULT_TIMEOUT, HttpSession
+
+from ._version import __version__
+from .clients import EodClient
+from .exceptions import ApiKeyValidationError, ConfigurationError
+from .types import ApiKeyMeta, ApiKeyValidationResponse, BackendMessage, MessageType
+
+logger = logging.getLogger(__name__)
+
+
+class Fin68Client:
+    """
+    Điểm truy cập chính tổng hợp các domain client của Fin68.
+
+    Khi khởi tạo, client sẽ:
+    1) Tạo `HttpSession` với API key.
+    2) Gọi `validate_api_key` để xác thực và lấy thông tin phiên bản.
+    3) Hiển thị các thông báo (nâng cấp/báo lỗi/cảnh báo) từ backend tới người dùng.
+    4) Khởi tạo các domain client (hiện tại: `eod`).
+
+    Parameters
+    ----------
+    api_key : str
+        API key hợp lệ do Fin68 phát hành.
+    extra_context : dict, optional
+        Ngữ cảnh bổ sung gửi lên backend khi validate (VD: môi trường chạy, app_name).
+
+    Attributes
+    ----------
+    eod : EodClient
+        Domain client cho dữ liệu EOD (OHLCV, technical, ...).
+    _session : HttpSession
+        Phiên HTTP dùng chung cho toàn bộ domain client.
+    _api_key_meta : ApiKeyMeta or None
+        Thông tin meta của API key sau khi xác thực.
+    _messages : list[BackendMessage]
+        Danh sách thông điệp backend trả về sau validate.
+
+    Raises
+    ------
+    ConfigurationError
+        Khi `api_key` rỗng/không được cung cấp.
+    ApiKeyValidationError
+        Khi xác thực API key thất bại (khóa sai/hết hạn/hệ thống từ chối).
+
+    Examples
+    --------
+    Khởi tạo và dùng như context manager:
+
+    >>> from fin68 import client
+    >>> with client(api_key="sk_live_...") as cli:
+    ...     df = cli.eod.ohlcv("HPG", start="2024-01-01", end="2024-12-31")
+
+    Hoặc quản lý vòng đời thủ công:
+
+    >>> cli = client(api_key="sk_live_...")
+    >>> try:
+    ...     meta = cli.api_key_metadata
+    ...     data = cli.eod.ohlcv("VCB")
+    ... finally:
+    ...     cli.close()
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        *,
+        extra_context: Optional[dict] = None,
+    ) -> None:
+        """
+        Khởi tạo client và xác thực API key ngay lập tức.
+
+        Parameters
+        ----------
+        api_key : str
+            API key hợp lệ.
+        extra_context : dict, optional
+            Context bổ sung gửi kèm khi validate.
+
+        Raises
+        ------
+        ConfigurationError
+            Khi không cung cấp API key.
+        ApiKeyValidationError
+            Khi backend từ chối API key (hết hạn, không hợp lệ, ...).
+        """
+        if not api_key:
+            raise ConfigurationError("Cần cung cấp API key để khởi tạo fin68.client()")
+
+        self._session = HttpSession(
+            api_key,
+            base_url=BASE_URL,
+            timeout=DEFAULT_TIMEOUT,
+            version=__version__,
+        )
+        self._api_key_meta: Optional[ApiKeyMeta] = None
+        self._messages: list[BackendMessage] = []
+
+        try:
+            validation = validate_api_key(
+                self._session,
+                client_version=__version__,
+                include_messages=True,
+                extra_context=extra_context,
+            )
+        except ApiKeyValidationError:
+            # Đảm bảo đóng session nếu validate thất bại
+            self._session.close()
+            raise
+        self._api_key_meta = validation.meta
+        self._messages = list(validation.iter_messages())
+
+        self._surface_messages(validation)
+
+        # Domain clients
+        self.eod = EodClient(self._session)
+
+    def _surface_messages(self, validation: ApiKeyValidationResponse) -> None:
+        """
+        Hiển thị các thông điệp từ backend (cảnh báo, lỗi, nhắc nâng cấp).
+
+        Parameters
+        ----------
+        validation : ApiKeyValidationResponse
+            Kết quả validate từ backend, bao gồm thông tin version và danh sách messages.
+
+        Notes
+        -----
+        - Các thông điệp loại `WARNING`, `ERROR`, `NOTIFY_API_KEY_EXPIRING/EXPIRED`
+          sẽ được hiển thị qua `warnings.warn(...)`.
+        - Thông báo nâng cấp (khi client cũ hơn phiên bản tối thiểu/khuyến nghị)
+          cũng được cảnh báo bằng `warnings.warn(...)` để người dùng sớm cập nhật.
+        """
+        version_info = validation.version
+        for message in self._messages:
+            if message.is_upgrade_notice() and version_info.requires_upgrade():
+                _emit_upgrade_notice(message, version_info.backend_version)
+            elif message.type in {
+                MessageType.NOTIFY_API_KEY_EXPIRING,
+                MessageType.NOTIFY_API_KEY_EXPIRED,
+                MessageType.WARNING,
+                MessageType.ERROR,
+            }:
+                warnings.warn(message.message, stacklevel=2)
+            else:
+                logger.info("Thông báo từ Fin68: %s", message.message)
+
+        if version_info.requires_upgrade() and not any(m.is_upgrade_notice() for m in self._messages):
+            warnings.warn(
+                (
+                    f"Đã có phiên bản fin68 mới hơn ({version_info.backend_version}). "
+                    "Hãy cập nhật để sử dụng các tính năng và bản sửa lỗi mới nhất."
+                ),
+                stacklevel=2,
+            )
+
+        if version_info.is_out_of_support():
+            warnings.warn(
+                (
+                    f"Phiên bản fin68 hiện tại ({version_info.client_version}) "
+                    f"đã thấp hơn mức tối thiểu được hỗ trợ ({version_info.minimum_supported_version}). "
+                    "Một số tính năng có thể không còn hoạt động ổn định."
+                ),
+                stacklevel=2,
+            )
+
+    @property
+    def api_key_metadata(self) -> Optional[ApiKeyMeta]:
+        """
+        Trả về meta của API key sau khi xác thực.
+
+        Returns
+        -------
+        ApiKeyMeta or None
+            Meta của API key (ngày hết hạn, trạng thái, ...), hoặc `None` nếu không sẵn có.
+        """
+        return self._api_key_meta
+
+    @property
+    def messages(self) -> list[BackendMessage]:
+        """
+        Danh sách thông điệp backend trả về khi validate.
+
+        Returns
+        -------
+        list[BackendMessage]
+            Bản sao danh sách thông điệp để tránh chỉnh sửa ngoài ý muốn.
+        """
+        return list(self._messages)
+
+    def close(self) -> None:
+        """
+        Đóng phiên HTTP bên dưới và giải phóng tài nguyên.
+
+        Notes
+        -----
+        - Nên gọi trong `finally` hoặc dùng context manager để đảm bảo đóng phiên.
+        """
+        self._session.close()
+
+    def __enter__(self) -> "Fin68Client":
+        """
+        Vào ngữ cảnh `with`.
+
+        Returns
+        -------
+        Fin68Client
+            Chính instance hiện tại.
+        """
+        return self
+
+    def __exit__(self, exc_type, exc, tb) -> None:
+        """
+        Thoát ngữ cảnh `with` và tự động đóng phiên HTTP.
+
+        Parameters
+        ----------
+        exc_type, exc, tb
+            Thông tin ngoại lệ (nếu có). Không can thiệp vào flow ngoại lệ.
+        """
+        self.close()
+
+
+def _emit_upgrade_notice(message: BackendMessage, latest_version: Optional[str]) -> None:
+    """
+    Hiển thị cảnh báo nâng cấp phiên bản client.
+
+    Parameters
+    ----------
+    message : BackendMessage
+        Thông điệp nâng cấp từ backend.
+    latest_version : str or None
+        Phiên bản mới nhất phía backend biết đến (nếu có).
+
+    Notes
+    -----
+    - Sử dụng `warnings.warn(..., stacklevel=3)` để đẩy cảnh báo lên callsite người dùng.
+    """
+    suffix = f" Phiên bản mới nhất: {latest_version}" if latest_version else ""
+    warnings.warn(f"{message.message}{suffix}", stacklevel=3)
+
+
+def client(
+    apiKey: Optional[str] = None,
+    *,
+    api_key: Optional[str] = None,
+    extra_context: Optional[dict] = None,
+) -> Fin68Client:
+    """
+    Factory tạo ra một :class:`Fin68Client` đã sẵn sàng sử dụng.
+
+    Hỗ trợ cả hai tên tham số `api_key` (chuẩn Python) và `apiKey` (thân thiện
+    với người dùng/JS). Nếu truyền cả hai, `api_key` sẽ được ưu tiên.
+
+    Parameters
+    ----------
+    apiKey : str, optional
+        API key. Chỉ dùng khi không truyền `api_key`.
+    api_key : str, optional
+        API key chuẩn (ưu tiên nếu được truyền).
+    extra_context : dict, optional
+        Ngữ cảnh bổ sung gửi lên backend khi validate.
+
+    Returns
+    -------
+    Fin68Client
+        Client đã xác thực xong, kèm các domain client như `eod`.
+
+    Raises
+    ------
+    ConfigurationError
+        Khi không cung cấp `api_key`/`apiKey`.
+    ApiKeyValidationError
+        Khi backend từ chối API key trong quá trình khởi tạo.
+
+    Examples
+    --------
+    >>> from fin68 import client
+    >>> cli = client(api_key="sk_live_...")
+    >>> try:
+    ...     df = cli.eod.ohlcv("HPG", start="2024-01-01", end="2024-06-30")
+    ... finally:
+    ...     cli.close()
+    """
+    key = api_key or apiKey
+    if not key:
+        raise ConfigurationError("Cần truyền tham số apiKey hoặc api_key khi khởi tạo fin68.client()")
+
+    return Fin68Client(
+        key,
+        extra_context=extra_context,
+    )
+
+
+__all__ = ["Fin68Client", "client", "__version__"]

fin68/__init__.pyi

@@ -0,0 +1,81 @@
+from typing import Optional, List, Dict
+from .clients import EodClient
+from .types import ApiKeyMeta, BackendMessage
+
+__version__: str
+
+class Fin68Client:
+    """
+    Client chính của thư viện Fin68 — chịu trách nhiệm xác thực API key,
+    khởi tạo phiên làm việc HTTP, và cung cấp các domain client như `eod`.
+    """
+
+    eod: EodClient
+    """
+    Domain client cho dữ liệu EOD (End-of-Day).
+
+    Cung cấp ba namespace chính:
+    - **stock** (`StockEod`) → Dữ liệu EOD cấp cổ phiếu, bao gồm:
+        - OHLCV (Open, High, Low, Close, Volume)
+        - Các chỉ báo kỹ thuật (MA, RSI, MACD, Bollinger, v.v.)
+        - Thống kê biến động và hiệu suất theo mã
+
+    - **market** (`MarketEod`) → Dữ liệu chỉ số thị trường (VNINDEX, HNXINDEX, UPCOMINDEX):
+        - Giá đóng cửa, khối lượng, vốn hóa, PE/PB toàn thị trường
+        - So sánh diễn biến giữa các sàn
+
+    - **sector** (`SectorEod`) → Dữ liệu EOD cấp ngành (ICB, VNSector...):
+        - Hiệu suất ngành, thay đổi vốn hóa, tỷ trọng thanh khoản
+        - So sánh ngành/tiểu ngành theo thời gian
+
+    Examples
+    --------
+    >>> from fin68 import client
+    >>> cli = client(api_key="sk_live_...")
+    >>> cli.eod.stock.ohlcv("HPG", start="2024-01-01", end="2024-06-30")
+    >>> cli.eod.market.ohlcv("VNINDEX", start="2024-01-01", end="2024-06-30")
+    >>> cli.eod.sector.ohlcv("Ngân hàng", start="2024-01-01", end="2024-06-30")
+
+
+    """
+
+    _api_key_meta: Optional[ApiKeyMeta]
+    """Thông tin meta của API key sau khi xác thực."""
+
+    _messages: List[BackendMessage]
+    """Danh sách thông điệp backend trả về sau validate."""
+
+    def __init__(
+        self,
+        api_key: str,
+        *,
+        extra_context: Optional[Dict] = None,
+    ) -> None: ...
+    """Khởi tạo Fin68Client và tự động xác thực API key."""
+
+    @property
+    def api_key_metadata(self) -> Optional[ApiKeyMeta]: ...
+    """Trả về meta của API key sau khi xác thực."""
+
+    @property
+    def messages(self) -> List[BackendMessage]: ...
+    """Danh sách thông điệp backend trả về khi validate."""
+
+    def close(self) -> None: ...
+    """Đóng session HTTP và giải phóng tài nguyên."""
+
+    def __enter__(self) -> "Fin68Client": ...
+    """Vào context manager (`with`)."""
+
+    def __exit__(self, exc_type, exc, tb) -> None: ...
+    """Thoát context manager (`with`) và tự động đóng session."""
+
+def client(
+    apiKey: Optional[str] = None,
+    *,
+    api_key: Optional[str] = None,
+    extra_context: Optional[Dict] = None,
+) -> Fin68Client: ...
+"""Factory khởi tạo và trả về một Fin68Client đã sẵn sàng sử dụng."""
+
+__all__: list[str]

fin68/_version.py

@@ -0,0 +1,17 @@
+from __future__ import annotations
+
+try:
+    from importlib.metadata import PackageNotFoundError, version
+except ImportError:  # pragma: no cover - Python <3.8
+    from importlib_metadata import PackageNotFoundError, version  # type: ignore
+
+
+def _resolve_version() -> str:
+    try:
+        return version("fin68")
+    except PackageNotFoundError:
+        return "0.0.0"
+
+
+__all__ = ["__version__"]
+__version__ = _resolve_version()

fin68/clients/__init__.py

@@ -0,0 +1,3 @@
+from .eod_main import EodClient
+
+__all__ = ["EodClient"]

fin68/clients/base.py

@@ -0,0 +1,17 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from private_core.http_core import HttpSession
+
+
+class BaseClient:
+    """Base class for all Fin68 client modules providing shared HTTP session access."""
+
+    def __init__(self, session: "HttpSession") -> None:
+        self._session = session
+
+    @property
+    def session(self) -> "HttpSession":
+        return self._session

fin68/clients/eod/MarketEod.py

@@ -0,0 +1,142 @@
+from __future__ import annotations
+
+"""
+fin68.clients.eod.market
+========================
+
+Cung cấp lớp `MarketEod` — tập hợp các endpoint EOD (End-of-Day)
+dành cho **chỉ số thị trường** như VNINDEX, VN30, HNX, HNX30 và UPCOM.
+
+Notes
+-----
+- Dữ liệu được lấy từ `private_core.eod_core.fetch_ohlcv()`.
+- Tất cả kết quả được trả về dưới dạng `pandas.DataFrame`.
+- Có thể truy vấn nhiều chỉ số cùng lúc.
+
+"""
+
+from typing import TYPE_CHECKING, Sequence, Union, Literal
+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
+
+IndexArg = Union[
+    Literal["VNINDEX", "VN30", "HNX", "HNX30", "UPCOM"],
+    Sequence[Literal["VNINDEX", "VN30", "HNX", "HNX30", "UPCOM"]],
+]
+INDEXS = {"VNINDEX", "VN30", "HNX", "HNX30", "UPCOM"}
+
+class MarketEod(BaseClient, _EodMixin):
+    """
+    Cung cấp các endpoint EOD cho các chỉ số thị trường (Market Indices).
+
+    Bao gồm các chỉ số phổ biến:
+    - **VNINDEX**: chỉ số toàn thị trường HOSE  
+    - **VN30**: nhóm 30 cổ phiếu vốn hóa lớn trên HOSE  
+    - **HNX**, **HNX30**: chỉ số sàn Hà Nội  
+    - **UPCOM**: thị trường UPCOM
+
+    Parameters
+    ----------
+    session : HttpSession
+        Phiên HTTP đã xác thực, được truyền từ `EodClient`.
+
+    Notes
+    -----
+    - Hỗ trợ nhiều chỉ số trong cùng một lệnh truy vấn (`list[str]`).
+    - Tự động kiểm tra tính hợp lệ của khoảng thời gian (`start <= end`).
+    - Có thể lấy dữ liệu theo nhiều `interval` (ngày, tuần, tháng, v.v.).
+    - Trả về dữ liệu OHLCV (Open, High, Low, Close, Volume) của chỉ số.
+    """
+
+    def __init__(self, session: "HttpSession") -> None:
+        """
+        Khởi tạo `MarketEod` với session HTTP đã xác thực.
+
+        Parameters
+        ----------
+        session : HttpSession
+            Phiên HTTP được chia sẻ từ `EodClient`.
+        """
+        super().__init__(session=session)
+
+    def ohlcv(
+        self,
+        symbol: IndexArg,
+        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 chỉ số thị trường.
+
+        Parameters
+        ----------
+        symbol : {"VNINDEX", "VN30", "HNX", "HNX30", "UPCOM"} or Sequence
+            Chỉ số hoặc danh sách chỉ số cần lấy dữ liệu.
+        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, gồm các cột:
+            - `symbol`: tên chỉ số  
+            - `Date`: ngày giao dịch  
+            - `Open`, `High`, `Low`, `Close`, `Volume`
+
+        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 trong quá trình gọi API.
+
+        Examples
+        --------
+        >>> from fin68 import client
+        >>> cli = client(api_key="sk_live_...")
+        >>> df = cli.eod.market.ohlcv("VNINDEX", start="2024-01-01", end="2024-06-30")
+        >>> df.head()
+            symbol        Date    Open    High     Low   Close   Volume
+        0  VNINDEX  2024-01-02  1120.0  1125.6  1110.2  1119.4  612000000
+
+        >>> # Lấy đồng thời nhiều chỉ số
+        >>> cli.eod.market.ohlcv(["VNINDEX", "VN30", "HNX"])
+
+        Notes
+        -----
+        - Có thể dùng để so sánh biến động giữa các chỉ số thị trường.
+        - Hàm này là wrapper của `private_core.eod_core.fetch_ohlcv`.
+        """
+        if not isinstance(symbol, list):
+            if symbol.upper() not in INDEXS:
+                raise ValueError(f"Chỉ số '{symbol}' không hợp lệ. Vui lòng chọn trong {INDEXS}")
+        else:
+            for idx in symbol:
+                if idx.upper() not in INDEXS:
+                    raise ValueError(f"Chỉ số '{idx}' không hợp lệ. Vui lòng chọn trong {INDEXS}")
+        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,
+            interval=interval_value,
+        )
+        return self._to_dataframe(payload)

fin68/clients/eod/MarketEod.pyi

@@ -0,0 +1,95 @@
+from __future__ import annotations
+
+"""
+fin68.clients.eod.market (stub)
+===============================
+
+Type stub cho lớp `MarketEod` — phục vụ autocomplete/typing trong IDE và
+static type checker. Không thực thi logic, chỉ khai báo kiểu.
+
+Ghi chú
+-------
+- Docstring giữ phong cách NumPy, giúp IDE hiển thị tooltip rõ ràng.
+- Thân hàm dùng `...` theo chuẩn stub.
+"""
+
+from typing import TYPE_CHECKING, Sequence, Union, Literal
+from ..base import BaseClient
+from .helper import DateStr, Interval, _EodMixin
+
+if TYPE_CHECKING:
+    from pandas import DataFrame
+    from private_core.http_core import HttpSession
+
+IndexArg = Union[
+    Literal["VNINDEX", "VN30", "HNX", "HNX30", "UPCOM"],
+    Sequence[Literal["VNINDEX", "VN30", "HNX", "HNX30", "UPCOM"]],
+]
+
+
+class MarketEod(BaseClient, _EodMixin):
+    """
+    Endpoint EOD cho các chỉ số thị trường (VNINDEX, VN30, HNX, HNX30, UPCOM).
+
+    Parameters
+    ----------
+    session : HttpSession
+        Phiên HTTP đã xác thực, được truyền từ `EodClient`.
+
+    Notes
+    -----
+    - Hỗ trợ truy vấn nhiều chỉ số cùng lúc (list).
+    - Tự động chuẩn hóa khoảng thời gian và validate `interval`.
+    - Trả về dữ liệu OHLCV (Open, High, Low, Close, Volume) của chỉ số.
+    """
+
+    def __init__(self, session: "HttpSession") -> None: ...
+    """
+    Khởi tạo `MarketEod` với session HTTP đã xác thực.
+
+    Parameters
+    ----------
+    session : HttpSession
+        Phiên HTTP chia sẻ từ `EodClient`.
+    """
+
+    def ohlcv(
+        self,
+        symbol: IndexArg,
+        start: DateStr = None,
+        end: DateStr = None,
+        interval: Interval = "1D",
+    ) -> "DataFrame": ...
+    """
+    Lấy dữ liệu OHLCV cho một hoặc nhiều chỉ số thị trường.
+
+    Parameters
+    ----------
+    symbol : {"VNINDEX", "VN30", "HNX", "HNX30", "UPCOM"} or Sequence
+        Chỉ số hoặc danh sách chỉ số cần lấy dữ liệu.
+    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
+        Bảng dữ liệu gồm: `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_...")
+    >>> cli.eod.market.ohlcv("VNINDEX", start="2024-01-01", end="2024-06-30")
+    >>> cli.eod.market.ohlcv(["VNINDEX", "VN30", "HNX"])
+    """