TW Market Data LogoTW Market Data

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

公司與事件

GHG 碳揭露（範疇1/2/3）

上市公司申報的溫室氣體揭露：範疇一、二、三排放量與查證標記，取自 TWSE 開放資料並逐列附來源軌跡。非 TESG 評分。

衍生來源: TWSE·方案: developer·計費: 3 點·GET /v2/datasets/esg-ghg-carbon-disclosure

GHG 碳揭露（範疇1/2/3）是台灣市場資料集,來源為 TWSE,由 TW Market Data 以 GET /v2/datasets/esg-ghg-carbon-disclosure 提供。

總覽

上市公司申報的溫室氣體揭露：範疇一、二、三的排放量（噸CO2e），以及各範疇是否取得外部查證的標記。每列對應一家公司、一個報告年度、一個指標，並帶 lineage 標明來自哪一支 TWSE 開放資料端點與哪一個原始欄位。兩項限制明講不藏：此來源為當期快照、非完整歷史；內容僅涵蓋溫室氣體揭露。這不是 TESG 評分，也不宣稱與付費商業 ESG 評分對等。

欄位型別說明
tickerstring股票代號。回應欄位名為 ticker，不是 symbol。
marketstring掛牌市場，例如 TWSE。
report_yearnumber該筆揭露所屬的報告年度。
as_of_datestring該列所屬的快照日期。
subfamilystring揭露分族；此資料集為 ghg_carbon_disclosure。
metric_namestring此列對應的指標名稱，例如 scope1_emissions_tco2e 或 scope1_assurance。
metric_valuestring指標值，字串型別。排放量為數值字串；查證欄位為「是」／「否」。
metric_unitnull指標單位；排放量為「噸CO2e」，非數值指標為 null。
disclosure_statusstring該公司是否揭露此指標。

涵蓋範圍

列數10,088
涵蓋起訖2026-06-05（單日快照）
分級衍生

範例回應

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

{  "dataset_id": "esg_tesg",  "request_context": {    "scope": "esg_tesg_official_open_ghg_only",    "coverage_type": "official_open_current_snapshot_only",    "filters": {      "ticker": "3189",      "market": null,      "report_year": null,      "as_of_date": null,      "subfamily": null,      "metric_name": null,      "disclosure_status": null,      "source_family": null,      "limit": 50    },    "min_as_of_date": "2026-06-05",    "max_as_of_date": "2026-07-31"  },  "quality": {    "row_count": 12,    "ticker_count": 1,    "sensitive_fields_exposed": false  },  "lineage": {    "source_providers": [      "twse_official"    ],    "source_roles": [      "esg_tesg_official_open"    ],    "source_families": [      "twse_ghg"    ]  },  "error": null,  "data": [    {      "ticker": "3189",      "market": "TWSE",      "report_year": 2025,      "as_of_date": "2026-07-31",      "subfamily": "ghg_carbon_disclosure",      "metric_name": "scope1_assurance",      "metric_value": "是",      "metric_unit": null,      "disclosure_status": "disclosed",      "source_provider": "twse_official",      "source_role": "esg_tesg_official_open",      "source_family": "twse_ghg",      "lineage": {        "row_index": 570,        "source_url": "https://openapi.twse.com.tw/v1/opendata/t187ap46_L_1",        "source_column": "範疇一取得驗證"      },      "data_gaps": [],      "not_investment_advice": true    },    {      "ticker": "3189",      "market": "TWSE",      "report_year": 2025,      "as_of_date": "2026-07-31",      "subfamily": "ghg_carbon_disclosure",      "metric_name": "scope1_emissions_tco2e",      "metric_value": "14994.1581",      "metric_unit": "噸CO2e",      "disclosure_status": "disclosed",      "source_provider": "twse_official",      "source_role": "esg_tesg_official_open",      "source_family": "twse_ghg",      "lineage": {        "row_index": 570,        "source_url": "https://openapi.twse.com.tw/v1/opendata/t187ap46_L_1",        "source_column": "範疇一排放量(噸CO2e)"      },      "data_gaps": [],      "not_investment_advice": true    }  ],  "data_count": 12,  "known_gaps": [    "official_open_current_snapshot_only",    "ghg_only_initial_baseline",    "no_paid_commercial_tesg_parity_claim"  ],  "warnings": [    "not_investment_advice"  ],  "not_investment_advice": true,  "envelope": {    "dataset_id": "esg_tesg",    "scope": "esg_tesg_official_open_ghg_only",    "row_count": 12  }}

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

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

出處

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

source_providersource_rolesource_familylineagedata_gapsnot_investment_advice

相關資料集

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

快速開始

  1. 把你的金鑰放進 X-API-Key 標頭。
  2. 加上查詢參數（symbol、日期區間、limit）。
  3. 送出請求並讀取 data 陣列。
curl "https://api.twmarketdata.com/v2/datasets/esg-ghg-carbon-disclosure?symbol=2330" \  -H "X-API-Key: sk_live_..."

篩選參數

參數必填型別說明
symbol是string股票代碼，例如 2330。
start_date否string (YYYY-MM-DD)查詢起始日期。
end_date否string (YYYY-MM-DD)查詢結束日期。
limit否integer回傳筆數上限。

Python 範例

第一個呼叫：

import requests resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/esg-ghg-carbon-disclosure",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json()["data"])

帶日期區間篩選：

import requests # The full verified example — the same call with every supported filter set.resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/esg-ghg-carbon-disclosure",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["data"]:    print(row)

OpenAPI

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

備註與限制

  • 三項限制直接取自回應自帶的 known_gaps，不是推測：此來源為當期快照，不是可查詢的歷史區間；涵蓋範圍僅止於溫室氣體基線，不含完整永續揭露；且不宣稱與付費商業 ESG 評分對等。數值是公司自行申報的原始數字，附來源軌跡原樣提供，不是我們計算出來的評分。