Metadata-Version: 2.5
Name: twmarket
Version: 0.1.0
Summary: Python data library for Taiwan securities, futures, and options
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: httpx<1,>=0.28
Requires-Dist: lxml<7,>=5.3
Requires-Dist: orjson<4,>=3.10
Provides-Extra: pandas
Requires-Dist: pandas<4,>=2.2; extra == 'pandas'
Provides-Extra: polars
Requires-Dist: polars<2,>=1.0; extra == 'polars'
Provides-Extra: stream
Requires-Dist: websockets<17,>=15; extra == 'stream'
Description-Content-Type: text/markdown

<div align="center">
  <h1>twmarket</h1>
  <p>
    <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.11%2B-3776AB?style=flat&amp;logo=python&amp;logoColor=white" alt="Python 3.11+" /></a>
    <a href="https://github.com/cmostw/twmarket/actions/workflows/tests.yml"><img src="https://img.shields.io/badge/coverage-91.63%25-brightgreen?style=flat" alt="Coverage 91.63%" /></a>
    <a href="https://github.com/cmostw/twmarket/issues"><img src="https://img.shields.io/github/issues/cmostw/twmarket?style=flat" alt="Issues" /></a>
    <a href="https://github.com/cmostw/twmarket/stargazers"><img src="https://img.shields.io/github/stars/cmostw/twmarket?style=flat" alt="Stars" /></a>
  </p>
  <p><strong>繁體中文</strong> &middot; <a href="README.en.md">English</a></p>
  <p>台灣證券、期貨、選擇權、公司財務與總體資料的同步及非同步查詢。</p>
</div>

<h2>安裝</h2>

<p>需要 Python 3.11+。</p>

<pre><code class="language-sh">pip install twmarket
uv add twmarket
# 可用延伸: stream, pandas, polars
</code></pre>

<h2>文件</h2>

<ul>
  <li><a href="https://twmarket.cmos.tw/docs/">開始使用</a></li>
  <li><a href="https://twmarket.cmos.tw/docs/reference/data-contracts/">API 參考</a></li>
  <li><a href="https://twmarket.cmos.tw/docs/how-to/development/">開發</a></li>
</ul>

<h2>授權</h2>

<p><a href="LICENSE">MIT</a></p>
