登入取得 API 金鑰

所有 API

MOPS API 台灣申報文件與報表

取得台灣證交所與櫃買中心上市櫃約 1,980 家公司的財務報表。此 API 目前涵蓋 2026 年半年度報告。

取得免費 API 金鑰

閱讀文件 →

在線97.81% uptime, last 30天295 ms 一般回應

首次請求

取得半年度財務數據

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/twn:2330/financials?period=semiannual&fields=revenue,net_income,total_assets" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

回應範例

{
  "id": "twn:2330",
  "currency": "TWD",
  "semiannual": [
    {
      "fy": 2026,
      "fh": 1,
      "end": "2026-06-30",
      "derived": [],
      "revenue": "2404483690000",
      "net_income": "1279041690000",
      "total_assets": "9375654727000"
    }
  ],
  "as_of": "2026-10-24"
}

端點

GET列出公司/v1/companies

依名稱搜尋公司並取得其 ID。在其他所有呼叫中使用該 ID。

參數

q選填
搜尋文字，例如公司名稱。

完整參考文件 →

GET列出公司的申報文件/v1/companies/{company_id}/filings

公司的申報文件，由新到舊，並附上每份官方文件的連結。

參數

company_id必填
公司 ID，例如 usa:0000789019，或股票代號別名，例如 usa:MSFT。
type選填
申報文件類別，例如 annual。

完整參考文件 →

GET取得標準化的公司財務報表/v1/companies/{company_id}/financials

公司的標準化財務報表，每個期間一列，以其申報幣別計。

參數

company_id必填
公司 ID，例如 usa:0000789019，或股票代號別名，例如 usa:MSFT。
period選填
annual 或 semiannual，視註冊機構而定。
statement選填
income、balance、cash_flow 或 per_share。
fields選填
以逗號分隔的項目名稱，例如 revenue,net_income。

完整參考文件 →

使用情境

載入多年的公司資料

分頁讀取長期歷史資料，並在工作中斷時接續。

閱讀指南 →

依排程重新整理

用小型腳本每天拉取新的申報文件與數據。

閱讀指南 →

不超出用量限制

快取回應並處理 429 錯誤，不遺失請求。

閱讀指南 →

向代理程式詢問某家公司

透過 MCP 讓 LLM 代理程式讀取申報文件與財務數據。

閱讀指南 →

涵蓋範圍

臺灣約 1,980 家公司。2026 年半年度報告。

來源

臺灣TWSE 與 TPEx 上市櫃公司

相關 API

ESEF API 取得公司年度申報

來自 26 個歐盟與歐洲經濟區國家公司的年度報告

受規範市場公司的英國財報 API

來自英國受監管市場發行人的年度報告

EDINET API 已上線涵蓋日本公司

日本申報文件與財務報表，已上線

DART API 已涵蓋韓國公司

韓國申報文件與財務報表，已上線

公司申報文件 API 清單與單筆紀錄

申報文件清單、單筆記錄，以及各公司的最新申報文件

常見問題

台灣公司 ID 如何運作？

台灣公司 ID 由 twn: 加上股票代號組成，例如 twn:2330。

資產負債表涵蓋哪些日期？

資產負債表依各報告日提供。

是否包含台灣持股 5% 以上的股東？

否。台灣不包含持股 5% 以上的股東。

TWSE OpenAPI 與 TPEx 開放資料

我們使用 data.gov.tw 上的台灣證券交易所（TWSE）OpenAPI 與台灣櫃檯買賣中心（TPEx）開放資料，依台灣政府資料開放授權條款第 1 版。這些來源與 MOPS 申報文件內容一致。

半年度數字

損益與每股數字為半年度的年初至今數字（period=semiannual）。年度數字將隨年度報告提供。

整數新台幣

金額為整數新台幣，由以千元為單位的來源數值放大而來。EPS 等每股數字為小數，不做縮放。