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

總體經濟

全球總經

彙整自國際機構的全球總體經濟脈絡序列——與台股資料集並列的跨國參考數據。

已驗證來源: International·方案: enterprise·計費: 2 點·GET /v2/datasets/macro-global

總覽

macro-global 針對彙整自國際機構的全球總經序列,每個指標每個期別回傳一列。此為與台股資料並列的國際來源脈絡,非 TWSE 資料源;每列附來源角色與 lineage,上游權威來源清楚標明。

欄位	型別	說明
`indicator`	string	指標代碼（如 gdp_growth、cpi_yoy）。
`country`	string	ISO 國家／地區代碼。
`period`	string	資料期別（YYYY 或 YYYY-MM）。
`value`	number	當期指標值。
`source_role`	string	正規來源角色（international_macro）。
`lineage`	object	數值所屬的上游國際機構與發布。

涵蓋範圍

列數	119,463
涵蓋起訖	1947-01-01 至 2026-07-02
分級	已驗證

範例回應

TODO —— 尚未擷取到此資料集的真實回應（需要有權限的 API 金鑰，或其必填參數尚未確認）。寧可留白，也不顯示未經實測的範例。

快速開始

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

curl "https://api.twmarketdata.com/v2/datasets/macro-global?series_id=GDP" \  -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/macro-global",    params={"series_id": "GDP"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())

帶日期區間篩選：

import requests # The full verified example — the same call with every supported filter set.resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/macro-global",    params={"series_id": "GDP"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())

OpenAPI

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

備註與限制

此為國際來源的總經脈絡,非 TWSE 市場資料——用於為台股資料集提供背景,而非交易所資料源。
此總經資料集的 symbol 參數為指標代碼（如 gdp_growth），非股票代碼。

請求與回應

請求

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

以 X-API-Key 標頭認證，使用儀表板發放的 sk_live_ 金鑰。

回應

TODO —— 尚未擷取到此資料集的真實回應（需要有權限的金鑰，或其必填參數尚未確認）。寧可不顯示範例，也不編造。

本頁的分級徽章屬文件分級，並非回應欄位。

總覽

欄位	型別	說明
`indicator`	string	指標代碼（如 gdp_growth、cpi_yoy）。
`country`	string	ISO 國家／地區代碼。
`period`	string	資料期別（YYYY 或 YYYY-MM）。
`value`	number	當期指標值。
`source_role`	string	正規來源角色（international_macro）。
`lineage`	object	數值所屬的上游國際機構與發布。

參數

必填

型別

說明

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/macro-global",    params={"series_id": "GDP"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())

帶日期區間篩選：

import requests # The full verified example — the same call with every supported filter set.resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/macro-global",    params={"series_id": "GDP"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())