架構

套件採 modular monolith：單一套件及發行流程，內部按資料來源分組。

依賴方向為 Client → providers → transport / parsing / models， integrations → models。模型使用不可變 dataclass；回傳集合為 list。

同步與非同步介面共用解析與請求規格，各自使用 httpx 連線池。 查詢才發出網路請求，建構 client 與匯入套件不連網。 所有請求有逾時；各 host 分別限速。重試限於可安全重送的查詢，並遵守 Retry-After。

來源、schema 與網路錯誤使用不同例外。多筆查詢無資料回傳空清單， 單筆查無資料拋出 NoDataError。批次查詢保留逐筆成功或錯誤。

各來源 provider 管理資料取得與解析，transport 管理請求及連線。 報價更新與快照的關係見 報價、快照與串流。 快取與資料轉換設定見 API 功能。