What's New

2026-05-19¶

The following datasets now cover emerging market companies in addition to TWSE-listed and TPEx OTC companies (distinguished by stock_id; use TaiwanStockInfo to look up market type):

2026-05-06¶

Taiwan Stock Trading Daily Report by Branch TaiwanStockTradingDailyReport storage_objects docs: added a FinMind package example (taiwan_stock_trading_daily_report(use_object=True)).

2026-05-05¶

Taiwan Stock Trading Daily Report by Branch TaiwanStockTradingDailyReport added a storage_objects download path to fetch a whole day's data at once (sponsorpro members only).

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-12¶

TaiwanStockPriceLimit documentation update: 0 means no price limit.

2026-04-03¶

Added async batch query example.

2026-03-28¶

Updated TaiwanStockDispositionSecuritiesPeriod documentation with ESB and TWSE data.

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¶

Added Daily Price Limit TaiwanStockPriceLimit

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¶

Added Futures Spread Trading TaiwanFuturesSpreadTrading

2026-02-01¶

2026-01-31¶

TaiwanStockSuspended and TaiwanStockDayTradingSuspension added FinMind package examples.

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¶

Added Dividend Policy Table TaiwanStockDividend

2025-09-21¶

Added the kind parameter to Index Statistics Every 5 Seconds TaiwanStockEvery5SecondsIndex.

2025-09-11¶

FinMind package added async batch query functionality.

2025-08-31¶

Added Taiwan Stock Par Value Change Reference Price TaiwanStockParValueChange

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¶

Taiwan Stock Tick by Securities Trader TaiwanStockTradingDailyReport added FinMind package example.
Taiwan Stock Warrant Tick by Securities Trader TaiwanStockWarrantTradingDailyReport added FinMind package example.

2025-05-11¶

Added US Stock Minute Price USStockPriceMinute
Company Industry Chain TaiwanStockIndustryChain added FinMind package example.

2025-05-10¶

Added Index Statistics Every 5 Seconds TaiwanStockEvery5SecondsIndex
API authentication updated; tokens are now passed via the header Authorization: Bearer <token>.

2025-04-06¶

Added Company Industry Chain TaiwanStockIndustryChain

2025-02-09¶

Added Disposition Securities Period TaiwanStockDispositionSecuritiesPeriod

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¶

Added data range descriptions for TaiwanBusinessIndicator and CnnFearGreedIndex.

2024-12-01¶

Added Taiwan Monthly Business Indicator TaiwanBusinessIndicator

2024-11-17¶

Added Taiwan Stock Market Value Weight TaiwanStockMarketValueWeight

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¶

TaiwanStockTradingDailyReportSecIdAgg added securities_trader_id and end_date parameters.

2024-08-25¶

Added Daily Securities Trader Aggregate Statistics TaiwanStockTradingDailyReportSecIdAgg

2024-07-14¶

2024-05-28¶

Added Taiwan Total Exchange Margin Maintenance TaiwanTotalExchangeMarginMaintenance

2024-05-19¶

Added FinMind package example for Securities Trader Info TaiwanSecuritiesTraderInfo.
Added data range description for Capital Reduction Reference Price TaiwanStockCapitalReductionReferencePrice.

2024-05-08¶

Removed the exchange rate data source.

2024-04-18¶

Added Margin Short Sale Suspension (Short Covering Date) TaiwanStockMarginShortSaleSuspension

2024-04-01¶

Added FinMind package examples to the Convertible Bond series of datasets.

2024-03-24¶

Added the convertible bond series of datasets:

2024-03-19¶

Added Taiwan Stock Delisting Table TaiwanStockDelisting

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¶

Added Total Short Sale Balance Limit Table TaiwanDailyShortSaleBalances

2021-03-18¶

Added Day Trading Securities and Trading Volume TaiwanStockDayTrading.

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¶

Added CnnFearGreedIndex Fear and Greed Index
Registered users surpassed 500.

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¶

Added Futures and Options Institutional Investors Trading
Added Futures and Options Daily Trading Information by Securities Trader
The web backtesting and strategy analysis features are scheduled to launch soon. They can analyze the win rate of all market stocks for a specific strategy to reduce survivorship bias.
api v4 is live, allowing users to retrieve all stock prices, institutional investor data, and margin trading information for a specific date in a single call. This makes daily updates more convenient by sending only a small number of requests.

2020-12-25¶

All data has been migrated to a time series database. For tick data, response speeds have improved by more than 10 times.
web data download
FinMind backtesting package documentation is being optimized.

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¶

Added Taiwan Futures daily data
Added Taiwan Options daily data

2020-04-24¶

Added Taiwan Stock real-time best five bid/ask.
Added Taiwan Futures real-time quotes

2020-04-15¶

Added documentation.
Added Taiwan Stock real-time price
Added US Treasury Bond Yield
Added Taiwan Stock PER and PBR Table TaiwanStockPER

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¶

transpose(data)
demp2.py

2018/8/5¶

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)

Gold Price 100%
Government bond ->>> https://data.oecd.org/interest/long-term-interest-rates.htm
Futures ->>> https://www.investing.com/commodities/energies
S&P 500 index, plus crawled prices of all 500 constituent stocks ->>>

2018/7/5¶

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

2018/7/2 Future crawler order¶

Central bank interest rates from https://tradingeconomics.com/search.aspx?q=Interest%20Rate
Inflation monthly from https://tradingeconomics.com/russia/inflation-cpi
Consumer Price Index (CPI) monthly from https://tradingeconomics.com/russia/consumer-price-index-cpi
Output Gap monthly from https://tradingeconomics.com/russia/gdp-deflator
S&P 500 from yahoo finance
Gold price from https://www.gold.org/data/gold-price