EN 登入註冊

AI agent？先讀 /llms.txt 取得全站索引。

財務與成長

財務比率指標

Name: Financial metrics
Creator: TW Market Data
License: https://twmarketdata.com/zh-TW/legal/licensing

由官方 MOPS 財報計算的財務比率——利潤率、報酬率等每期指標,每家公司每個會計期間一列。

← 財務比率指標資料集總覽

已驗證來源: MOPS·方案: pro·計費: 3 點·GET /v2/datasets/financial-metrics

財務比率指標是台灣市場資料集,來源為 MOPS,由 TW Market Data 以 GET /v2/datasets/financial-metrics 提供。

總覽

financial-metrics 為推導型資料集:比率由底層 MOPS 損益表與資產負債表申報計算而得,非官方直接揭露。lineage 欄位標明每個數字的推導來源,計算過程可稽核而非黑箱。

欄位	型別	說明
`ticker`	string
`market`	string
`as_of_date`	string
`fiscal_year`	number
`quarter`	number
`revenue`	number
`gross_profit`	number
`operating_income`	number
`net_income`	number
`eps`	number
`gross_margin`	number	毛利率(比值,0-1)。
`operating_margin`	number	營業利益率(比值,0-1)。
`net_margin`	number	稅後淨利率(比值,0-1)。
`roe_q`	number
`roa_q`	number
`total_assets`	number
`total_liabilities`	number
`total_equity`	number
`debt_ratio`	number
`current_ratio`	number
`bvps`	number

涵蓋範圍

列數	90,713
涵蓋起訖	2013-03-31 – 2026-09-02
分級	已驗證
量測時間	2026-09-02取自資料集登錄表

範例回應

此為本端點的真實回應。資料列位於 "envelope.data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。

{
  "api_version": "v2",
  "endpoint": "/v2/datasets/financial-metrics",
  "request_id": "req_a9e23e69b5c1",
  "plan_id": "enterprise",
  "dataset": "financial_metrics",
  "query": {
    "ticker": "1101",
    "as_of_date": null,
    "fiscal_period": null,
    "period_type": null,
    "limit": 50,
    "offset": 0,
    "sort_by": "as_of_date",
    "sort_order": "desc"
  },
  "meta": {
    "rows_returned": 50,
    "mandatory_contract_fields_present": [
      "api_version",
      "data",
      "data_as_of"
    ],
    "plan": "enterprise",
    "row_limit": 100000,
    "is_limited": false
  },
  "envelope": {
    "api_version": "v2",
    "dataset": "financial_metrics",
    "dataset_version": "v2.0.0-preview",
    "release_version": "v2.2026-05-15.preview",
    "release_date": "2026-05-15",
    "data_as_of": "2026-05-15",
    "request_context": {
      "ticker": "1101",
      "as_of_date": "2026-05-15",
      "family": "fundamentals",
      "field_group_type": "derived",
      "dataset_view": "financial_metrics_v1",
      "supported_sort_by": [
        "as_of_date"
      ],
      "supported_filter_fields": [
        "ticker",
        "as_of_date",
        "fiscal_period"
      ]
    },
    "data": [
      {
        "ticker": "1101",
        "market": "TW",
        "as_of_date": "2026-05-15",
        "fiscal_year": 2026,
        "quarter": 1,
        "revenue": 33168148,
        "gross_profit": 6208390,
        "operating_income": 2792191,
        "net_income": 1204739,
        "eps": 0.1,
        "gross_margin": 0.187179,
        "operating_margin": 0.084183,
        "net_margin": 0.036322,
        "roe_q": 0.003953,
        "roa_q": 0.002016,
        "total_assets": 597615286,
        "total_liabilities": 292869670,
        "total_equity": 304745616,
        "debt_ratio": 0.490064,
        "current_ratio": 2.238606,
        "bvps": 31.39,
        "provider": "twse_official",
        "source_role": "derived_financial_ratios",
        "lineage": {
          "row_index": 0,
          "source_hash": "finratio:1101:2026:1",
          "payload_date": "20260702",
          "request_date": "2026-07-02",
          "endpoint_name": "opendata_t187ap06_07",
          "source_authority": "TWSE/TPEx t187ap06+07 (綜合損益+資產負債) derived ratios"
        },
        "updated_at": "2026-07-02T03:28:03.070574+00:00"
      },
      {
        "ticker": "1101",
        "market": null,
        "as_of_date": "2026-03-31",
        "fiscal_year": 2025,
        "quarter": 4,
        "revenue": 149804135,
        "gross_profit": 27557589,
        "operating_income": 10077592,
        "net_income": -11862586,
        "eps": -1.6,
        "gross_margin": 0.18395746552656908,
        "operating_margin": 0.06727178792494613,
        "net_margin": -0.0791873068123253,
        "roe_q": -0.0405273328785764,
        "roa_q": -0.020145841281294815,
        "total_assets": 588835474,
        "total_liabilities": 296129659,
        "total_equity": 292705815,
        "debt_ratio": 0.5029073010638622,
        "current_ratio": 2.07293598186531,
        "bvps": 30.14,
        "provider": "derived_from_fundamentals",
        "source_role": "derived_cache",
        "lineage": null,
        "updated_at": "2026-07-09T06:15:12.780218+00:00"
      }
    ],
    "quality": {
      "freshness_state": "fresh",
      "freshness_as_of": "2026-05-15",
      "completeness_ratio": 1,
      "quality_status": "ready"
    },
    "lineage": {
      "source_role": "canonical",
      "selected_source": "mops_official",
      "fallback_chain": [
        "data_gov_mirror",
        "finmind_legacy"
      ],
      "policy_notes": [
        "official/public-first canonical",
        "financial_metrics derived from normalized fundamentals + valuation core",
        "unstable fields excluded from public contract (analyst/non-gaap/custom scoring)"
      ]
    },
    "error": {
      "error_code": null,
      "error_message": null,
      "dataset": "financial_metrics",
      "request_id": "read-api-ac9f8f681b10",
      "blocking_gate": null
    }
  }
}

擷取自 2026-07-20 的線上 API。

本頁顯示原始中文值；英文頁會以標記取代，以維持全英文。

出處

以下欄位會隨資料一併回傳,記錄這一列的來源。它們屬於出處而非本資料集要講的事實,因此列在這裡而不進欄位表。

providersource_rolelineageupdated_at

授權與顯名

本服務部分資料取自政府資料開放平臺(data.gov.tw),依「政府資料開放授權條款-第1版」授權利用。資料提供機關:臺灣證券交易所、證券櫃檯買賣中心、臺灣期貨交易所、臺灣集中保管結算所、國家發展委員會、中央銀行、經濟部統計處、財政部關務署。本服務之加值處理、衍生計算與呈現方式由 TWMD 負責,與各資料提供機關無涉。

引用此資料集

TW Market Data. (n.d.). 財務比率指標 [Data set]. TW Market Data. Retrieved 2026-09-05, from https://twmarketdata.com/zh-TW/docs/api/financials/financial-metrics

版本取自資料集自己的 as_of，不是這一頁的產生日期。沒有 as_of 的資料集就不列這個欄位，不會補一個看起來合理的值。驗證簽章

可與本資料集對齊的其他資料集。每組都標出可用來 join 的欄位,規劃跨表查詢時不必自己猜。

期貨市場日資料
可用 as_of_date + market + ticker 對齊
GHG 碳揭露（範疇1/2/3）
可用 as_of_date + market + ticker 對齊
三大法人買賣
可用 as_of_date + market + ticker 對齊
發行人分類
可用 as_of_date + market + ticker 對齊
融資融券
可用 as_of_date + market + ticker 對齊

快速開始

把你的金鑰放進 X-API-Key 標頭。
加上查詢參數（symbol、日期區間、limit）。
送出請求並讀取 envelope.data 陣列。

curl "https://api.twmarketdata.com/v2/datasets/financial-metrics?ticker=2330" \
  -H "X-API-Key: sk_live_..."

篩選參數

參數	必填	型別	說明
`ticker`	否	string	由端點自身在 envelope.request_context.supported_filter_fields 宣告。
`as_of_date`	否	string	由端點自身在 envelope.request_context.supported_filter_fields 宣告。
`fiscal_period`	否	string	由端點自身在 envelope.request_context.supported_filter_fields 宣告。

Python 範例

import requests

resp = requests.get(
    "https://api.twmarketdata.com/v2/datasets/financial-metrics",
    params={"ticker": "2330"},
    headers={"X-API-Key": "sk_live_..."},
)
resp.raise_for_status()
print(resp.json()["envelope"]["data"])

OpenAPI

此端點為 GET /v2/datasets/financial-metrics。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。

備註與限制

推導而非官方揭露:每個比率皆由官方 MOPS 財報計算,會承接來源的重編——回測時請以 as_of 數字重新計算。

請求與回應

請求

curl "https://api.twmarketdata.com/v2/datasets/financial-metrics" \
  -H "X-API-Key: $TWMD_API_KEY"

回應

{
  "api_version": "v2",
  "endpoint": "/v2/datasets/financial-metrics",
  "request_id": "req_a9e23e69b5c1",
  "plan_id": "enterprise",
  "dataset": "financial_metrics",
  "query": {
    "ticker": "<string>",
    "as_of_date": "<null>",
    "fiscal_period": "<null>",
    "period_type": "<null>",
    "limit": "<number>",
    "offset": "<number>",
    "sort_by": "<string>",
    "sort_order": "<string>"
  },
  "meta": {
    "rows_returned": "<number>",
    "mandatory_contract_fields_present": "<array>",
    "plan": "<string>",
    "row_limit": "<number>",
    "is_limited": "<boolean>"
  },
  "envelope": {
    "api_version": "<string>",
    "dataset": "<string>",
    "dataset_version": "<string>",
    "release_version": "<string>",
    "release_date": "<string>",
    "data_as_of": "<string>",
    "request_context": {
      "ticker": "<string>",
      "as_of_date": "<string>",
      "family": "<string>",
      "field_group_type": "<string>",
      "dataset_view": "<string>",
      "supported_sort_by": "<array>",
      "supported_filter_fields": "<array>"
    },
    "data": "<array>",
    "quality": {
      "freshness_state": "<string>",
      "freshness_as_of": "<string>",
      "completeness_ratio": "<number>",
      "quality_status": "<string>"
    },
    "lineage": {
      "source_role": "<string>",
      "selected_source": "<string>",
      "fallback_chain": "<array>",
      "policy_notes": "<array>"
    },
    "error": {
      "error_code": "<null>",
      "error_message": "<null>",
      "dataset": "<string>",
      "request_id": "<string>",
      "blocking_gate": "<null>"
    }
  }
}