Donate

• 贊助我們發展更多功能

• FinMind 架構獨家解析書籍推薦

Quickstart

pip install FinMind

• Refer to our Official Documentation.

LLM / AI 整合

想用 ChatGPT、Claude 等 AI 工具查詢 FinMind 的資料集和 API 用法？我們提供 llms.txt，讓 AI 快速理解 FinMind 的所有資料集、API 端點與使用方式。

只要將以下連結貼給你的 AI 助手，即可開始對話：

• llms.txt — 精簡版，資料集索引與 API 概覽
• llms-full.txt — 完整版，包含所有資料集的欄位名稱、SDK 方法、參數範例
• Agent Skill 教學 — 讓 AI Agent（如 Claude Code）直接查詢 FinMind 資料

這是什麼?

FinMind 提供台灣與國際市場的金融開源數據，完整資料集清單請見官方文件。 包含

• 技術面 : 台股股價 daily、即時報價、歷史 tick、PER、PBR、每5秒委託成交統計、加權指數、當日沖銷交易標的及成交量值。
• 基本面 : 綜合損益表、現金流量表、資產負債表、股利政策表、除權除息結果表、月營收。
• 籌碼面 : 外資持股、股權分散表、融資融券、三大法人買賣、借券成交明細。
• 消息面 : 台股相關新聞。
• 衍生性商品 : 期貨、選擇權 daily data、即時報價、交易明細，選擇權、期貨三大法人買賣，期貨各卷商每日交易、選擇權各卷商每日交易。
• 國際市場 : 美股股價 daily、minute、美國債券殖利率、貨幣發行量(美國)、黃金價格、原油價格、G8 央行利率、G8 匯率、

資料每天更新。你不需收集資料，就可進行分析。

What is this?

FinMind provides open financial datasets for Taiwan and international markets. See the official documentation for the current dataset list, including

Taiwan stock trade data daily, Taiwan stock trade data (5 seconds) (2019-05-29 ~ now, more than 30 million data in total), Financial Statements, Balance Sheet, Cash Flows Statement, Month Revenue, Holding Shares Per, Institutional Investors Buy Sell. Taiwan Futures Trade Detail, Taiwan Option Trade Detail.

US stock price daily, minute (2019-06-01 ~ now, more than 80 million data in total), oil price, gold price, G7 exchange rate, interest rate.

US Government Bonds Yield.

The datasets are automatically updated daily. You can analyze financial data without having to collect the data by yourself.

---

License

• License Detail

• 本專案提供的所有內容均用於教育、非商業用途。資料僅供參考，使用者依本資料交易發生交易損失需自行負責，本專案不對資料內容錯誤、更新延誤或傳輸中斷負任何責任。

Project of Contents

• Dataset

  • 線上 API
  • Taiwan Stock Data
  • Document
  • 壓力測試

• Example

  • backtest
  • customer_dashboard_web_server
  • kbar_plotting.ipynb
  • dashboard.ipynb

• Other

  • Open UP Summit Slide (PPT)
  • Median Sharing
  • HistoryUpdate

Plotting

kbar_plotting.ipynb

# 取得股價
from FinMind.data import DataLoader

dl = DataLoader()
# 下載台股股價資料
stock_data = dl.taiwan_stock_daily(
    stock_id='2609', start_date='2018-01-01', end_date='2021-06-26'
)
# 下載三大法人資料
stock_data = dl.feature.add_kline_institutional_investors(
    stock_data
) 
# 下載融資券資料
stock_data = dl.feature.add_kline_margin_purchase_short_sale(
    stock_data
)

# 繪製k線圖
from FinMind import plotting

plotting.kline(stock_data)

dashboard

Contact

Email: [email protected]

每週日早上零點至早上七點為維護時間，不提供服務。

Contributing

See CONTRIBUTING.md for the development setup, test commands, and pull request checklist.

Note

• 未來預計新增更多功能，包含個人化回測分析、chatbot 監控策略，
• API Request 上限：300 / 小時。
• Limit amount of request, 300 / hour.
• 至FinMind官網註冊並驗證信箱後，API 的 Request 加上 token 參數可以提高使用上限到 600/hr。
• token 獲取方法，可在官網登入後獲取。