EN 登入註冊

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

總體經濟

全球總經

Name: Global macro
Creator: TW Market Data
License: https://twmarketdata.com/zh-TW/legal/licensing

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

← 全球總經資料集總覽

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

全球總經是台灣市場資料集,來源為 International,由 TW Market Data 以 GET /v2/datasets/macro-global 提供。

總覽

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

欄位	型別	說明
`series_id`	string
`series_name`	string
`obs_date`	string
`value`	number	當期指標值。
`unit`	string
`freq`	string
`source_group`	string
`release_role`	string

涵蓋範圍

列數	約 129,585
涵蓋起訖	1939-01-01 – 2026-09-03
分級	已驗證
量測時間	2026-09-04取自資料集登錄表

範例回應

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

{
  "api_version": "v2",
  "endpoint": "/v2/datasets/macro-global",
  "request_id": "req_4348ba16f0a6",
  "plan_id": "enterprise",
  "dataset": "macro_global",
  "dataset_id": "macro_global",
  "request_context": {
    "scope": "global_macro_series",
    "coverage_type": "us_public_domain_original_publishers",
    "filters": {
      "series_id": "DCOILWTICO",
      "series_name": null,
      "source_group": null,
      "date_from": null,
      "date_to": null,
      "source_family": null,
      "limit": 50
    },
    "min_obs_date": "2026-05-14",
    "max_obs_date": "2026-07-27"
  },
  "quality": {
    "row_count": 50,
    "series_count": 1,
    "raw_payload_exposed": false
  },
  "lineage": {
    "source_groups": [
      "EIA"
    ],
    "source_providers": [
      "twse_official"
    ],
    "source_families": [
      "EIA"
    ]
  },
  "error": null,
  "data": [
    {
      "series_id": "DCOILWTICO",
      "series_name": "WTI 原油現貨",
      "obs_date": "2026-07-27",
      "value": 84.25,
      "unit": "usd_bbl",
      "freq": "D",
      "source_group": "EIA",
      "release_role": "actual",
      "source_provider": "twse_official",
      "source_role": "official_eia_wti",
      "source_family": "EIA",
      "lineage": {},
      "data_gaps": []
    },
    {
      "series_id": "DCOILWTICO",
      "series_name": "WTI 原油現貨",
      "obs_date": "2026-07-24",
      "value": 91.74,
      "unit": "usd_bbl",
      "freq": "D",
      "source_group": "EIA",
      "release_role": "actual",
      "source_provider": "twse_official",
      "source_role": "official_eia_wti",
      "source_family": "EIA",
      "lineage": {},
      "data_gaps": []
    }
  ],
  "data_count": 50,
  "known_gaps": [
    "us_public_domain_macro_only",
    "not_taiwan_market_data",
    "fred_cdn_host_blocked_use_original_publishers"
  ],
  "data_gaps": [
    "us_public_domain_macro_only",
    "not_taiwan_market_data",
    "fred_cdn_host_blocked_use_original_publishers"
  ],
  "query": {
    "series_id": "DCOILWTICO",
    "series_name": null,
    "source_group": null,
    "date_from": null,
    "date_to": null,
    "source_family": null,
    "limit": 50
  },
  "meta": {
    "rows_returned": 50,
    "mandatory_contract_fields_present": [
      "data",
      "error",
      "lineage"
    ],
    "plan": "enterprise",
    "row_limit": 100000,
    "is_limited": false
  },
  "warnings": [
    "not_investment_advice"
  ],
  "envelope": {
    "dataset_id": "macro_global",
    "request_context": {
      "scope": "global_macro_series",
      "coverage_type": "us_public_domain_original_publishers",
      "filters": {
        "series_id": "DCOILWTICO",
        "series_name": null,
        "source_group": null,
        "date_from": null,
        "date_to": null,
        "source_family": null,
        "limit": 50
      },
      "min_obs_date": "2026-05-14",
      "max_obs_date": "2026-07-27"
    },
    "quality": {
      "row_count": 50,
      "series_count": 1,
      "raw_payload_exposed": false
    },
    "lineage": {
      "source_groups": [
        "EIA"
      ],
      "source_providers": [
        "twse_official"
      ],
      "source_families": [
        "EIA"
      ]
    },
    "error": null,
    "data": [
      {
        "series_id": "DCOILWTICO",
        "series_name": "WTI 原油現貨",
        "obs_date": "2026-07-27",
        "value": 84.25,
        "unit": "usd_bbl",
        "freq": "D",
        "source_group": "EIA",
        "release_role": "actual",
        "source_provider": "twse_official",
        "source_role": "official_eia_wti",
        "source_family": "EIA",
        "lineage": {},
        "data_gaps": []
      },
      {
        "series_id": "DCOILWTICO",
        "series_name": "WTI 原油現貨",
        "obs_date": "2026-07-24",
        "value": 91.74,
        "unit": "usd_bbl",
        "freq": "D",
        "source_group": "EIA",
        "release_role": "actual",
        "source_provider": "twse_official",
        "source_role": "official_eia_wti",
        "source_family": "EIA",
        "lineage": {},
        "data_gaps": []
      }
    ],
    "known_gaps": [
      "us_public_domain_macro_only",
      "not_taiwan_market_data",
      "fred_cdn_host_blocked_use_original_publishers"
    ],
    "warnings": [
      "not_investment_advice"
    ],
    "envelope": {
      "dataset_id": "macro_global",
      "scope": "global_macro_series",
      "row_count": 50
    }
  }
}

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

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

出處

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

source_providersource_rolesource_familylineagedata_gaps

授權與顯名

本服務部分資料取自政府資料開放平臺(data.gov.tw),依「政府資料開放授權條款-第1版」授權利用。資料提供機關:臺灣證券交易所、證券櫃檯買賣中心、臺灣期貨交易所、臺灣集中保管結算所、國家發展委員會、中央銀行、經濟部統計處、財政部關務署。本服務之加值處理、衍生計算與呈現方式由 TWMD 負責,與各資料提供機關無涉。

引用此資料集

TW Market Data. (n.d.). 全球總經 [Data set]. TW Market Data. Retrieved 2026-09-05, from https://twmarketdata.com/zh-TW/docs/api/macro/macro-global

版本取自資料集自己的 as_of，不是這一頁的產生日期。沒有 as_of 的資料集就不列這個欄位，不會補一個看起來合理的值。驗證簽章

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

快速開始

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

curl "https://api.twmarketdata.com/v2/datasets/macro-global?series_id=GDP" \
  -H "X-API-Key: sk_live_..."

篩選參數

參數	必填	型別	說明
`series_id`	否	string	總體序列代碼，例如 GDP。

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()["data"])

OpenAPI

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

備註與限制

此為國際來源的總經脈絡,非 TWSE 市場資料——用於為台股資料集提供背景,而非交易所資料源。
此總經資料集的 symbol 參數為指標代碼（如 gdp_growth），非股票代碼。
涵蓋範圍近期擴充,新增美國聯邦資金利率(FEDFUNDS)與廣義美元指數(DTWEXBGS);美國 GDP 序列(GDP、GDPC1)已於 2026 年 7 月校正為十億美元,對齊上游 FRED 單位。

請求與回應

請求

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

回應

{
  "api_version": "v2",
  "endpoint": "/v2/datasets/macro-global",
  "request_id": "req_4348ba16f0a6",
  "plan_id": "enterprise",
  "dataset": "macro_global",
  "dataset_id": "macro_global",
  "quality": {
    "row_count": "<number>",
    "series_count": "<number>",
    "raw_payload_exposed": "<boolean>"
  },
  "error": null,
  "data": [
    {
      "series_id": "<string>",
      "series_name": "<string>",
      "obs_date": "<string>",
      "value": "<number>",
      "unit": "<string>",
      "freq": "<string>",
      "source_group": "<string>",
      "release_role": "<string>",
      "source_provider": "<string>",
      "source_role": "<string>",
      "source_family": "<string>",
      "lineage": {},
      "data_gaps": "<array>"
    }
  ],
  "data_count": 50,
  "known_gaps": [
    "<string>"
  ],
  "data_gaps": [
    "<string>"
  ],
  "query": {
    "series_id": "<string>",
    "series_name": "<null>",
    "source_group": "<null>",
    "date_from": "<null>",
    "date_to": "<null>",
    "source_family": "<null>",
    "limit": "<number>"
  },
  "meta": {
    "rows_returned": "<number>",
    "mandatory_contract_fields_present": "<array>",
    "plan": "<string>",
    "row_limit": "<number>",
    "is_limited": "<boolean>"
  },
  "warnings": [
    "<string>"
  ],
  "envelope": {
    "dataset_id": "<string>",
    "request_context": {
      "scope": "<string>",
      "coverage_type": "<string>",
      "filters": "<object>",
      "min_obs_date": "<string>",
      "max_obs_date": "<string>"
    },
    "quality": {
      "row_count": "<number>",
      "series_count": "<number>",
      "raw_payload_exposed": "<boolean>"
    },
    "lineage": {
      "source_groups": "<array>",
      "source_providers": "<array>",
      "source_families": "<array>"
    },
    "error": "<null>",
    "data": "<array>",
    "known_gaps": "<array>",
    "warnings": "<array>",
    "envelope": {
      "dataset_id": "<string>",
      "scope": "<string>",
      "row_count": "<number>"
    }
  }
}