Skip to content

What's New

2026-09-20

  • Data correction notice: Futures tick TaiwanFuturesTick, Futures Minute KBar TaiwanFuturesKBar: some 2018 trading days were missing part of their tick data and have been rebuilt from the exchange's original data. The dates below were regenerated and verified; if you downloaded or queried them before, please fetch the data again
    • Affected dates (70 trading days): 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
    • Issue: some trades on these dates were not recorded, mostly in the first few seconds after the day session opened on Mondays (the first trading day after a weekend). For TAIEX Futures (TX), 42 trading days were missing 29,909 rows in total
    • Every date was verified on both row counts and traded volume before going live; the full-year 2018 TX tick data has also been compared row by row against the exchange's original data and matches exactly
  • Data correction notice: Institutional Investors Buy/Sell TaiwanStockInstitutionalInvestorsBuySell, Institutional Investors Buy/Sell (Wide) TaiwanStockInstitutionalInvestorsBuySellWide: Foreign_Dealer_Self (foreign dealer self) for TPEx stocks between 2017-12-18 and 2018-01-12 (19 trading days) was wrong and has been fixed. If you downloaded or queried TPEx data for this period before, please fetch it again
    • Issue: TPEx did not report foreign dealer self separately at the time (it was split out from 2018-01-15), but for about 380 TPEx stocks in this period Foreign_Dealer_Self had been filled with the same values as Foreign_Investor, so summing all categories double-counted foreign investors
    • After the fix, Foreign_Dealer_Self buy/sell for TPEx stocks in this period are 0; in addition, the investment trust buy/sell shares of 7 TPEx stocks on 2018-01-12 were corrected to the official figures
    • Verified day by day against the official data; TWSE stocks and other periods are not affected
  • Data correction notice: on days when the market was closed all day for a typhoon, rows identical to the next trading day's after-hours session were present and have now been removed. If you downloaded or queried any of these dates, please fetch the data again
  • Data correction notice: Futures Trading Detail TaiwanFuturesTick, Futures Minute KBar TaiwanFuturesKBar: 3 trades were missing on 2024-04-26; regenerated and verified. If you downloaded or queried that date, please fetch the data again
    • Issue: TX 202405 was missing 3 trades at 15:07:30 (price 20163, volume 2); the whole day went from 127,504 back to 127,507 rows, matching the exchange's raw data
    • Minute K-bar corrected accordingly: volume for the 15:07 minute went from 490 to 496; TX 202405 whole-day volume is 389,496
    • Other dates were spot-checked by reconciling tick volume against minute K-bar volume; no similar issue found

2026-09-19

  • Futures Minute KBar TaiwanFuturesKBar now supports storage_objects whole-day bulk download (sponsorpro members only); historical data is also available for download
  • Futures tick TaiwanFuturesTick, Options tick TaiwanOptionTick and Futures Minute KBar TaiwanFuturesKBar require data_id; to fetch a whole day's data at once, use storage_objects bulk download
  • Data correction notice (supplement to 2026-09-17): Futures tick TaiwanFuturesTick, Futures Minute KBar TaiwanFuturesKBar: 2018-02-13 had the same duplicated after-hours data as described in the 2026-09-17 notice but was not included in that fix; it has now been fixed. This date was regenerated and verified; if you downloaded or queried it before, please fetch the data again
    • 2018-02-13 was a market holiday before the Lunar New Year (containing only the tail of the after-hours session, 00:00-05:00); the session belongs to the first trading day after the holiday, 2018-02-21
    • All dates from 2017-05 to 2018-03 were re-checked; apart from the 43 calendar days listed on 2026-09-17 and 2018-02-13, no other date has this issue

2026-09-17

  • Data correction notice: Futures tick TaiwanFuturesTick, Futures Minute KBar TaiwanFuturesKBar: duplicated after-hours data between 2017-05 and 2018-03 has been fixed. The dates below were regenerated and verified; if you downloaded or queried them before, please fetch the data again
    • Affected dates (43 calendar days, all Saturdays or market holidays that contain only the tail of the after-hours session, 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
    • Issue: every tick row on these dates had been written twice. In the duplicate copy the trade time was shifted to 00:HH:MM (e.g. 01:23:45 became 00:01:23), so all duplicates piled up in 00:00-00:04 and the volume of that after-hours segment was doubled. The TaiwanFuturesKBar volume for 00:00-00:04 on the same dates was inflated as a result
    • The after-hours session belongs to the next trading day, so what is actually affected is the after-hours session of the first trading day after each date; for example, the 2018-02-10 data belongs to the after-hours session of 2018-02-12
    • The duplicate rows have been removed and every date was verified on both row counts and traded volume before going live. Dates from 2018-03-24 onward, and regular trading days in the same period, are not affected

2026-09-13

  • Added Futures Minute KBar TaiwanFuturesKBar: Data range 2011-01-03 ~ now
  • Futures tick TaiwanFuturesTick, Options tick TaiwanOptionTick: historical gaps have been backfilled. The dates below were regenerated and verified; if you downloaded or queried them before, please fetch the data again
    • TaiwanFuturesTick 2019-04-19 ~ 2019-05-13 (20 calendar days): restored the entire missing tick history for 16 FX, gold and overseas-index futures products (GDF, NZF, OAF, OBF, OCF, OJF, OKF, OOF, RHF, RTF, TGF, TJF, XAF, XBF, XEF, XJF). Other products in the same period are unaffected
    • TaiwanFuturesTick 2014-03-19: the whole day of tick data (235 products) has been backfilled. This day was previously announced as impossible to backfill; complete data has since been obtained and verified, and the 2026-09-02 announcement is corrected accordingly
    • TaiwanOptionTick 2019-01-15 ~ 2019-06-28 (129 calendar days, 105 trading days): this period was previously flagged in the dataset documentation as incomplete; it is now complete and the caveat has been removed
    • All three were verified day by day and product by product on both row counts and traded volume before going live

2026-09-06

  • Data correction notice: the datasets below have been corrected and are live. If you previously queried or downloaded the affected periods / dates, please fetch them again
    • Balance Sheet TaiwanStockBalanceSheet: data for the single period 2024-06-30 (2024 half-year report) was missing and has now been backfilled; coverage for that period grew from 1,917 to 2,233 companies (316 restored). Every period from 2014 to 2025 has been checked quarter by quarter and no gap of comparable size was found
    • Ex-Dividend/Ex-Right Result Table TaiwanStockDividendResult: data for 2026-09-02 briefly contained only part of the TWSE companies for that day; it has been completed to all 20
      • Cause: one stock going ex-rights that day had a combined rights-plus-dividend value above 1,000, formatted with a thousands separator, which made the whole day's batch fail to load. The parser has been fixed so this will not recur

2026-09-02

  • Data correction notice: Futures Trading Detail TaiwanFuturesTick, Options Trading Detail TaiwanOptionTick: after-hours tick data corrected. The dates below have been regenerated and verified — if you downloaded or queried any of them, please fetch the data again
    • 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 after-hours session restored on all of these), 2020-02-01 (duplicate rows removed from the Saturday file)
    • TaiwanOptionTick: 2026-08-14 (15:00–24:00 after-hours session restored)
    • Cause for 2026-08-14: each trading day's after-hours session (15:00 that day until 05:00 the next morning) belongs to the next trading day by rule and only becomes complete then, but that day's whole-day file is generated the same evening and then completed by the next day's routine run. On the weekend of 08-14 the Saturday file was generated early, that routine run was skipped, and the Friday file stayed at the version without the after-hours session; because historical dates older than 14 days are served from whole-day files, the issue only became visible from 08-28. This was a one-off situation for that single weekend — every other trading day since the after-hours session launched in 2017-05 has been checked day by day and is unaffected; the generation logic has been fixed so it no longer depends on the next day's routine run
    • Cause for the 6 days in 2019: the historical backfill that year skipped the first half of Friday night sessions; now backfilled and verified
    • Day-by-day check of 2011–2018: only 2014-03-19 is missing the whole day of tick data (corrected on 2026-09-13: that day has since been obtained and backfilled, see the announcement above)

2026-09-01

2026-08-20

  • Taiwan Stock Minute K Table TaiwanStockKBar now provides the TAIEX index minute K: pass TAIEX as data_id. Range 2005-01-03 ~ now (longer than the 2019-01-01 start for individual stocks), 271 rows per trading day covering 09:00 ~ 13:30, one row per minute
    • An index has no trading volume, so volume is always 0; open / high / low / close are index values within that minute

2026-08-09

  • Taiwan Options Real-Time Information taiwan_options_snapshot now covers the Friday-expiry TAIEX option contracts: data_id accepts TXU, TXV, TXX, TXY and TXZ (expiring on the 1st ~ 5th Friday of the month). The existing TXO (monthly) and TX1 ~ TX5 (Wednesday-expiry) are unaffected
    • A code returning no data in a given month is expected: the contract may not be listed yet, or that week does not exist in that month (e.g. a month with only 4 Fridays)
  • Added Individual Stock Margin Maintenance TaiwanStockMarginMaintenance: data range 2001-01-05 ~ now (TPEx stocks from 2007-01-04). Provides the daily margin maintenance ratio (%), margin cost line, margin purchase balance (lots) and the margin purchase ratio applied, per stock. This dataset is an estimated indicator (public disclosure does not provide the margin purchase amount at the individual-stock level), so the numbers will not match other services — see the documentation for details

2026-08-08

  • Added Asset Swap Fixed Income Daily Trading Information TaiwanAssetSwapFixedIncomeDaily: daily trading statistics for the fixed income leg of asset swaps, with columns notional_amount, number_of_transactions, rate_lowest / rate_highest / rate_average, and contract_term_years; data range 2011-05-03 ~ now
  • Added Asset Swap Option Daily Trading Information TaiwanAssetSwapOptionDaily: daily trading statistics for the asset swap option leg, with columns notional_amount, number_of_transactions, premium_lowest / premium_highest / premium_average, and contract_term_years; data range 2011-05-03 ~ now
    • ⚠ For both datasets, data_id (stock_id) is the convertible bond code (e.g. 17172), not the common stock code; querying with a common stock code (e.g. 2330) returns no data

2026-08-03

  • Service Status & Uptime now measures uptime request by request (uptime % = successful requests ÷ valid requests × 100) instead of by the share of minutes not counted as down. The 24-hour, 90-day and month-to-date figures each sum the requests in that window, so an error rate is reflected proportionally in uptime
    • Status tiers were adjusted accordingly: Operational ≥ 99.5%, Elevated Error Rates 95%–99.5%, Partial Outage 80%–95%, Major Outage < 80% (the former Degraded Performance tier is now named Elevated Error Rates)

2026-07-29

  • Futures Spread Tick Table TaiwanFuturesSpreadTick: fixed a missing-data issue. Data from 2026-06-12 onward has been corrected; data before 2026-06-11 has gaps that cannot be backfilled. For research purposes we recommend using data from 2026-06-12 onward

2026-07-23

2026-07-21

2026-07-13

2026-07-12

  • Added Disclaimer & Data Licensing: explains FinMind's data sources and licensing basis (data obtained via government open data platforms is used under the Open Government Data License of Taiwan), the scope of the license granted to users (the right to use this service, excluding redistribution / resale / mirroring), and disclaimers such as all data being for reference only

2026-07-01

2026-06-15

2026-06-13

  • Added Institutional Investors Buy/Sell (Wide) TaiwanStockInstitutionalInvestorsBuySellWide: same data as TaiwanStockInstitutionalInvestorsBuySell but in wide format — one row per trading day with each institutional investor's buy/sell as its own column, no manual pivot needed. Columns cover all historical investor categories; a category is 0 in eras where it did not exist (dealer split into proprietary/hedging from 2014-12-01; foreign dealer self from 2018-01-15). Data range 2005-01-01 ~ now
  • The FinMind Python package now supports Python 3.12 (Python 3.8–3.11 remain supported). Starting from this release, dependencies are upgraded to pandas>=2.0 and ta>=0.11 (numpy and pydantic unchanged).
    • No code changes are required to call FinMind: the public DataLoader, strategy, and plotting interfaces are unchanged.
    • ⚠ Upgrade note: installing/upgrading also bumps pandas to 2.x and ta to 0.11 in your environment. If your own surrounding code still uses pandas 1.x APIs removed in 2.0, you will need to adjust it — common examples: df.append() → pd.concat([...]), df.to_dict("r") → df.to_dict("records"), df.iteritems() → df.items(). If you cannot adjust yet, pin an older FinMind version for now.

2026-06-09

  • Added Futures Spread Tick Table TaiwanFuturesSpreadTick (sponsor members only): per-trade futures spread (near/far month) data, including contract months, deal time, spread deal price, volume, near month price, far month price, and spread-to-spread deal flag. Only one day of data is provided per request; data accumulates daily since 2026-04-27 (earlier historical backfill not yet included).

2026-06-05

2026-06-03

  • Added Service Status & Uptime: a public, real-time status page at status.finmindtrade.com, explaining how API uptime is calculated and the status tiers (Operational / Degraded Performance / Partial Outage / Major Outage), which serve as the basis for the enterprise-plan SLA.

2026-05-23

  • Added Taiwan Stock Index Codes: taiwan_stock_tick_snapshot data_id also accepts 91 three-digit index codes in addition to 4-digit stock IDs (e.g. 001 = TAIEX, 101 = OTC weighted), grouped into broad market / sector / themed (Smart Beta) / leverage & inverse categories.

2026-05-22

2026-05-19

2026-05-06

2026-05-05

2026-05-02

  • Added the "Update Token" feature: users can reset their token themselves on the user info page. The old token becomes invalid immediately, with no need to contact support.

2026-04-30

2026-04-28

2026-04-19

2026-04-17

2026-04-12

2026-04-03

  • Added async batch query example.

2026-03-28

2026-03-26

  • Fixed mistakenly entered data range for the shareholding distribution table.

2026-03-21

  • Agent Skill added installation instructions and example screenshots for Claude Code, Cursor, Windsurf, and Gemini.
  • Updated Contact: replaced Gitter with the Facebook group and fan page.

2026-03-20

  • Added Agent Skill documentation, allowing tools such as Claude Code to query FinMind data quickly via skill.

2026-03-10

  • Added llms.txt and llms-full.txt, helping AI tools understand FinMind documentation more quickly.
  • Added TaiwanStockPriceTick object method documentation.
  • Added an LLM / AI integration section to the homepage.

2026-03-06

2026-02-22

  • Updated futures and options real-time information documentation, adding supported codes and an explanation that an empty value retrieves all data.

2026-02-07

2026-02-01

2026-01-31

2026-01-24

2026-01-23

  • Added English translations to the documentation.

2026-01-22

  • Updated taiwan_options_snapshot documentation.

2026-01-18

  • Removed the token parameter from the API URL query; tokens are now passed via the header.

2026-01-04

  • Removed the login function; login is only supported via login_by_token.

2025-12-15

  • Enhanced the tick data async usage documentation.

2025-10-06

2025-09-21

2025-09-11

  • FinMind package added async batch query functionality.

2025-08-31

2025-08-13

  • Added the suspension marker for sell-then-buy trades, and corrected the documentation for futures and options institutional investors.

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, and TaiwanStockHoldingSharesPer are now available to backer-tier members.

2024-12-23

  • FinMind package added async batch query functionality.

2024-12-07

2024-12-01

2024-11-17

2024-10-12

2024-09-28

  • Added API usage query, allowing users to check api_usage and api_usage_limit through the package.

2024-09-26

2024-08-25

2024-07-14

2024-05-28

2024-05-19

2024-05-08

  • Removed the exchange rate data source.

2024-04-18

2024-04-01

2024-03-24

2024-03-19

2024-01-27

  • Added column schema documentation for all market datasets.

2021-10-06

  • Released FinMind package 1.5.3, addressing the connect error issue.
  • Added FinMind package documentation.

2021-08-01

  • Removed real-time quotes due to data source issues.

2021-05-23

2021-03-18

2021-02-22

  • Added the streaming_all_data parameter to retrieve real-time data (tick), covering all data from market open to the current moment.

2021-01-26

2021-01-25

  • web officially launched, including strategy analysis and backtesting features that analyze the win rate of stocks across the entire market to reduce survivorship bias.
  • Began the next phase of web development.

2021-01-18

2020-12-25

2020-10-06

  • Plan to switch to a time series database to improve API efficiency.
  • Working on backtesting feature development.
  • Web development of the data download feature: since most users use Excel for financial analysis, we are developing the web Excel data download function.

2020-05-06

2020-05-01

2020-04-24

2020-04-15

2019-10-23

  • Added TotalMarginPurchaseShortSale: total daily margin purchase and short sale.
  • Added TaiwanStockNews: Taiwan stock-related news.

2019-10-10

  • Added TaiwanFutures: Taiwan futures trading detail.
  • Added TaiwanOption: Taiwan options trading detail.

FinMind 1.0.80 (2019-07-15)

  • Major update. Previously the package connected directly to the database; now it uses the API. Older versions of the package will stop working in the future and will not be able to connect directly to the database. Please upgrade to the latest version, or use the API directly.

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 Balance Sheet )
  • TaiwanStockHoldingSharesPer ( Taiwan Shareholding Distribution Table )
  • Shareholding ( Taiwan Foreign Shareholding by Stock )
  • RawMaterialFuturesPrices ( US Raw Material Futures )

New Function

2018/8/5

  1. Central bank interest rates 100% ( 13 Countrys, Contains G8 )
      FED Federal Reserve System (USA)
  ECB European Central Bank (Europe)
  BOE Bank of England (UK)
  SNB Swiss National Bank (Switzerland)
  RBA Reserve Bank of Australia (Australia)
  BOC Bank of Canada (Canada)
  RBNZ Reserve Bank of New Zealand (New Zealand)
  BOJ Bank of Japan (Japan)
  CBR The Central Bank of the Russian Federation (Russia)
  RBI Reserve Bank of India (India)
  PBOC People's Bank of China  (China)
  BCB Banco Central do Brasil (Brazil)
    1. Gold Price 100%
    2. Government bond ->>> https://data.oecd.org/interest/long-term-interest-rates.htm
    3. Futures ->>> https://www.investing.com/commodities/energies
    4. S&P 500 index, plus crawled prices of all 500 constituent stocks ->>>

2018/7/5

  1. International oil prices: Load data example. (100%)
  2. Foreign exchange rates ( 53 Countrys, Contains G8 ) (100%)

2018/7/2 Future crawler order

  1. Central bank interest rates 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. Gold price from https://www.gold.org/data/gold-price