第一次查詢
安裝 twmarket，查詢股票、興櫃、衍生商品、公司資料與總體資料。
本節包含安裝、第一筆股票查詢與各資料來源的查詢入口。需要 Python 3.11 以上與網路連線。
安裝
依套件管理工具選擇安裝指令：
pip install twmarket
# 可用延伸：stream、pandas、polarsuv add twmarket
# 可用延伸：stream、pandas、polars查詢股票
將以下程式存成 query.py，執行 python query.py：
from datetime import date
from twmarket import Client
with Client() as market:
rows = market.twse.history(
"2330", start=date(2026, 9, 1), end=date(2026, 9, 30)
)
for row in rows:
print(row)回傳結果為每日行情模型的清單；沒有交易資料的日期不會產生一列。輸出數值依來源而變，價格使用 Decimal，缺值為 None。with 區塊結束時會關閉連線。
選擇其他資料
下列程式查詢各來源的資料。每項查詢都會連線至對應來源；來源無資料時可能回傳空清單或拋出例外，見 API 參考。
from datetime import date
from twmarket import Client
with Client() as market:
print("上櫃證券", len(market.tpex.instruments()))
print("興櫃證券", len(market.esb.instruments()))
print("期貨與選擇權商品", len(market.taifex.products()))
print("月營收", market.mops.revenue("2330", year=2026, month=8))
print("股權分布", len(market.tdcc.distribution("2330")))
print("製造業與服務業採購經理人指數", len(market.ndc.pmi(start=date(2026, 1, 1), end=date(2026, 9, 30))))
print("匯率", len(market.cbc.exchange_rates(start=date(2026, 9, 1), end=date(2026, 9, 30))))繼續閱讀 查詢操作，或在 資料契約 選擇需要的方法、單位與可查期間。