Building an AI agent? Start with /llms.txt for the full site index.

財務與分析

月營收

提供台股公司每月營收資料，適合用於營運趨勢追蹤與高頻基本面分析。

This documentation page is currently available in Chinese only; English versions are coming soon.

GET/v2/datasets/monthly-revenue

Overview

月營收 API 提供 TWSE 範圍的每月營收資料，來源為 mops_official，並以 canonical 形態供應。

monthly_revenue 已通過 baseline freeze signoff；本頁內容以 freeze 審核結果為準。

凍結覆蓋範圍：2023-06..2026-04
總筆數：詳見 /datasets
涵蓋股票數：詳見 /datasets
重複鍵（ticker + revenue_month）：0
市場範圍：TWSE only（不含 TPEx / OTC）
來源：mops_official / canonical
觀察營收成長趨勢
提前判斷基本面變化
建立營收動能策略
與價格資料對照短期反應
作為量化模型中的輸入特徵

Coverage

Instruments	Start year	Update timing	Includes delisted
2,096	2010	Not yet available (coming)	coming

Figures are measured from the DB; unlisted fields defer to docs coverage (coming) — we don't fabricate cell by cell.

Request

使用此 endpoint 時，建議：

Query Parameters

欄位	型別	Required	說明
symbol	string	yes	股票代碼（內部對應 ticker）。
start_date	string	no	查詢起始日期（YYYY-MM-DD）。
end_date	string	no	查詢結束日期（YYYY-MM-DD）。
limit	integer	no	回傳筆數（建議用於控制月份數）。

Response Shape

回應結構固定為 dataset、rows、count。

{
  "dataset": "monthly_revenue",
  "rows": [
    {
      "symbol": "2330",
      "revenue_month": "2026-03",
      "revenue": 210000000000,
      "revenue_yoy": 0.18,
      "revenue_mom": 0.05
    }
  ],
  "count": 1
}

Field 說明

欄位路徑	型別	說明
rows[].symbol	string	股票代碼。
rows[].revenue_month	string	營收月份（例如 2026-03）。
rows[].revenue	number	當月營收。
rows[].revenue_yoy	number\|null	年增率（若目前 schema 有）。
rows[].revenue_mom	number\|null	月增率（若目前 schema 有）。
count	integer	回傳資料筆數。

Usage Notes / 使用建議

使用 symbol + revenue_month 作為識別。
若要分析成長，可搭配 yoy / mom（若該筆資料有提供）。
若要做策略，建議與價格資料整合。
若需要完整財務結構，應搭配財報資料。
若做 ranking，可直接用 revenue 或 growth 指標。
本資料非即時（non-real-time）服務，且覆蓋範圍限於已驗證 freeze 視窗。
raw_payload / raw_report 與 forbidden content 在已審核凍結範圍內為未保留狀態。
idempotency 結論來自既有 artifacts + DB state，未執行 live source 重算。
本頁內容僅供資料工程與分析使用，不構成投資建議。

Limitations & notes

Coverage is not the full market or full history; the actual range is defined by the coverage table above and the data_gaps in the response.
Missing data is flagged honestly — we don't fill gaps with estimated values.
The platform focuses on daily-frequency and fundamental data; it does not provide real-time quotes, intraday bars, or cryptocurrencies.
TWSE is the verified baseline; TPEx history depth and adjusted prices are currently beta / deferred, flagged per dataset.
Queries do not support an as_of parameter (roadmap). For point-in-time, filter on each row's knowledge_date, which is set conservatively to the statutory filing deadline. Daily prices do not carry that column.

Plan Requirement

Free（限制）
Developer
Pro
Enterprise

此 API 屬於 TW Market Data 資料集目錄。查看資料集總覽

請求與回應

Request example

curl --request GET \  --url "https://api.twmarketdata.com/v2/datasets/monthly-revenue?symbol=2330&limit=24" \  --header "X-API-Key: your_api_key_here"

Status codes

成功回傳月營收資料

JSON

{  "dataset": "monthly_revenue",  "rows": [    {      "symbol": "2330",      "revenue_month": "2026-03",      "revenue": 210000000000,      "revenue_yoy": 0.18,      "revenue_mom": 0.05    }  ],  "count": 1}

Building an AI agent? Start with /llms.txt for the full site index.

財務與分析

月營收

提供台股公司每月營收資料，適合用於營運趨勢追蹤與高頻基本面分析。

This documentation page is currently available in Chinese only; English versions are coming soon.

GET/v2/datasets/monthly-revenue

Overview

月營收 API 提供 TWSE 範圍的每月營收資料，來源為 mops_official，並以 canonical 形態供應。

monthly_revenue 已通過 baseline freeze signoff；本頁內容以 freeze 審核結果為準。

凍結覆蓋範圍：2023-06..2026-04
總筆數：詳見 /datasets
涵蓋股票數：詳見 /datasets
重複鍵（ticker + revenue_month）：0
市場範圍：TWSE only（不含 TPEx / OTC）
來源：mops_official / canonical
觀察營收成長趨勢
提前判斷基本面變化
建立營收動能策略
與價格資料對照短期反應
作為量化模型中的輸入特徵

Coverage

Instruments	Start year	Update timing	Includes delisted
2,096	2010	Not yet available (coming)	coming

Figures are measured from the DB; unlisted fields defer to docs coverage (coming) — we don't fabricate cell by cell.

Request

使用此 endpoint 時，建議：

Query Parameters

欄位	型別	Required	說明
symbol	string	yes	股票代碼（內部對應 ticker）。
start_date	string	no	查詢起始日期（YYYY-MM-DD）。
end_date	string	no	查詢結束日期（YYYY-MM-DD）。
limit	integer	no	回傳筆數（建議用於控制月份數）。

Response Shape

回應結構固定為 dataset、rows、count。

{
  "dataset": "monthly_revenue",
  "rows": [
    {
      "symbol": "2330",
      "revenue_month": "2026-03",
      "revenue": 210000000000,
      "revenue_yoy": 0.18,
      "revenue_mom": 0.05
    }
  ],
  "count": 1
}

Field 說明

欄位路徑	型別	說明
rows[].symbol	string	股票代碼。
rows[].revenue_month	string	營收月份（例如 2026-03）。
rows[].revenue	number	當月營收。
rows[].revenue_yoy	number\|null	年增率（若目前 schema 有）。
rows[].revenue_mom	number\|null	月增率（若目前 schema 有）。
count	integer	回傳資料筆數。

Usage Notes / 使用建議

使用 symbol + revenue_month 作為識別。
若要分析成長，可搭配 yoy / mom（若該筆資料有提供）。
若要做策略，建議與價格資料整合。
若需要完整財務結構，應搭配財報資料。
若做 ranking，可直接用 revenue 或 growth 指標。
本資料非即時（non-real-time）服務，且覆蓋範圍限於已驗證 freeze 視窗。
raw_payload / raw_report 與 forbidden content 在已審核凍結範圍內為未保留狀態。
idempotency 結論來自既有 artifacts + DB state，未執行 live source 重算。
本頁內容僅供資料工程與分析使用，不構成投資建議。

Limitations & notes

Coverage is not the full market or full history; the actual range is defined by the coverage table above and the data_gaps in the response.
Missing data is flagged honestly — we don't fill gaps with estimated values.
The platform focuses on daily-frequency and fundamental data; it does not provide real-time quotes, intraday bars, or cryptocurrencies.
TWSE is the verified baseline; TPEx history depth and adjusted prices are currently beta / deferred, flagged per dataset.
Queries do not support an as_of parameter (roadmap). For point-in-time, filter on each row's knowledge_date, which is set conservatively to the statutory filing deadline. Daily prices do not carry that column.

Plan Requirement

Free（限制）
Developer
Pro
Enterprise

此 API 屬於 TW Market Data 資料集目錄。查看資料集總覽

請求與回應

Request example

curl --request GET \  --url "https://api.twmarketdata.com/v2/datasets/monthly-revenue?symbol=2330&limit=24" \  --header "X-API-Key: your_api_key_here"

Status codes

成功回傳月營收資料

JSON

{  "dataset": "monthly_revenue",  "rows": [    {      "symbol": "2330",      "revenue_month": "2026-03",      "revenue": 210000000000,      "revenue_yoy": 0.18,      "revenue_mom": 0.05    }  ],  "count": 1}