Metadata-Version: 2.4
Name: pykiwoomapi
Version: 0.1.0
Summary: Python wrapper for Kiwoom Open API+ (Korea Stock Market)
Author-email: Jason Lee <warvirus1004@gmail.com>
Maintainer-email: Jason Lee <warvirus1004@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/warvirus/pykiwoomapi
Project-URL: Documentation, https://github.com/warvirus/pykiwoomapi#readme
Project-URL: Repository, https://github.com/warvirus/pykiwoomapi
Project-URL: Issues, https://github.com/warvirus/pykiwoomapi/issues
Keywords: kiwoom,korean-stock,stock-api,Korea-Stock-Market,Kiwoom-OpenAPI
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.28.0
Requires-Dist: websockets>=10.0
Requires-Dist: pandas>=1.5.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
Requires-Dist: pytest-cov>=4.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: mypy>=1.0; extra == "dev"
Dynamic: license-file

# pykiwoomapi

Python wrapper for **Kiwoom Open API+** (Korea Stock Market).

## Installation

```bash
pip install pykiwoomapi
```

For development:
```bash
pip install -e .
pip install -e ".[dev]"
```

## Quick Start

```python
from pykiwoomapi import Auth, KiwoomClient

# Create auth object (mock=True for demo account)
auth = Auth(mock=True)
auth.login("YOUR_APP_KEY", "YOUR_SECRET_KEY")

# Create API client
client = KiwoomClient(auth)

# Request stock basic info (Samsung Electronics)
result = client.read("주식기본정보요청", stk_cd="005930")
print(result)
```

## Features

- **180+ API endpoints** covering Korean stock market data
- **REST API** - Query stock info, account, rankings, charts, themes, ETFs, ELWs
- **WebSocket** - Real-time market data streaming
- **Account** - Balance, profit/loss, orders (buy/sell/modify/cancel)
- **Mock mode** - Test with demo account without real trading

## Environment

| Environment | Base URL |
|-------------|----------|
| Mock (Demo) | `https://mockapi.kiwoom.com` |
| Production | `https://api.kiwoom.com` |
| Rest API | `https://openapi.kiwoom.com/guide/apiguide` |

## License

MIT License
