財務與分析
財報指標
提供已計算完成的財務指標資料，適合用於研究、篩選與策略分析。
GET
/v2/datasets/financial-metricsOverview#
財報指標 API 提供基於財報資料計算後的分析欄位，例如成長率、利潤率與估值相關指標。
這一層資料的特性：
- 已完成標準化與計算
- 可直接用於篩選與比較
- 避免每次重複自行計算
- 與財報資料的差異：
- 財報資料：原始數據（revenue、assets 等）
- 財報指標：已計算數據（margin、growth、ratio）
- 建立選股條件（例如 ROE、毛利率）
- 計算成長與趨勢
- 排序與 ranking
- 與價格資料整合做策略
- 作為 agent workflow 的分析層
Request#
使用此 endpoint 時，建議：
Query Parameters#
| 欄位 | 型別 | Required | 說明 |
|---|---|---|---|
| ticker | 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。
- 與價格資料整合時，請注意時間對齊。
- 若需要完整控制計算邏輯，應改用財報資料自行計算。
Plan Requirement#
- Free（限制）
- Developer
- Pro
- Enterprise