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/financial-metrics

Overview

財報指標 API 提供基於財報資料計算後的分析欄位，例如成長率、利潤率與估值相關指標。

這一層資料的特性：

已完成標準化與計算
可直接用於篩選與比較
避免每次重複自行計算
與財報資料的差異：
財報資料：原始數據（revenue、assets 等）
財報指標：已計算數據（margin、growth、ratio）
建立選股條件（例如 ROE、毛利率）
計算成長與趨勢
排序與 ranking
與價格資料整合做策略
作為 agent workflow 的分析層

Coverage

Instruments	Start year	Update timing	Includes delisted
Not yet available (coming)	Not yet available (coming)	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	股票代碼。
period	string	no	資料期間（quarterly / annual）。
limit	integer	no	回傳筆數。
offset	integer	no	分頁。

Response Shape

所有回應遵循一致結構，包含 dataset、source_role、freshness、lineage、data。

{  "dataset": "financial_metrics",  "source_role": "canonical",  "freshness": "2026-04-22T11:30:00+08:00",  "lineage": {    "source": "TWSE",    "ingested_at": "2026-04-22T11:30:05+08:00",    "trace_id": "financial_metrics_2330_20260422"  },  "data": [    {      "ticker": "2330",      "report_period": "2025-Q4",      "revenue_growth": 0.18,      "gross_margin": 0.53,      "operating_margin": 0.42,      "net_margin": 0.36,      "roe": 0.28,      "roa": 0.18    }  ]}

Field 說明

欄位路徑	型別	說明
data[].ticker	string	股票代碼。
data[].report_period	string	報導期間。
data[].revenue_growth	number	營收成長率。
data[].gross_margin	number	毛利率。
data[].operating_margin	number	營業利益率。
data[].net_margin	number	淨利率。
data[].roe	number	股東權益報酬率。
data[].roa	number	資產報酬率。
data[].eps	number\|null	每股盈餘（若 schema 提供）。
source_role	string	資料來源角色。
freshness	string	資料更新時間。
lineage.trace_id	string	可追蹤資料處理鏈路。

Usage Notes / 使用建議

使用 ticker + report_period 作為主要識別鍵。
不需重新計算已提供的指標欄位。
ranking / screening 建議直接使用此 API。
與價格資料整合時，請注意時間對齊。
若需要完整控制計算邏輯，應改用財報資料自行計算。

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.

Plan Requirement

Free（限制）
Developer
Pro
Enterprise

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

請求與回應

Request example

curl --request GET \  --url "https://api.twmarketdata.com/v2/datasets/financial-metrics?symbol=2330&period=quarterly&limit=10" \  --header "X-API-Key: your_api_key_here"

Status codes

成功回傳財報指標資料

JSON

{  "dataset": "financial_metrics",  "source_role": "canonical",  "freshness": "2026-04-22T11:30:00+08:00",  "lineage": {    "source": "TWSE",    "ingested_at": "2026-04-22T11:30:05+08:00",    "trace_id": "financial_metrics_2330_20260422"  },  "data": [    {      "ticker": "2330",      "report_period": "2025-Q4",      "revenue_growth": 0.18,      "gross_margin": 0.53,      "operating_margin": 0.42,      "net_margin": 0.36,      "roe": 0.28,      "roa": 0.18    }  ]}

Overview

財報指標 API 提供基於財報資料計算後的分析欄位，例如成長率、利潤率與估值相關指標。

這一層資料的特性：

已完成標準化與計算

可直接用於篩選與比較

避免每次重複自行計算

與財報資料的差異：

財報資料：原始數據（revenue、assets 等）

財報指標：已計算數據（margin、growth、ratio）

建立選股條件（例如 ROE、毛利率）

計算成長與趨勢

排序與 ranking

與價格資料整合做策略

作為 agent workflow 的分析層

Instruments

Start year

Update timing

Includes delisted

Not yet available (coming)

coming

欄位

型別

Required

說明

symbol

string

yes

股票代碼。

period

string

資料期間（quarterly / annual）。

limit

integer

回傳筆數。

offset

integer

分頁。

Response Shape

所有回應遵循一致結構，包含 dataset、source_role、freshness、lineage、data。

{  "dataset": "financial_metrics",  "source_role": "canonical",  "freshness": "2026-04-22T11:30:00+08:00",  "lineage": {    "source": "TWSE",    "ingested_at": "2026-04-22T11:30:05+08:00",    "trace_id": "financial_metrics_2330_20260422"  },  "data": [    {      "ticker": "2330",      "report_period": "2025-Q4",      "revenue_growth": 0.18,      "gross_margin": 0.53,      "operating_margin": 0.42,      "net_margin": 0.36,      "roe": 0.28,      "roa": 0.18    }  ]}

Field 說明

欄位路徑	型別	說明
data[].ticker	string	股票代碼。
data[].report_period	string	報導期間。
data[].revenue_growth	number	營收成長率。
data[].gross_margin	number	毛利率。
data[].operating_margin	number	營業利益率。
data[].net_margin	number	淨利率。
data[].roe	number	股東權益報酬率。
data[].roa	number	資產報酬率。
data[].eps	number\|null	每股盈餘（若 schema 提供）。
source_role	string	資料來源角色。
freshness	string	資料更新時間。
lineage.trace_id	string	可追蹤資料處理鏈路。

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.