跳轉到

更新公告

2026-09-20

  • 資料校正公告：期貨交易明細 TaiwanFuturesTick、期貨分K TaiwanFuturesKBar：2018 年部分交易日逐筆資料缺漏，已依交易所原始資料重建。以下日期已重新產製並驗證，曾下載或查詢過這些日期的使用者請重新取得資料
    • 影響日期（共 70 個交易日）：2018-03-23、2018-03-26、2018-03-27、2018-04-03、2018-04-09、2018-04-13、2018-04-16、2018-04-23、2018-04-30、2018-05-02、2018-05-07、2018-05-11、2018-05-14、2018-05-21、2018-05-25、2018-05-28、2018-06-01、2018-06-04、2018-06-11、2018-06-19、2018-06-22、2018-06-25、2018-06-29、2018-07-02、2018-07-09、2018-07-16、2018-07-23、2018-07-30、2018-08-03、2018-08-06、2018-08-07、2018-08-10、2018-08-13、2018-08-17、2018-08-20、2018-08-24、2018-08-27、2018-08-28、2018-09-03、2018-09-07、2018-09-10、2018-09-14、2018-09-17、2018-09-25、2018-09-28、2018-10-01、2018-10-05、2018-10-08、2018-10-11、2018-10-15、2018-10-19、2018-10-22、2018-10-26、2018-10-29、2018-11-02、2018-11-05、2018-11-09、2018-11-12、2018-11-16、2018-11-19、2018-11-23、2018-11-26、2018-11-27、2018-11-30、2018-12-03、2018-12-04、2018-12-07、2018-12-10、2018-12-14、2018-12-17
    • 問題：這些日期有部分成交未收錄，主要集中在週一（週末後第一個交易日）日盤開盤後的前幾秒；以臺股期貨 TX 為例，42 個交易日共缺 29,909 筆
    • 已逐日比對筆數與成交量後上線；2018 全年臺股期貨 TX 逐筆資料亦已與交易所原始資料逐列比對，完全一致
  • 資料校正公告：個股三大法人買賣表 TaiwanStockInstitutionalInvestorsBuySell、個股三大法人買賣表（寬表）TaiwanStockInstitutionalInvestorsBuySellWide：上櫃 2017-12-18 ~ 2018-01-12（19 個交易日）的 Foreign_Dealer_Self（外資自營商）有誤，已修正。曾下載或查詢過這段期間上櫃資料的使用者請重新取得資料
    • 問題：上櫃當時尚未單獨揭露外資自營商（2018-01-15 起才拆分），但此期間約 380 檔上櫃股票的 Foreign_Dealer_Self 被誤植為與 Foreign_Investor 相同的數值，加總各法人別時外資會被重複計算
    • 修正後此期間上櫃的 Foreign_Dealer_Self 買進／賣出皆為 0；另 2018-01-12 有 7 檔上櫃股票的投信買賣股數一併校正為官方數值
    • 已逐日比對官方公告；上市股票及其他期間不受影響
  • 資料校正公告：颱風全日停市日出現與次一交易日盤後時段完全相同的重複資料，已全數移除。曾下載或查詢過這些日期的使用者請重新取得資料
  • 資料校正公告：期貨交易明細 TaiwanFuturesTick、期貨分K TaiwanFuturesKBar：2024-04-26 少 3 筆成交，已重新產製並驗證。曾下載或查詢過該日的使用者請重新取得資料
    • 問題：臺股期貨 TX 202405 於 15:07:30 少 3 筆（價格 20163、數量 2），整日由 127,504 筆補回 127,507 筆，與交易所原始資料一致
    • 分K 連帶更正：該日 15:07 這一分鐘的成交量由 490 更正為 496，TX 202405 整日成交量 389,496
    • 其餘日期已抽驗逐筆與分K 的成交量對帳，無同類問題

2026-09-19

2026-09-17

  • 資料校正公告：期貨交易明細 TaiwanFuturesTick、期貨分K TaiwanFuturesKBar：2017-05 ~ 2018-03 部分夜盤資料重複，已修正。以下日期已重新產製並驗證，曾下載或查詢過這些日期的使用者請重新取得資料
    • 影響日期（共 43 個日曆日，皆為只含夜盤尾段 00:00～05:00 的週六及休市日）：2017-05-20、2017-05-27、2017-06-10、2017-06-17、2017-06-24、2017-07-01、2017-07-08、2017-07-15、2017-07-22、2017-07-29、2017-08-05、2017-08-12、2017-08-19、2017-08-26、2017-09-02、2017-09-09、2017-09-16、2017-09-23、2017-10-04、2017-10-07、2017-10-14、2017-10-21、2017-10-28、2017-11-04、2017-11-11、2017-11-18、2017-11-25、2017-12-02、2017-12-09、2017-12-16、2017-12-23、2017-12-30、2018-01-06、2018-01-13、2018-01-20、2018-01-27、2018-02-03、2018-02-10、2018-02-24、2018-02-28、2018-03-03、2018-03-10、2018-03-17
    • 問題：這些日期的每一筆逐筆資料都被重複寫入一份，重複的那份成交時間錯位成 00:HH:MM（例如 01:23:45 變成 00:01:23），全部擠在 00:00～00:04，使該段夜盤成交量變成 2 倍；期貨分K 同日期 00:00～00:04 的成交量也因此偏高
    • 夜盤歸屬下一個交易日，所以實際受影響的是這些日期之後第一個交易日的夜盤，例如 2018-02-10 的資料屬於 2018-02-12 的夜盤
    • 已移除重複列，逐日比對筆數與成交量後上線；2018-03-24 之後的日期，以及同期間的一般交易日，都沒有這個問題

2026-09-13

  • 新增 期貨分K TaiwanFuturesKBar: 資料區間 2011-01-03 ~ now
  • 期貨交易明細 TaiwanFuturesTick、選擇權交易明細 TaiwanOptionTick：歷史資料補齊，以下日期已重新產製並驗證，曾下載或查詢過這些日期的使用者請重新取得資料
    • TaiwanFuturesTick 2019-04-19 ~ 2019-05-13（共 20 個日曆日）：補回 16 個匯率、黃金與海外指數期貨商品（GDF、NZF、OAF、OBF、OCF、OJF、OKF、OOF、RHF、RTF、TGF、TJF、XAF、XBF、XEF、XJF）整段缺漏的逐筆資料；同區間其他商品不受影響
    • TaiwanFuturesTick 2014-03-19：整日逐筆資料（235 個商品）已補齊。此日先前公告為無法補齊，現已取得完整資料並完成驗證，2026-09-02 該則公告同步更正
    • TaiwanOptionTick 2019-01-15 ~ 2019-06-28（共 129 個日曆日、105 個交易日）：此區間先前在資料集說明標示為「缺少部分資料，不完整」，現已補齊完整，該但書同步移除
    • 三段皆逐日、逐商品比對筆數與成交量後才上線

2026-09-06

  • 資料校正公告：以下資料集已完成資料校正並上線；若您先前曾查詢或下載過相關期別／日期的資料，請重新取得
    • 資產負債表 TaiwanStockBalanceSheet：2024-06-30（113 年半年報）單一期別資料缺漏，已完成回補，該期別涵蓋家數由 1,917 家增為 2,233 家（補回 316 家）；已逐季檢查 2014 ~ 2025 各期別，未再發現同規模的缺漏
    • 除權除息結果表 TaiwanStockDividendResult：2026-09-02 上市 (TWSE) 資料當日一度僅有部分公司，已補齊為當日全部 20 家
      • 原因：當日有除權個股的權值加息值超過 1,000、數值帶千分位符號，導致該日整批資料寫入失敗；解析方式已修正，往後不會再發生

2026-09-02

  • 資料校正公告：期貨交易明細 TaiwanFuturesTick、選擇權交易明細 TaiwanOptionTick：夜盤逐筆資料校正，以下日期已重新產製並驗證，曾下載或查詢過這些日期的使用者請重新取得資料
    • TaiwanFuturesTick：2026-08-14、2019-04-19、2019-05-17、2019-06-21、2019-07-01、2019-07-03、2019-07-11（以上皆補回 15:00～24:00 夜盤）、2020-02-01（週六檔移除重複列）
    • TaiwanOptionTick：2026-08-14（補回 15:00～24:00 夜盤）
    • 2026-08-14 的原因：每個交易日的夜盤（當天 15:00 起至隔天 05:00）依規則歸屬於下一個交易日，資料要到下一個交易日才會完整；但當天的整日檔會在當晚先行產出，再由隔天的例行作業補上夜盤。08-14 那個週末因週六檔案提前產出，例行補產被跳過，週五整日檔便停留在沒有夜盤的版本；由於逾 14 天的歷史日改由整日檔提供查詢，此問題於 08-28 起才顯現。這是單一週末的特殊情況——2017-05 夜盤上線以來的其他交易日已逐日全量比對，均無此問題；產檔邏輯已修正，不再依賴隔日例行作業
    • 2019 年 6 天的原因：當年歷史回補漏掉週五夜盤的前半段，本次已補齊並驗證
    • 2011～2018 逐日檢查：僅 2014-03-19 整日逐筆資料缺漏（2026-09-13 更正：該日資料已取得並補齊，詳見上方公告）

2026-09-01

2026-08-20

  • 台股分 K 資料表 TaiwanStockKBar 新增加權指數分 K：data_id 帶 TAIEX 即可查詢，資料區間 2005-01-03 ~ now（比個股分 K 的 2019-01-01 更長），每個交易日 271 筆、涵蓋 09:00 ~ 13:30 每分鐘一筆
    • 指數本身沒有成交量，volume 固定為 0；open / high / low / close 為該分鐘內的指數值

2026-08-09

  • 台股選擇權即時資訊 taiwan_options_snapshot 增開臺指選擇權週五到期契約：data_id 新增 TXU、TXV、TXX、TXY、TXZ（當月第 1 ~ 5 個星期五到期）。原有的 TXO（月選）與 TX1 ~ TX5（週三到期）不受影響
    • 部分代碼在特定月份查無資料屬正常現象（契約尚未掛牌，或該月不存在對應週次，例如某月只有 4 個星期五）
  • 新增 個股融資維持率 TaiwanStockMarginMaintenance：資料區間 2001-01-05 ~ now（上櫃自 2007-01-04 起）。提供個股每日融資維持率(%)、融資成本線、融資餘額（張）與計算採用的融資成數；本資料集為估算指標（公開資訊未揭露個股層級的融資金額），與其他服務的數字不會一致，詳見文件說明

2026-08-08

  • 新增 資產交換固定收益日成交資訊 TaiwanAssetSwapFixedIncomeDaily：資產交換（Asset Swap）固定收益端的每日成交統計，欄位含名目本金 notional_amount、成交筆數 number_of_transactions、最低／最高／平均利率 rate_lowest／rate_highest／rate_average、合約年期 contract_term_years；資料區間 2011-05-03 ~ now
  • 新增 資產交換選擇權日成交資訊 TaiwanAssetSwapOptionDaily：資產交換選擇權端的每日成交統計，欄位含名目本金 notional_amount、成交筆數 number_of_transactions、最低／最高／平均權利金 premium_lowest／premium_highest／premium_average、合約年期 contract_term_years；資料區間 2011-05-03 ~ now
    • ⚠ 這兩個資料集的 data_id（stock_id）為可轉債代號（例 17172），不是普通股代號；帶普通股代號（例 2330）會查不到資料

2026-08-03

  • 服務狀態與可用率 ServiceStatus 可用率演算法調整：改以請求數計算（可用率 % = 成功請求 ÷ 有效請求 × 100），不再以「未中斷的分鐘數佔比」衡量；24 小時、90 天與當月數字皆為該區間內請求數加總後計算，錯誤比例會等比反映在可用率上
    • 狀態分級門檻同步調整為 Operational ≥ 99.5%、Elevated Error Rates 95%～99.5%、Partial Outage 80%～95%、Major Outage < 80%（原 Degraded Performance 更名為 Elevated Error Rates）

2026-07-29

2026-07-23

2026-07-21

2026-07-13

2026-07-12

  • 新增 免責聲明與資料授權說明 頁面：說明 FinMind 之資料來源與授權依據（經政府資料開放平臺取得之資料，依《政府資料開放授權條款》使用）、使用者取得之授權範圍（本服務之使用權，不含對外再散布／轉售／鏡像），以及資料僅供參考等免責事項

2026-07-01

2026-06-15

2026-06-13

  • 新增 個股三大法人買賣表（寬表）TaiwanStockInstitutionalInvestorsBuySellWide：與 TaiwanStockInstitutionalInvestorsBuySell 相同資料，改為寬表（橫式），每個交易日一列、各法人別買賣攤平成獨立欄位（外資、外資自營商、投信、自營商及其自行買賣／避險），免自行轉置。欄位涵蓋所有歷史法人別分類，尚未存在的年代該欄為 0（自營商於 2014-12-01 由合併拆為自行買賣／避險、外資自營商於 2018-01-15 起提供）；資料區間 2005-01-01 ~ now
  • FinMind Python 套件新增支援 Python 3.12（持續支援 Python 3.8–3.11）。本版起套件相依升級為 pandas>=2.0、ta>=0.11（numpy、pydantic 維持不變）。
    • 呼叫 FinMind 的程式碼無需修改：DataLoader、策略 (Strategy)、繪圖等對外介面皆不變。
    • ⚠ 升級須知：安裝／升級會一併將環境中的 pandas 升至 2.x、ta 升至 0.11。若你其餘自有程式碼仍使用 pandas 1.x 在 2.0 已移除的寫法，需自行調整，常見如：df.append() → pd.concat([...])、df.to_dict("r") → df.to_dict("records")、df.iteritems() → df.items()。若暫時無法調整，可先固定安裝舊版 FinMind。

2026-06-09

  • 新增 期貨價差每筆成交資料 TaiwanFuturesSpreadTick（只限 sponsor 會員）：提供期貨價差（近月/遠月）每筆成交，含到期月份、成交時間、價差成交價、成交量、近月價格、遠月價格、是否價差對價差成交；單次請求只提供一天資料，資料自 2026-04-27 起逐交易日累積（暫不含更早歷史回補）

2026-06-05

2026-06-03

2026-05-23

2026-05-22

2026-05-19

2026-05-06

2026-05-05

2026-05-02

  • 新增「更新 Token」功能：可在使用者資訊頁面自主重置 Token，舊 Token 立即失效，無需聯繫客服

2026-04-30

2026-04-28

2026-04-19

2026-04-17

2026-04-12

2026-04-03

  • 新增 async 批次查詢範例

2026-03-28

2026-03-26

  • 修正股權持股分級表資料區間誤植

2026-03-21

  • Agent Skill 新增 Claude Code、Cursor、Windsurf、Gemini 多工具安裝說明與範例截圖
  • 更新 聯絡方式：Gitter 改為 Facebook 社團與粉絲專頁

2026-03-20

  • 新增 Agent Skill 文件，可在 Claude Code 等工具中透過 skill 快速查詢 FinMind 資料

2026-03-10

  • 新增 llms.txt 與 llms-full.txt，讓 AI 工具更快速理解 FinMind 文件
  • 新增 TaiwanStockPriceTick object method 文件
  • 首頁新增 LLM / AI 整合區塊

2026-03-06

2026-02-22

  • 更新期貨及選擇權即時資訊文件，補充支援代碼及空值取得全部說明

2026-02-07

2026-02-01

2026-01-31

2026-01-24

2026-01-23

  • 文件新增英文翻譯

2026-01-22

  • 更新 taiwan_options_snapshot 文件

2026-01-18

  • 移除 API URL query 中的 token 參數，改由 header 傳遞

2026-01-04

  • 移除 login 函式，登入僅支援 login_by_token

2025-12-15

  • 強化 tick data async 使用文件

2025-10-06

2025-09-21

2025-09-11

  • FinMind package 新增 async 批次查詢功能

2025-08-31

2025-08-13

  • 新增暫停先賣後買標記、修正期貨、選擇權三大法人文件

2025-07-20

2025-05-25

2025-05-11

2025-05-10

2025-04-06

2025-02-09

2025-01-05

  • TaiwanStockConvertibleBond、CnnFearGreedIndex、Futures/OptionOpenInterestLargeTraders、Futures/OptionInstitutionalInvestorsAfterHours、TaiwanStockHoldingSharesPer 開放 backer 會員使用

2024-12-23

  • FinMind package 新增 async 批次查詢功能

2024-12-07

2024-12-01

2024-11-17

2024-10-12

2024-09-28

2024-09-26

2024-08-25

2024-07-14

2024-05-28

2024-05-19

2024-05-08

  • 移除匯率資料源

2024-04-18

2024-04-01

  • 可轉債 系列資料集新增 FinMind package 範例

2024-03-24

2024-03-19

2024-01-27

  • 全市場資料集補上欄位 schema 說明文件

2021-10-06

  • release FinMind package 1.5.3，處理 connect error 問題
  • 增加 FinMind package 文件

2021-08-01

  • 由於資料源問題，移除即時報價

2021-05-23

2021-03-18

2021-02-22

  • 新增 streaming_all_data 參數，可拿取即時資料(tick)，開盤到當下所有 data。

2021-01-26

2021-01-25

  • web 正式上線，包含策略分析、回測功能，分析全市場股票勝率，降低生存者偏差。
  • 開始下一階段 web 開發。

2021-01-18

  • 新增期貨、選擇權三大法人買賣
  • 新增期貨、選擇權各卷商日交易資訊
  • web 回測、策略分析功能，預計近期上線。可針對特定策略，分析全市場股票勝率，降低生存者偏差。
  • api v4 上線，可一次拿取特定日期，所有股價、三大法人、融資券等資訊，方便使用者進行每日更新時，只需要發少量 request。

2020-12-25

2020-10-06

  • 預計改用時間序列資料庫，增加 api 效率。
  • 進行回測功能開發。
  • web 開發 data 下載功能，由於大多數人，使用 excel 進行金融分析，因此開發 web 下載 excel data 功能。

2020-05-06

2020-05-01

2020-04-24

2020-04-15

2019-10-23

  • 新增 TotalMarginPurchaseShortSale 當天總體融資融券買賣
  • 新增 TaiwanStockNews 台股相關新聞

2019-10-10

  • 新增 TaiwanFutures 台股期貨交易明細
  • 新增 TaiwanOption 台股選擇權交易明細

FinMind 1.0.80 (2019-07-15)

  • 重大更新，過去是直接連 DataBase，目前改走 api 方式，未來舊版 package 將會失效，無法直接連 DataBase。請更新到最新版本，或是直接走 api。

FinMind 1.0.70 (2019-06-23)

  • add api

  • add function Mind.MoveAverage,
    e.g :

    Mind.MoveAverage(_2330.StockPrice,days = 5,variable = 'close')

  • add function Mind.RSV,
    e.g :

    Mind.RSV(_2330.StockPrice,days = 5)

  • add function Mind.BIAS,
    e.g :

    Mind.BIAS(_2330.StockPrice,days = 5)

FinMind 1.0.60 (2019-05-24)

  • New data TaiwanStockMonthRevenue
    from FinMind.Data import Load
TaiwanStockMonthRevenue = Load.FinData(
    dataset = 'TaiwanStockMonthRevenue',
    select = '2330',
    date = '2018-01-01')
    • Market index:
    • TSEC weighted index ( Taiwan weighted index ) : stock_id - ^TWII
    • SP500 : stock_id - ^GSPC
    • Dow Jones Industrial Average : stock_id - ^DJI

FinMind 1.0.57 (2019-04-28)

  • Change taiwan stock id, delete TWO and TW. ( eg. 2330.TW -> 2330 )

FinMind 1.0.54 (2019-04-13)

  • Optimize speeds of loading TaiwanStockPrice, USStockPrice
  • Add DataSource

FinMind 1.0.53 (2019-04-07)

Fix FinMind.Data.Load
  • optimize speeds of loading data , ex :
    from FinMind.Data import Load
import datetime

TaiwanStockInfo = Load.FinData(dataset = 'TaiwanStockInfo')
s = datetime.datetime.now()
TaiwanStockFinancialStatements = Load.FinData(dataset = 'FinancialStatements',select = list(TaiwanStockInfo['stock_id']),date = '2018-12-01')
t = datetime.datetime.now() - s
print(t)
0:00:01.861724

FinMind 1.0.52 (2019-04-06)

New Data
  • BalanceSheet ( Taiwan 資產負債表 )
  • TaiwanStockHoldingSharesPer ( Taiwan 股權分散表 )
  • Shareholding ( Taiwan 個股外資持股 )
  • RawMaterialFuturesPrices ( 美國原物料期貨 )

New Function

2018/8/5

  1. 央行利率 100% ( 13 Countrys, Contains G8 )
      FED Federal Reserve System 美國
  ECB European Central Bank 歐洲
  BOE Bank of England 英國
  SNB Swiss National Bank 瑞士
  RBA Reserve Bank of Australia 澳洲
  BOC Bank of Canada 加拿大
  RBNZ Reserve Bank of New Zealand 紐西蘭
  BOJ Bank of Japan 日本
  CBR The Central Bank of the Russian Federation 俄羅斯
  RBI Reserve Bank of India 印度
  PBOC People's Bank of China  中國
  BCB Banco Central do Brasil 巴西
    1. Gold Price 100%
    2. Government bond ->>> https://data.oecd.org/interest/long-term-interest-rates.htm
    3. 期貨 ->>> https://www.investing.com/commodities/energies
    4. S&P 500指數，並爬取該 500 家股票股價 ->>>

2018/7/5

  1. 國際油價 讀取範例 Load data example. (100%)
  2. 各國匯率 ( 53 Countrys, Contains G8 ) (100%)

2018/7/2 未來爬蟲順序

  1. 央行利率 from https://tradingeconomics.com/search.aspx?q=Interest%20Rate
  2. Inflation (通貨膨脹) monthly from https://tradingeconomics.com/russia/inflation-cpi
  3. Consumer Price Index (CPI) monthly from https://tradingeconomics.com/russia/consumer-price-index-cpi
  4. Output Gap monthly from https://tradingeconomics.com/russia/gdp-deflator
  5. S&P 500 from yahoo finance
  6. 黃金價格 from https://www.gold.org/data/gold-price