krxon 0.1.0__tar.gz

krxon-0.1.0/PKG-INFO

@@ -0,0 +1,173 @@
+Metadata-Version: 2.4
+Name: krxon
+Version: 0.1.0
+Summary: KRX (Korea Exchange) Open API Python SDK - auto-generated by krxon
+Project-URL: Homepage, https://github.com/seungdols/krxon
+Project-URL: Repository, https://github.com/seungdols/krxon
+Project-URL: Issues, https://github.com/seungdols/krxon/issues
+Author: seungdols
+License: MIT
+Keywords: api,finance,korea-exchange,krx,sdk
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.24.0
+Description-Content-Type: text/markdown
+
+# krxon
+
+CLI tool for the KRX (Korea Exchange) Open API.
+
+## Features
+
+- **fetch** - Query KRX market data from the command line
+- **generate** - Generate Python and TypeScript SDK clients from the API spec
+
+## Installation
+
+### Cargo (Rust)
+
+```bash
+cargo install krxon
+```
+
+### Python SDK (PyPI)
+
+```bash
+pip install krxon
+```
+
+### TypeScript SDK (npm)
+
+```bash
+npm install @krxon/krx
+```
+
+### From source
+
+```bash
+git clone https://github.com/seungdols/krxon.git
+cd krxon
+cargo build --release
+```
+
+## Getting Started
+
+### Prerequisites
+
+- A KRX Open API key from [openapi.krx.co.kr](https://openapi.krx.co.kr)
+
+### Setup
+
+```bash
+# Store your API key
+krxon init
+
+# Or set via environment variable
+export KRX_API_KEY=your_key_here
+```
+
+### Usage
+
+#### Fetch Index Data
+
+```bash
+krxon fetch index krx --date 20250301
+krxon fetch index kospi --date 20250301
+krxon fetch index kosdaq --date 20250301
+krxon fetch index derivatives --date 20250301
+```
+
+#### Fetch Stock Data
+
+```bash
+krxon fetch stock kospi --date 20250301
+krxon fetch stock kosdaq --date 20250301
+krxon fetch stock kospi-info --date 20250301
+krxon fetch stock kosdaq-info --date 20250301
+
+# Filter by ISIN code
+krxon fetch stock kospi --date 20250301 --isin KR7005930003
+```
+
+#### Fetch ETP Data
+
+```bash
+krxon fetch etp etf --date 20250301
+krxon fetch etp etn --date 20250301
+
+# Filter by ISIN code
+krxon fetch etp etf --date 20250301 --isin KR7069500007
+```
+
+#### Fetch Derivatives Data
+
+```bash
+# Futures
+krxon fetch derivatives futures --date 20250301
+krxon fetch derivatives stock-futures-kospi --date 20250301
+krxon fetch derivatives stock-futures-kosdaq --date 20250301
+
+# Options
+krxon fetch derivatives options --date 20250301
+krxon fetch derivatives stock-options-kospi --date 20250301
+krxon fetch derivatives stock-options-kosdaq --date 20250301
+
+# Table output
+krxon fetch derivatives futures --date 20250301 --output table
+```
+
+#### Generate SDK Clients
+
+```bash
+# Generate Python SDK
+krxon generate python --out ./sdk/python
+
+# Generate TypeScript SDK
+krxon generate typescript --out ./sdk/typescript
+```
+
+### Common Options
+
+- `--date` (required): Base date in YYYYMMDD format
+- `--key`: API key (overrides `KRX_API_KEY` env var)
+- `--output`: `json` (default) or `table`
+
+## SDK Usage
+
+### Python
+
+```python
+from krx import KrxClient
+
+client = KrxClient(api_key="your_key")
+records = client.get_kospi_stock_daily(basDd="20250301")
+for r in records:
+    print(r["ISU_NM"], r["TDD_CLSPRC"])
+```
+
+### TypeScript
+
+```typescript
+import { KrxClient } from "@krxon/krx";
+
+const client = new KrxClient({ apiKey: "your_key" });
+const records = await client.getKospiStockDaily("20250301");
+records.forEach((r) => console.log(r.ISU_NM, r.TDD_CLSPRC));
+```
+
+## Project Structure
+
+See [AGENT.md](AGENT.md) for the full project structure and conventions.
+
+## License
+
+MIT

krxon-0.1.0/README.md

@@ -0,0 +1,149 @@
+# krxon
+
+CLI tool for the KRX (Korea Exchange) Open API.
+
+## Features
+
+- **fetch** - Query KRX market data from the command line
+- **generate** - Generate Python and TypeScript SDK clients from the API spec
+
+## Installation
+
+### Cargo (Rust)
+
+```bash
+cargo install krxon
+```
+
+### Python SDK (PyPI)
+
+```bash
+pip install krxon
+```
+
+### TypeScript SDK (npm)
+
+```bash
+npm install @krxon/krx
+```
+
+### From source
+
+```bash
+git clone https://github.com/seungdols/krxon.git
+cd krxon
+cargo build --release
+```
+
+## Getting Started
+
+### Prerequisites
+
+- A KRX Open API key from [openapi.krx.co.kr](https://openapi.krx.co.kr)
+
+### Setup
+
+```bash
+# Store your API key
+krxon init
+
+# Or set via environment variable
+export KRX_API_KEY=your_key_here
+```
+
+### Usage
+
+#### Fetch Index Data
+
+```bash
+krxon fetch index krx --date 20250301
+krxon fetch index kospi --date 20250301
+krxon fetch index kosdaq --date 20250301
+krxon fetch index derivatives --date 20250301
+```
+
+#### Fetch Stock Data
+
+```bash
+krxon fetch stock kospi --date 20250301
+krxon fetch stock kosdaq --date 20250301
+krxon fetch stock kospi-info --date 20250301
+krxon fetch stock kosdaq-info --date 20250301
+
+# Filter by ISIN code
+krxon fetch stock kospi --date 20250301 --isin KR7005930003
+```
+
+#### Fetch ETP Data
+
+```bash
+krxon fetch etp etf --date 20250301
+krxon fetch etp etn --date 20250301
+
+# Filter by ISIN code
+krxon fetch etp etf --date 20250301 --isin KR7069500007
+```
+
+#### Fetch Derivatives Data
+
+```bash
+# Futures
+krxon fetch derivatives futures --date 20250301
+krxon fetch derivatives stock-futures-kospi --date 20250301
+krxon fetch derivatives stock-futures-kosdaq --date 20250301
+
+# Options
+krxon fetch derivatives options --date 20250301
+krxon fetch derivatives stock-options-kospi --date 20250301
+krxon fetch derivatives stock-options-kosdaq --date 20250301
+
+# Table output
+krxon fetch derivatives futures --date 20250301 --output table
+```
+
+#### Generate SDK Clients
+
+```bash
+# Generate Python SDK
+krxon generate python --out ./sdk/python
+
+# Generate TypeScript SDK
+krxon generate typescript --out ./sdk/typescript
+```
+
+### Common Options
+
+- `--date` (required): Base date in YYYYMMDD format
+- `--key`: API key (overrides `KRX_API_KEY` env var)
+- `--output`: `json` (default) or `table`
+
+## SDK Usage
+
+### Python
+
+```python
+from krx import KrxClient
+
+client = KrxClient(api_key="your_key")
+records = client.get_kospi_stock_daily(basDd="20250301")
+for r in records:
+    print(r["ISU_NM"], r["TDD_CLSPRC"])
+```
+
+### TypeScript
+
+```typescript
+import { KrxClient } from "@krxon/krx";
+
+const client = new KrxClient({ apiKey: "your_key" });
+const records = await client.getKospiStockDaily("20250301");
+records.forEach((r) => console.log(r.ISU_NM, r.TDD_CLSPRC));
+```
+
+## Project Structure
+
+See [AGENT.md](AGENT.md) for the full project structure and conventions.
+
+## License
+
+MIT

krxon-0.1.0/krx/__init__.py

@@ -0,0 +1,8 @@
+# AUTO-GENERATED -- DO NOT EDIT
+# Generated by krxon from spec/endpoints.yaml
+
+"""KRX Open API Python SDK."""
+
+from krx.client import KrxClient
+
+__all__ = ["KrxClient"]

krxon-0.1.0/krx/client.py

@@ -0,0 +1,73 @@
+# AUTO-GENERATED -- DO NOT EDIT
+# Generated by krxon from spec/endpoints.yaml
+
+"""KRX API client."""
+
+from __future__ import annotations
+
+import os
+from typing import Any, Optional
+
+import httpx
+
+from krx.endpoints.index import IndexMixin
+from krx.endpoints.stock import StockMixin
+from krx.endpoints.etp import EtpMixin
+from krx.endpoints.derivatives import DerivativesMixin
+
+
+class KrxClient(
+    IndexMixin,
+    StockMixin,
+    EtpMixin,
+    DerivativesMixin,
+):
+    """KRX Open API client.
+
+    Args:
+        api_key: API key for authentication (AUTH_KEY header).
+                 Falls back to KRX_API_KEY environment variable if not provided.
+        base_url: Base URL for the KRX API.
+        timeout: Request timeout in seconds.
+    """
+
+    BASE_URL = "https://data-dbg.krx.co.kr/svc/apis"
+
+    def __init__(
+        self,
+        api_key: Optional[str] = None,
+        base_url: str = BASE_URL,
+        timeout: float = 30.0,
+    ) -> None:
+        resolved_key = api_key or os.environ.get("KRX_API_KEY", "")
+        if not resolved_key:
+            raise ValueError(
+                "API key is required. Pass api_key or set KRX_API_KEY environment variable."
+            )
+        self.api_key = resolved_key
+        self.base_url = base_url.rstrip("/")
+        self._client = httpx.Client(
+            headers={
+                "AUTH_KEY": resolved_key,
+                "Content-Type": "application/json",
+            },
+            timeout=timeout,
+        )
+
+    def _post(self, path: str, body: dict[str, Any]) -> list[Any]:
+        """Send a POST request and extract OutBlock_1 from the response."""
+        url = f"{self.base_url}{path}"
+        response = self._client.post(url, json=body)
+        response.raise_for_status()
+        data = response.json()
+        return data.get("OutBlock_1", [])
+
+    def close(self) -> None:
+        """Close the underlying HTTP client."""
+        self._client.close()
+
+    def __enter__(self) -> KrxClient:
+        return self
+
+    def __exit__(self, *args: Any) -> None:
+        self.close()

krxon-0.1.0/krx/endpoints/__init__.py

@@ -0,0 +1,4 @@
+# AUTO-GENERATED -- DO NOT EDIT
+# Generated by krxon from spec/endpoints.yaml
+
+"""Endpoint mixin modules."""

krxon-0.1.0/krx/endpoints/derivatives.py

@@ -0,0 +1,125 @@
+# AUTO-GENERATED -- DO NOT EDIT
+# Generated by krxon from spec/endpoints.yaml
+
+"""Derivatives (Futures/Options) endpoints."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from krx.types import (
+        FuturesDailyRecord,
+        OptionsDailyRecord,
+        StockFuturesKosdaqDailyRecord,
+        StockFuturesKospiDailyRecord,
+        StockOptionsKosdaqDailyRecord,
+        StockOptionsKospiDailyRecord,
+    )
+
+
+class DerivativesMixin:
+    """Mixin providing derivatives endpoint methods."""
+
+    def get_futures_daily(
+        self,
+        basDd: str,
+    ) -> list[FuturesDailyRecord]:
+        """선물 일별 시세
+
+        Args:
+            basDd: 기준일자 (YYYYMMDD)
+
+        Returns:
+            List of FuturesDailyRecord records.
+        """
+        body: dict[str, str] = {
+            "basDd": basDd,
+        }
+        return self._post("/drv/fut_bydd_trd", body)  # type: ignore[attr-defined]
+
+    def get_options_daily(
+        self,
+        basDd: str,
+    ) -> list[OptionsDailyRecord]:
+        """옵션 일별 시세
+
+        Args:
+            basDd: 기준일자 (YYYYMMDD)
+
+        Returns:
+            List of OptionsDailyRecord records.
+        """
+        body: dict[str, str] = {
+            "basDd": basDd,
+        }
+        return self._post("/drv/opt_bydd_trd", body)  # type: ignore[attr-defined]
+
+    def get_stock_futures_kosdaq_daily(
+        self,
+        basDd: str,
+    ) -> list[StockFuturesKosdaqDailyRecord]:
+        """KOSDAQ 주식선물 일별 시세
+
+        Args:
+            basDd: 기준일자 (YYYYMMDD)
+
+        Returns:
+            List of StockFuturesKosdaqDailyRecord records.
+        """
+        body: dict[str, str] = {
+            "basDd": basDd,
+        }
+        return self._post("/drv/eqkfu_ksq_bydd_trd", body)  # type: ignore[attr-defined]
+
+    def get_stock_futures_kospi_daily(
+        self,
+        basDd: str,
+    ) -> list[StockFuturesKospiDailyRecord]:
+        """KOSPI 주식선물 일별 시세
+
+        Args:
+            basDd: 기준일자 (YYYYMMDD)
+
+        Returns:
+            List of StockFuturesKospiDailyRecord records.
+        """
+        body: dict[str, str] = {
+            "basDd": basDd,
+        }
+        return self._post("/drv/eqsfu_stk_bydd_trd", body)  # type: ignore[attr-defined]
+
+    def get_stock_options_kosdaq_daily(
+        self,
+        basDd: str,
+    ) -> list[StockOptionsKosdaqDailyRecord]:
+        """KOSDAQ 주식옵션 일별 시세
+
+        Args:
+            basDd: 기준일자 (YYYYMMDD)
+
+        Returns:
+            List of StockOptionsKosdaqDailyRecord records.
+        """
+        body: dict[str, str] = {
+            "basDd": basDd,
+        }
+        return self._post("/drv/eqkop_bydd_trd", body)  # type: ignore[attr-defined]
+
+    def get_stock_options_kospi_daily(
+        self,
+        basDd: str,
+    ) -> list[StockOptionsKospiDailyRecord]:
+        """KOSPI 주식옵션 일별 시세
+
+        Args:
+            basDd: 기준일자 (YYYYMMDD)
+
+        Returns:
+            List of StockOptionsKospiDailyRecord records.
+        """
+        body: dict[str, str] = {
+            "basDd": basDd,
+        }
+        return self._post("/drv/eqsop_bydd_trd", body)  # type: ignore[attr-defined]
+

krxon-0.1.0/krx/endpoints/etp.py

@@ -0,0 +1,53 @@
+# AUTO-GENERATED -- DO NOT EDIT
+# Generated by krxon from spec/endpoints.yaml
+
+"""ETP (ETF/ETN) endpoints."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from krx.types import (
+        EtfDailyRecord,
+        EtnDailyRecord,
+    )
+
+
+class EtpMixin:
+    """Mixin providing etp endpoint methods."""
+
+    def get_etf_daily(
+        self,
+        basDd: str,
+    ) -> list[EtfDailyRecord]:
+        """ETF 일별 시세
+
+        Args:
+            basDd: 기준일자 (YYYYMMDD)
+
+        Returns:
+            List of EtfDailyRecord records.
+        """
+        body: dict[str, str] = {
+            "basDd": basDd,
+        }
+        return self._post("/etp/etf_bydd_trd", body)  # type: ignore[attr-defined]
+
+    def get_etn_daily(
+        self,
+        basDd: str,
+    ) -> list[EtnDailyRecord]:
+        """ETN 일별 시세
+
+        Args:
+            basDd: 기준일자 (YYYYMMDD)
+
+        Returns:
+            List of EtnDailyRecord records.
+        """
+        body: dict[str, str] = {
+            "basDd": basDd,
+        }
+        return self._post("/etp/etn_bydd_trd", body)  # type: ignore[attr-defined]
+

krxon-0.1.0/krx/endpoints/index.py

@@ -0,0 +1,89 @@
+# AUTO-GENERATED -- DO NOT EDIT
+# Generated by krxon from spec/endpoints.yaml
+
+"""Index (KRX/KOSPI/KOSDAQ/Derivatives) endpoints."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from krx.types import (
+        DerivativesIndexDailyRecord,
+        KosdaqIndexDailyRecord,
+        KospiIndexDailyRecord,
+        KrxIndexDailyRecord,
+    )
+
+
+class IndexMixin:
+    """Mixin providing index endpoint methods."""
+
+    def get_derivatives_index_daily(
+        self,
+        basDd: str,
+    ) -> list[DerivativesIndexDailyRecord]:
+        """파생상품 지수 일별 시세
+
+        Args:
+            basDd: 기준일자 (YYYYMMDD)
+
+        Returns:
+            List of DerivativesIndexDailyRecord records.
+        """
+        body: dict[str, str] = {
+            "basDd": basDd,
+        }
+        return self._post("/idx/drvprod_dd_trd", body)  # type: ignore[attr-defined]
+
+    def get_kosdaq_index_daily(
+        self,
+        basDd: str,
+    ) -> list[KosdaqIndexDailyRecord]:
+        """KOSDAQ 지수 일별 시세
+
+        Args:
+            basDd: 기준일자 (YYYYMMDD)
+
+        Returns:
+            List of KosdaqIndexDailyRecord records.
+        """
+        body: dict[str, str] = {
+            "basDd": basDd,
+        }
+        return self._post("/idx/kosdaq_dd_trd", body)  # type: ignore[attr-defined]
+
+    def get_kospi_index_daily(
+        self,
+        basDd: str,
+    ) -> list[KospiIndexDailyRecord]:
+        """KOSPI 지수 일별 시세
+
+        Args:
+            basDd: 기준일자 (YYYYMMDD)
+
+        Returns:
+            List of KospiIndexDailyRecord records.
+        """
+        body: dict[str, str] = {
+            "basDd": basDd,
+        }
+        return self._post("/idx/kospi_dd_trd", body)  # type: ignore[attr-defined]
+
+    def get_krx_index_daily(
+        self,
+        basDd: str,
+    ) -> list[KrxIndexDailyRecord]:
+        """KRX 지수 일별 시세
+
+        Args:
+            basDd: 기준일자 (YYYYMMDD)
+
+        Returns:
+            List of KrxIndexDailyRecord records.
+        """
+        body: dict[str, str] = {
+            "basDd": basDd,
+        }
+        return self._post("/idx/krx_dd_trd", body)  # type: ignore[attr-defined]
+

krxon-0.1.0/krx/endpoints/stock.py

@@ -0,0 +1,89 @@
+# AUTO-GENERATED -- DO NOT EDIT
+# Generated by krxon from spec/endpoints.yaml
+
+"""Stock (KOSPI/KOSDAQ daily trading and info) endpoints."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from krx.types import (
+        KosdaqStockDailyRecord,
+        KosdaqStockInfoRecord,
+        KospiStockDailyRecord,
+        KospiStockInfoRecord,
+    )
+
+
+class StockMixin:
+    """Mixin providing stock endpoint methods."""
+
+    def get_kosdaq_stock_daily(
+        self,
+        basDd: str,
+    ) -> list[KosdaqStockDailyRecord]:
+        """KOSDAQ 주식 일별 시세
+
+        Args:
+            basDd: 기준일자 (YYYYMMDD)
+
+        Returns:
+            List of KosdaqStockDailyRecord records.
+        """
+        body: dict[str, str] = {
+            "basDd": basDd,
+        }
+        return self._post("/sto/ksq_bydd_trd", body)  # type: ignore[attr-defined]
+
+    def get_kosdaq_stock_info(
+        self,
+        basDd: str,
+    ) -> list[KosdaqStockInfoRecord]:
+        """KOSDAQ 종목 기본 정보
+
+        Args:
+            basDd: 기준일자 (YYYYMMDD)
+
+        Returns:
+            List of KosdaqStockInfoRecord records.
+        """
+        body: dict[str, str] = {
+            "basDd": basDd,
+        }
+        return self._post("/sto/ksq_isu_base_info", body)  # type: ignore[attr-defined]
+
+    def get_kospi_stock_daily(
+        self,
+        basDd: str,
+    ) -> list[KospiStockDailyRecord]:
+        """KOSPI 주식 일별 시세
+
+        Args:
+            basDd: 기준일자 (YYYYMMDD)
+
+        Returns:
+            List of KospiStockDailyRecord records.
+        """
+        body: dict[str, str] = {
+            "basDd": basDd,
+        }
+        return self._post("/sto/stk_bydd_trd", body)  # type: ignore[attr-defined]
+
+    def get_kospi_stock_info(
+        self,
+        basDd: str,
+    ) -> list[KospiStockInfoRecord]:
+        """KOSPI 종목 기본 정보
+
+        Args:
+            basDd: 기준일자 (YYYYMMDD)
+
+        Returns:
+            List of KospiStockInfoRecord records.
+        """
+        body: dict[str, str] = {
+            "basDd": basDd,
+        }
+        return self._post("/sto/stk_isu_base_info", body)  # type: ignore[attr-defined]
+

krxon-0.1.0/krx/types.py

@@ -0,0 +1,548 @@
+# AUTO-GENERATED -- DO NOT EDIT
+# Generated by krxon from spec/endpoints.yaml
+
+"""Response types for KRX API endpoints.
+
+All fields are strings as returned by the KRX API.
+Numeric fields may contain commas (e.g., "1,000,000").
+"""
+
+from __future__ import annotations
+
+from typing import TypedDict
+
+
+class DerivativesIndexDailyRecord(TypedDict):
+    """파생상품 지수 일별 시세"""
+
+    BAS_DD: str  # 기준일자
+
+    IDX_CLSS: str  # 계열구분
+
+    IDX_NM: str  # 지수명
+
+    CLSPRC_IDX: str  # 종가
+
+    CMPPREVDD_IDX: str  # 대비 (전일 대비 변동)
+
+    FLUC_RT: str  # 등락률 (%)
+
+    OPNPRC_IDX: str  # 시가
+
+    HGPRC_IDX: str  # 고가
+
+    LWPRC_IDX: str  # 저가
+
+
+
+class KosdaqIndexDailyRecord(TypedDict):
+    """KOSDAQ 지수 일별 시세"""
+
+    BAS_DD: str  # 기준일자
+
+    IDX_CLSS: str  # 계열구분
+
+    IDX_NM: str  # 지수명
+
+    CLSPRC_IDX: str  # 종가
+
+    CMPPREVDD_IDX: str  # 대비 (전일 대비 변동)
+
+    FLUC_RT: str  # 등락률 (%)
+
+    OPNPRC_IDX: str  # 시가
+
+    HGPRC_IDX: str  # 고가
+
+    LWPRC_IDX: str  # 저가
+
+    ACC_TRDVOL: str  # 거래량
+
+    ACC_TRDVAL: str  # 거래대금
+
+    MKTCAP: str  # 상장시가총액
+
+
+
+class KospiIndexDailyRecord(TypedDict):
+    """KOSPI 지수 일별 시세"""
+
+    BAS_DD: str  # 기준일자
+
+    IDX_CLSS: str  # 계열구분
+
+    IDX_NM: str  # 지수명
+
+    CLSPRC_IDX: str  # 종가
+
+    CMPPREVDD_IDX: str  # 대비 (전일 대비 변동)
+
+    FLUC_RT: str  # 등락률 (%)
+
+    OPNPRC_IDX: str  # 시가
+
+    HGPRC_IDX: str  # 고가
+
+    LWPRC_IDX: str  # 저가
+
+    ACC_TRDVOL: str  # 거래량
+
+    ACC_TRDVAL: str  # 거래대금
+
+    MKTCAP: str  # 상장시가총액
+
+
+
+class KrxIndexDailyRecord(TypedDict):
+    """KRX 지수 일별 시세"""
+
+    BAS_DD: str  # 기준일자
+
+    IDX_CLSS: str  # 계열구분
+
+    IDX_NM: str  # 지수명
+
+    CLSPRC_IDX: str  # 종가
+
+    CMPPREVDD_IDX: str  # 대비 (전일 대비 변동)
+
+    FLUC_RT: str  # 등락률 (%)
+
+    OPNPRC_IDX: str  # 시가
+
+    HGPRC_IDX: str  # 고가
+
+    LWPRC_IDX: str  # 저가
+
+    ACC_TRDVOL: str  # 거래량
+
+    ACC_TRDVAL: str  # 거래대금
+
+    MKTCAP: str  # 상장시가총액
+
+
+
+class KosdaqStockDailyRecord(TypedDict):
+    """KOSDAQ 주식 일별 시세"""
+
+    BAS_DD: str  # 기준일자
+
+    ISU_CD: str  # 종목코드 (ISIN)
+
+    ISU_NM: str  # 종목명
+
+    MKT_NM: str  # 시장구분
+
+    SECT_TP_NM: str  # 소속부
+
+    TDD_CLSPRC: str  # 종가
+
+    CMPPREVDD_PRC: str  # 대비 (전일 대비 변동)
+
+    FLUC_RT: str  # 등락률 (%)
+
+    TDD_OPNPRC: str  # 시가
+
+    TDD_HGPRC: str  # 고가
+
+    TDD_LWPRC: str  # 저가
+
+    ACC_TRDVOL: str  # 거래량
+
+    ACC_TRDVAL: str  # 거래대금
+
+    MKTCAP: str  # 시가총액
+
+    LIST_SHRS: str  # 상장주식수
+
+
+
+class KosdaqStockInfoRecord(TypedDict):
+    """KOSDAQ 종목 기본 정보"""
+
+    ISU_CD: str  # 표준코드 (ISIN)
+
+    ISU_SRT_CD: str  # 단축코드
+
+    ISU_NM: str  # 한글 종목명
+
+    ISU_ABBRV: str  # 한글 종목약명
+
+    ISU_ENG_NM: str  # 영문 종목명
+
+    LIST_DD: str  # 상장일
+
+    MKT_TP_NM: str  # 시장구분
+
+    SECUGRP_NM: str  # 증권구분
+
+    SECT_TP_NM: str  # 소속부
+
+    KIND_STKCERT_TP_NM: str  # 주식종류
+
+    PARVAL: str  # 액면가
+
+    LIST_SHRS: str  # 상장주식수
+
+
+
+class KospiStockDailyRecord(TypedDict):
+    """KOSPI 주식 일별 시세"""
+
+    BAS_DD: str  # 기준일자
+
+    ISU_CD: str  # 종목코드 (ISIN)
+
+    ISU_NM: str  # 종목명
+
+    MKT_NM: str  # 시장구분
+
+    SECT_TP_NM: str  # 소속부
+
+    TDD_CLSPRC: str  # 종가
+
+    CMPPREVDD_PRC: str  # 대비 (전일 대비 변동)
+
+    FLUC_RT: str  # 등락률 (%)
+
+    TDD_OPNPRC: str  # 시가
+
+    TDD_HGPRC: str  # 고가
+
+    TDD_LWPRC: str  # 저가
+
+    ACC_TRDVOL: str  # 거래량
+
+    ACC_TRDVAL: str  # 거래대금
+
+    MKTCAP: str  # 시가총액
+
+    LIST_SHRS: str  # 상장주식수
+
+
+
+class KospiStockInfoRecord(TypedDict):
+    """KOSPI 종목 기본 정보"""
+
+    ISU_CD: str  # 표준코드 (ISIN)
+
+    ISU_SRT_CD: str  # 단축코드
+
+    ISU_NM: str  # 한글 종목명
+
+    ISU_ABBRV: str  # 한글 종목약명
+
+    ISU_ENG_NM: str  # 영문 종목명
+
+    LIST_DD: str  # 상장일
+
+    MKT_TP_NM: str  # 시장구분
+
+    SECUGRP_NM: str  # 증권구분
+
+    SECT_TP_NM: str  # 소속부
+
+    KIND_STKCERT_TP_NM: str  # 주식종류
+
+    PARVAL: str  # 액면가
+
+    LIST_SHRS: str  # 상장주식수
+
+
+
+class EtfDailyRecord(TypedDict):
+    """ETF 일별 시세"""
+
+    BAS_DD: str  # 기준일자
+
+    ISU_CD: str  # 종목코드
+
+    ISU_NM: str  # 종목명
+
+    TDD_CLSPRC: str  # 종가
+
+    CMPPREVDD_PRC: str  # 대비 (전일 대비 변동)
+
+    FLUC_RT: str  # 등락률 (%)
+
+    TDD_OPNPRC: str  # 시가
+
+    TDD_HGPRC: str  # 고가
+
+    TDD_LWPRC: str  # 저가
+
+    ACC_TRDVOL: str  # 거래량
+
+    ACC_TRDVAL: str  # 거래대금
+
+    MKTCAP: str  # 시가총액
+
+    LIST_SHRS: str  # 상장주식수
+
+    NAV: str  # 순자산가치 (Net Asset Value)
+
+    IDX_IND_NM: str  # 기초지수명
+
+    OBJ_STKPRC_IDX: str  # 목적지수
+
+    CMPPREVDD_IDX: str  # 지수대비
+
+    FLUC_RT_IDX: str  # 지수등락률
+
+    INVSTASST_NETASST_TOTAMT: str  # 투자자산순자산총액
+
+
+
+class EtnDailyRecord(TypedDict):
+    """ETN 일별 시세"""
+
+    BAS_DD: str  # 기준일자
+
+    ISU_CD: str  # 종목코드
+
+    ISU_NM: str  # 종목명
+
+    TDD_CLSPRC: str  # 종가
+
+    CMPPREVDD_PRC: str  # 대비 (전일 대비 변동)
+
+    FLUC_RT: str  # 등락률 (%)
+
+    TDD_OPNPRC: str  # 시가
+
+    TDD_HGPRC: str  # 고가
+
+    TDD_LWPRC: str  # 저가
+
+    ACC_TRDVOL: str  # 거래량
+
+    ACC_TRDVAL: str  # 거래대금
+
+    MKTCAP: str  # 시가총액
+
+    LIST_SHRS: str  # 상장주식수
+
+    IDX_IND_NM: str  # 기초지수명
+
+    OBJ_STKPRC_IDX: str  # 목적지수
+
+    CMPPREVDD_IDX: str  # 지수대비
+
+    FLUC_RT_IDX: str  # 지수등락률
+
+    INDIC_VAL_AMT: str  # 지시가격금액
+
+    PER1SECU_INDIC_VAL: str  # 1증권당 지시가격
+
+
+
+class FuturesDailyRecord(TypedDict):
+    """선물 일별 시세"""
+
+    BAS_DD: str  # 기준일자
+
+    ISU_CD: str  # 종목코드
+
+    ISU_NM: str  # 종목명
+
+    PROD_NM: str  # 상품명
+
+    MKT_NM: str  # 시장구분
+
+    TDD_CLSPRC: str  # 종가
+
+    TDD_OPNPRC: str  # 시가
+
+    TDD_HGPRC: str  # 고가
+
+    TDD_LWPRC: str  # 저가
+
+    SETL_PRC: str  # 정산가격
+
+    SPOT_PRC: str  # 현물가격
+
+    CMPPREVDD_PRC: str  # 대비 (전일 대비 변동)
+
+    ACC_TRDVOL: str  # 거래량
+
+    ACC_TRDVAL: str  # 거래대금
+
+    ACC_OPNINT_QTY: str  # 미결제약정수량
+
+
+
+class OptionsDailyRecord(TypedDict):
+    """옵션 일별 시세"""
+
+    BAS_DD: str  # 기준일자
+
+    ISU_CD: str  # 종목코드
+
+    ISU_NM: str  # 종목명
+
+    PROD_NM: str  # 상품명
+
+    RGHT_TP_NM: str  # 권리구분 (콜/풋)
+
+    TDD_CLSPRC: str  # 종가
+
+    TDD_OPNPRC: str  # 시가
+
+    TDD_HGPRC: str  # 고가
+
+    TDD_LWPRC: str  # 저가
+
+    CMPPREVDD_PRC: str  # 대비 (전일 대비 변동)
+
+    ACC_TRDVOL: str  # 거래량
+
+    ACC_TRDVAL: str  # 거래대금
+
+    ACC_OPNINT_QTY: str  # 미결제약정수량
+
+    IMP_VOLT: str  # 내재변동성 (Implied Volatility)
+
+    NXTDD_BAS_PRC: str  # 익일기준가격
+
+
+
+class StockFuturesKosdaqDailyRecord(TypedDict):
+    """KOSDAQ 주식선물 일별 시세"""
+
+    BAS_DD: str  # 기준일자
+
+    PROD_NM: str  # 상품명
+
+    MKT_NM: str  # 시장구분
+
+    ISU_CD: str  # 종목코드
+
+    ISU_NM: str  # 종목명
+
+    TDD_CLSPRC: str  # 종가
+
+    CMPPREVDD_PRC: str  # 대비 (전일 대비 변동)
+
+    TDD_OPNPRC: str  # 시가
+
+    TDD_HGPRC: str  # 고가
+
+    TDD_LWPRC: str  # 저가
+
+    SPOT_PRC: str  # 현물가격
+
+    SETL_PRC: str  # 정산가격
+
+    ACC_TRDVOL: str  # 거래량
+
+    ACC_TRDVAL: str  # 거래대금
+
+    ACC_OPNINT_QTY: str  # 미결제약정수량
+
+
+
+class StockFuturesKospiDailyRecord(TypedDict):
+    """KOSPI 주식선물 일별 시세"""
+
+    BAS_DD: str  # 기준일자
+
+    PROD_NM: str  # 상품명
+
+    MKT_NM: str  # 시장구분
+
+    ISU_CD: str  # 종목코드
+
+    ISU_NM: str  # 종목명
+
+    TDD_CLSPRC: str  # 종가
+
+    CMPPREVDD_PRC: str  # 대비 (전일 대비 변동)
+
+    TDD_OPNPRC: str  # 시가
+
+    TDD_HGPRC: str  # 고가
+
+    TDD_LWPRC: str  # 저가
+
+    SPOT_PRC: str  # 현물가격
+
+    SETL_PRC: str  # 정산가격
+
+    ACC_TRDVOL: str  # 거래량
+
+    ACC_TRDVAL: str  # 거래대금
+
+    ACC_OPNINT_QTY: str  # 미결제약정수량
+
+
+
+class StockOptionsKosdaqDailyRecord(TypedDict):
+    """KOSDAQ 주식옵션 일별 시세"""
+
+    BAS_DD: str  # 기준일자
+
+    ISU_CD: str  # 종목코드
+
+    ISU_NM: str  # 종목명
+
+    PROD_NM: str  # 상품명
+
+    RGHT_TP_NM: str  # 권리구분 (콜/풋)
+
+    TDD_CLSPRC: str  # 종가
+
+    TDD_OPNPRC: str  # 시가
+
+    TDD_HGPRC: str  # 고가
+
+    TDD_LWPRC: str  # 저가
+
+    CMPPREVDD_PRC: str  # 대비 (전일 대비 변동)
+
+    ACC_TRDVOL: str  # 거래량
+
+    ACC_TRDVAL: str  # 거래대금
+
+    ACC_OPNINT_QTY: str  # 미결제약정수량
+
+    IMP_VOLT: str  # 내재변동성 (Implied Volatility)
+
+    NXTDD_BAS_PRC: str  # 익일기준가격
+
+
+
+class StockOptionsKospiDailyRecord(TypedDict):
+    """KOSPI 주식옵션 일별 시세"""
+
+    BAS_DD: str  # 기준일자
+
+    ISU_CD: str  # 종목코드
+
+    ISU_NM: str  # 종목명
+
+    PROD_NM: str  # 상품명
+
+    RGHT_TP_NM: str  # 권리구분 (콜/풋)
+
+    TDD_CLSPRC: str  # 종가
+
+    TDD_OPNPRC: str  # 시가
+
+    TDD_HGPRC: str  # 고가
+
+    TDD_LWPRC: str  # 저가
+
+    CMPPREVDD_PRC: str  # 대비 (전일 대비 변동)
+
+    ACC_TRDVOL: str  # 거래량
+
+    ACC_TRDVAL: str  # 거래대금
+
+    ACC_OPNINT_QTY: str  # 미결제약정수량
+
+    IMP_VOLT: str  # 내재변동성 (Implied Volatility)
+
+    NXTDD_BAS_PRC: str  # 익일기준가격
+
+
+

krxon-0.1.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "krxon"
+version = "0.1.0"
+description = "KRX (Korea Exchange) Open API Python SDK - auto-generated by krxon"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [
+    { name = "seungdols" },
+]
+keywords = ["krx", "korea-exchange", "finance", "api", "sdk"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Financial and Insurance Industry",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Office/Business :: Financial",
+]
+dependencies = [
+    "httpx>=0.24.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/seungdols/krxon"
+Repository = "https://github.com/seungdols/krxon"
+Issues = "https://github.com/seungdols/krxon/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["krx"]