Metadata-Version: 2.4
Name: openstockapi
Version: 0.1.0
Summary: Vietnam stock market data library — open source data plane
Author-email: Your Name <your.email@example.com>
License: Apache-2.0
Classifier: License :: OSI Approved :: Apache Software 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: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: httpx>=0.27
Requires-Dist: pydantic>=2.0
Provides-Extra: pandas
Requires-Dist: pandas>=2.0; extra == "pandas"
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-asyncio; extra == "dev"
Requires-Dist: mypy; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Dynamic: license-file

# OpenStockAPI

An open-source Python library serving as a modular **Data Plane** to collect and normalize Vietnam stock market data.

## Features

- **Multi-source Providers**: Abstracted design supporting multiple sources (DNSE, MAS, VCI, VNDIRECT, etc.) with automatic fallback.
- **Freemium Tier Model**: Supports Free, Pro (200 req/min), and Premium (500 req/min) tiers with local rate limiting.
- **Control Plane Ready**: Built-in hooks to integrate with a license/heartbeat server.

## Installation

```bash
pip install -e .
```

## License

Apache License 2.0
