Workflows / Use Cases

查看公司基本面

學會如何用台股資料 API 快速查看一家公司的基本面，包含公司資料、財報、財報指標與月營收趨勢。

Overview#

查看公司基本面通常不只是一個 API request，而是一個由多個資料主題組成的流程。

在實務上，常見的基本面檢查會包含：

公司基本資料：確認 ticker、公司名稱、市場別與產業分類
財報資料：查看營收、獲利、資產負債與現金流
財報指標：快速判斷毛利率、營業利益率、ROE 等分析欄位
月營收：補充較高頻的營運變化訊號
這一頁會帶你用一套固定流程，從單一 ticker 出發，逐步把一家公司的核心基本面資料串起來。

Prerequisites#

開始前，請先確認：

你已取得 API key
你知道要查詢的股票代碼，例如 2330
你可以使用 Python、JavaScript 或 cURL 發送 request
你了解不同資料主題的更新頻率不同：財報較低頻，月營收較高頻

Step 1：先查公司基本資料#

第一步先確認公司主體資訊。這可以幫你確認 ticker 是否正確，並建立後續 join 與資料整理的基礎。

建議先查：

公司名稱
市場別
產業分類
上市狀態

import requests

headers = {"X-API-Key": "your_api_key_here"}

response = requests.get(
    "https://api.twmarketdata.com/v2/datasets/issuer-profile",
    headers=headers,
    params={"ticker": "2330"},
)

print(response.json())

Step 2：取得財報資料#

第二步用財報資料取得原始數據。這一層適合查看營收、淨利、資產負債與現金流結構。

建議先查近 4～8 季，確認季節性與趨勢，再決定是否擴展到年度資料。

import requests

headers = {"X-API-Key": "your_api_key_here"}

response = requests.get(
    "https://api.twmarketdata.com/v2/datasets/income-statement",
    headers=headers,
    params={"symbol": "2330", "limit": 8},
)

print(response.json())

Step 3：取得財報指標#

第三步改用財報指標層。這一層是已計算好的分析欄位，適合快速比較與篩選。

你可以優先關注毛利率、營業利益率、ROE 等欄位，快速判讀公司基本面品質。

import requests

headers = {"X-API-Key": "your_api_key_here"}

response = requests.get(
    "https://api.twmarketdata.com/v2/datasets/financial-metrics",
    headers=headers,
    params={"ticker": "2330", "period": "quarterly", "limit": 8},
)

print(response.json())

Step 4：補充月營收趨勢#

第四步補上月營收，用較高頻的資料觀察近期營運變化。

如果財報顯示長期結構，而月營收可以補足短期變化，兩者一起看通常更完整。

import requests

headers = {"X-API-Key": "your_api_key_here"}

response = requests.get(
    "https://api.twmarketdata.com/v2/datasets/monthly-revenue",
    headers=headers,
    params={"symbol": "2330", "limit": 24},
)

print(response.json())

Step 5：整合成基本面檢查流程#

把前面四步整合後，你可以建立一個固定的基本面檢查順序：

先查 issuer-profile，確認公司識別
再查 income-statement，取得原始財報數據
再查 financial-metrics，快速做分析判讀
最後補 monthly-revenue，觀察近期營運趨勢
若要進一步策略化，建議把這套流程落地成可重複執行的 pipeline。

Next Steps#

完成基本面流程後，可繼續：

搭配股價資料做事件前後對照：/docs/api/market-prices/twse-daily-price（或 TPEx 日線價格）
搭配查詢工具做批量拉取：/docs/api/query-tools/query-api
搭配 Explainability 驗證欄位與來源：/docs/api/query-tools/explainability
延伸到策略場景：/docs/workflows/strategy-ai