AI agent？先讀 /llms.txt 取得全站索引。
財務與成長
上市櫃公司月營收申報，來源為公開資訊觀測站（MOPS），可直接計算 YoY／MoM 成長。
GET /v2/datasets/monthly-revenuemonthly-revenue 以 MOPS 為源，每家公司每個申報月份回傳一列；lineage 欄位標明數字來自哪一份 MOPS 表單，數值可稽核而非黑箱。
| 欄位 | 型別 | 說明 |
|---|---|---|
symbol | string | 股票代碼。 |
period | string | 申報月份（YYYY-MM）。 |
revenue | number | 月營收（新台幣仟元）。 |
source_role | string | 正規來源角色（official_mops_monthly_revenue）。 |
lineage | object | 上游端點與權威來源（如 MOPS t187ap05）。 |
| 列數 | 331,109 |
| 涵蓋起訖 | 2010-02-10 至 2026-07-10 |
| 分級 | 已驗證 |
此為本端點的真實回應。資料列位於 "rows" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。
{ "dataset": "monthly_revenue", "rows": [ { "symbol": "2330", "month": "2026-04", "revenue_month": "2026-04", "revenue": 410725118, "mom": -1.075787644781405, "yoy": 17.495412466636576, "announcement_date": "2026-05-17", "source_publish_date": "2026-05-17", "currency": "TWD", "is_revision": false, "revision_key": null, "source_id": "mops_official" }, { "symbol": "2330", "month": "2026-03", "revenue_month": "2026-03", "revenue": 415191699, "mom": 30.704566506222868, "yoy": 45.193838874210485, "announcement_date": "2026-05-17", "source_publish_date": "2026-05-17", "currency": "TWD", "is_revision": false, "revision_key": null, "source_id": "mops_official" } ], "count": 35}擷取自 2026-07-20 的線上 API。
curl "https://api.twmarketdata.com/v2/datasets/monthly-revenue?symbol=2330&start_date=2026-06-01&end_date=2026-07-15&limit=5" \ -H "X-API-Key: sk_live_..."| 參數 | 必填 | 型別 | 說明 |
|---|---|---|---|
symbol | 是 | string | 股票代碼，例如 2330。 |
start_date | 否 | string (YYYY-MM-DD) | 查詢起始日期。 |
end_date | 否 | string (YYYY-MM-DD) | 查詢結束日期。 |
limit | 否 | integer | 回傳筆數上限。 |
第一個呼叫：
import requests resp = requests.get( "https://api.twmarketdata.com/v2/datasets/monthly-revenue", params={"symbol": "2330", "limit": "5"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json()["rows"])帶日期區間篩選：
import requests # The full verified example — the same call with every supported filter set.resp = requests.get( "https://api.twmarketdata.com/v2/datasets/monthly-revenue", params={"symbol": "2330", "start_date": "2026-06-01", "end_date": "2026-07-15", "limit": "5"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["rows"]: print(row)此端點為 GET /v2/datasets/monthly-revenue。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。