FinMind API 串接台股歷史價量與除權息：Python / 前端數據工程介接實踐

對於想要進行台股程式化量化分析、歷史策略回測，或是希望在個人記帳 App 中自動更新台股即時與歷史報價的開發者而言，**FinMind 金融數據資料庫** 是一個極其優質且對社群非常友好的開放平台。

FinMind 提供了乾淨且格式統一的 RESTful API 介面，涵蓋台股個股日成交資訊、三大法人買賣超、融資融券異動、綜合損益表與股利分派歷史等豐富資料。本文將詳細介紹如何免費申請 Token 並在前端（JavaScript）或後端（Python）中進行介接。

一、 3 步驟免費取得 FinMind API Token

1. 前往 FinMind 官方網站 (finmindtrade.com) 點擊「註冊 / 登入」。
2. 完成 Email 帳號驗證後，登入會員後台管理面板 (Dashboard)。
3. 在「API Token 簽發區」即可複製屬於您的專屬 API Key（長字串）。

二、 JavaScript Fetch 實作範例（查詢台積電 2330 歷史股價）

async function fetchTaiwanStockPrice(stockId, token) {
  const dataset = 'TaiwanStockPrice';
  const startDate = '2026-01-01';
  const url = `https://api.finmindtrade.com/api/v4/data?dataset=${dataset}&data_id=${stockId}&start_date=${startDate}&token=${token}`;

  try {
    const response = await fetch(url);
    const result = await response.json();
    if (result.msg === 'success') {
      console.log('取得股價筆數：', result.data.length);
      return result.data;
    }
  } catch (err) {
    console.error('API 請求失敗：', err);
  }
}