深色模式

參考

資料集總覽

SDK 共 16 個資料集：15 個逐證券、1 個市場級（index.daily），另有證券清單 symbols。

證券共 2,660 檔：上市 1,193、上櫃 1,100、興櫃 367，以 board 欄位區分（main、tib、emerging）。

資料集
ID
內容
更新頻率
歷史起點
price.daily
個股每日的開高低收、成交量與成交金額。
每日
2019-01-02
chips.institutional
外資、投信、自營商每日的買賣超股數。
每日
2022-05-03
chips.margin
個股每日的融資買進、賣出、現償與餘額。
每日
2025-01-02
chips.shortBorrow
個股每日的融券與借券賣出、回補與餘額。
每日
2025-01-02
chips.dayTrade
個股每日的當沖成交量與買賣金額。
每日
2025-01-02
chips.foreignHolding
個股每日的外資及陸資持股股數與比率。
每日
2025-01-02
valuation.daily
個股每日的本益比、股價淨值比、殖利率與對應股利。
每日
2025-01-02
chips.shareDistribution
集保結算所每週公布的股權分散表，依 15 個持股級距列出人數與股數。
每週
2025-08-08
revenue.monthly
個股每月營收，含累計營收與月增、年增、累計年增率。
每月
2019-01
financials.ratios
個股每季與年度的獲利、償債、週轉等財務比率。
每季
2019 Q1
financials.statements
資產負債表、損益表與現金流量表，以科目路徑列出的長格式資料。
每季
2019（回補中，以 `historyStart` 為準）
corporate.dividends
個股各期的股利分派，含現金股利、股票股利與決議進度。
事件
2019
corporate.exRights
個股的除權息事件與參考價。
事件
2019
alerts
注意股、處置股與鉅額交易的公告，以 `kind` 區分類別。
事件
2025-01-02
company.profile
公司的基本資料與董監事、經理人名單，每檔證券一份快照。
快照
快照
index.daily
加權指數與櫃買指數的每日開高低收，key 為 `TAIEX` 或 `TPEX`。
每日
TAIEX 2019-04-03；TPEX 2020-05-07

通則

  • 金額為新台幣元；量一律為「股」；比率為小數（0.0123 即 1.23%，欄名以 Rate 結尾）；日期為台北時區 YYYY-MM-DD。
  • 時間序列為欄式陣列、舊到新；缺值為 null，不補 0。
  • 週 K、月 K 由 SDK 從日 K 聚合，API 不提供。

使用陷阱

  • 各資料集起點不同：三大法人只有 2022-05-03 之後，籌碼與估值多為 2025 起。
  • 興櫃證券沒有日 K，manifest 不含 price.daily；其餘資料集照常。
  • ETF 尚未支援。securityType 目前一律為 stock，不能靠它過濾 ETF。
  • 日 K 停牌列的 OHLC 全為 null，但 volumeShares 可能非 0；K 線圖不畫這些列，表格仍列出。
  • chips.margin 不含融券，融券請看 chips.shortBorrow。
  • 財務比率、月營收、集保的 0 可能代表來源缺值；財務比率僅在同期別有財報時會還原為 null。
  • 除權息的 cashDividendTwd 只有上櫃有值，上市現金股利請看 corporate.dividends。
  • 指數的 change、changeRate 由我們以前一交易日收盤重算，非官方值。
  • manifest 的 datasets 可能缺少某個資料集（權限、停用、來源未就緒或該證券沒有資料），缺席不是錯誤。