TW Market Data LogoTW Market Data

核心資料

市場與價格

TWSE / TPEx 日線、還原價格、指數與市場廣度

財務與成長

月營收、財報三表、財務指標與估值資料

籌碼與資金

三大法人與融資融券資料

公司與結構

公司與事件

公司基本資料、公告、事件、公司行動與股利

分類與結構

主題分類、指數分類與跨資料集 mapping

策略與量化

Features、Factor Data、Time Alignment 與 Screener

平台能力

API 存取

REST API、認證與第一個 request

查詢與工具

Search API、Query API、欄位清單與查詢範例

Tools / MCP

Agent workflow、MCP tools 與 OpenAPI 入口

方案價格文件觀點文章
EN儀表板

TW Market Data(TWMD)提供之歷史資料與統計,非投資建議;投資決策與風險由您自行判斷。

隱私政策|服務條款|幫助中心||EN|TW Market Data © 2026

文件總覽

DASHBOARD

儀表板定價

FOR AI AGENTS

MCP Serverllms.txt工具清單OpenAPI SpecAgent 工作流範例
Webhooks建置中

OVERVIEW

總覽快速開始認證來源政策資料分級資料血緣市場覆蓋

DATA APIS

利率快照景氣指標(月)全球總經世界銀行總經

GUIDES

如何取得財報三表如何查三大法人籌碼如何看市場狀態如何接策略・AI Agent

SDKS

Release StatusPython SDKJavaScript / TypeScript SDK

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

總體經濟

景氣指標(月)

國家發展委員會(NDC)景氣指標——每月景氣對策信號,以及領先與同時綜合指數。

已驗證來源: NDC·方案: max·計費: 2 點·GET /v2/datasets/business-indicator-monthly

總覽

business-indicator-monthly 以國家發展委員會(NDC)景氣指標發布為源,每個指標每個月份回傳一列;每列附來源角色與 lineage,任一數值可回溯到 NDC 當月原始發布,而非僅憑信任。

欄位型別說明
indicatorstring指標代碼(如 monitoring_signal、leading_index、coincident_index)。
periodstring資料月份(YYYY-MM)。
valuenumber當月指標值(指數水準或信號分數)。
source_rolestring正規來源角色(official_ndc_business_indicator)。
lineageobject上游端點與權威來源(如 NDC 景氣對策信號發布)。

涵蓋範圍

列數608
涵蓋起訖2020-01-01 至 2026-04-01
分級已驗證

範例回應

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

{  "api_version": "v2",  "endpoint": "/v2/datasets/business-indicator-monthly",  "request_id": "req_e3fc727c2a9c",  "plan_id": "enterprise",  "dataset": "business_indicator_monthly",  "dataset_id": "business_indicator_monthly",  "request_context": {    "scope": "monthly_macro_business_cycle_only",    "coverage_type": "monthly_2020_2026_baseline",    "filters": {      "indicator_code": null,      "indicator_name": null,      "month_from": null,      "month_to": null,      "source_family": null,      "limit": 50    },    "min_indicator_month": "2025-10-01",    "max_indicator_month": "2026-04-01"  },  "quality": {    "row_count": 50,    "indicator_count": 8,    "raw_payload_exposed": false  },  "lineage": {    "source_providers": [      "ndc_official"    ],    "source_roles": [      "official_business_indicator_monthly"    ],    "source_families": [      "ndc_business_indicator_signal_csv"    ]  },  "error": null,  "data": [    {      "indicator_month": "2026-04-01",      "indicator_code": "coincident_composite_index",      "indicator_name": "同時指標綜合指數",      "value": 134.730496,      "value_text": "134.7304956",      "value_numeric": 134.730496,      "signal_light": null,      "unit": null,      "source_provider": "ndc_official",      "source_role": "official_business_indicator_monthly",      "source_family": "ndc_business_indicator_signal_csv",      "lineage": {        "date_raw": "202604",        "source_url": "ndc_download_ashx_zip",        "source_file": "景氣指標與燈號.csv",        "normalization": "wide_csv_to_month_indicator_rows"      },      "data_gaps": []    },    {      "indicator_month": "2026-04-01",      "indicator_code": "coincident_index_without_trend",      "indicator_name": "同時指標不含趨勢指數",      "value": 107.572161,      "value_text": "107.5721614",      "value_numeric": 107.572161,      "signal_light": null,      "unit": null,      "source_provider": "ndc_official",      "source_role": "official_business_indicator_monthly",      "source_family": "ndc_business_indicator_signal_csv",      "lineage": {        "date_raw": "202604",        "source_url": "ndc_download_ashx_zip",        "source_file": "景氣指標與燈號.csv",        "normalization": "wide_csv_to_month_indicator_rows"      },      "data_gaps": []    }  ],  "data_count": 50,  "known_gaps": [    "monthly_macro_business_cycle_only",    "not_company_fundamentals",    "not_industry_chain_reference"  ],  "data_gaps": [    "monthly_macro_business_cycle_only",    "not_company_fundamentals",    "not_industry_chain_reference"  ],  "query": {    "indicator_code": null,    "indicator_name": null,    "month_from": null,    "month_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": "business_indicator_monthly",    "request_context": {      "scope": "monthly_macro_business_cycle_only",      "coverage_type": "monthly_2020_2026_baseline",      "filters": {        "indicator_code": null,        "indicator_name": null,        "month_from": null,        "month_to": null,        "source_family": null,        "limit": 50      },      "min_indicator_month": "2025-10-01",      "max_indicator_month": "2026-04-01"    },    "quality": {      "row_count": 50,      "indicator_count": 8,      "raw_payload_exposed": false    },    "lineage": {      "source_providers": [        "ndc_official"      ],      "source_roles": [        "official_business_indicator_monthly"      ],      "source_families": [        "ndc_business_indicator_signal_csv"      ]    },    "error": null,    "data": [      {        "indicator_month": "2026-04-01",        "indicator_code": "coincident_composite_index",        "indicator_name": "同時指標綜合指數",        "value": 134.730496,        "value_text": "134.7304956",        "value_numeric": 134.730496,        "signal_light": null,        "unit": null,        "source_provider": "ndc_official",        "source_role": "official_business_indicator_monthly",        "source_family": "ndc_business_indicator_signal_csv",        "lineage": {          "date_raw": "202604",          "source_url": "ndc_download_ashx_zip",          "source_file": "景氣指標與燈號.csv",          "normalization": "wide_csv_to_month_indicator_rows"        },        "data_gaps": []      },      {        "indicator_month": "2026-04-01",        "indicator_code": "coincident_index_without_trend",        "indicator_name": "同時指標不含趨勢指數",        "value": 107.572161,        "value_text": "107.5721614",        "value_numeric": 107.572161,        "signal_light": null,        "unit": null,        "source_provider": "ndc_official",        "source_role": "official_business_indicator_monthly",        "source_family": "ndc_business_indicator_signal_csv",        "lineage": {          "date_raw": "202604",          "source_url": "ndc_download_ashx_zip",          "source_file": "景氣指標與燈號.csv",          "normalization": "wide_csv_to_month_indicator_rows"        },        "data_gaps": []      }    ],    "known_gaps": [      "monthly_macro_business_cycle_only",      "not_company_fundamentals",      "not_industry_chain_reference"    ],    "warnings": [      "not_investment_advice"    ],    "envelope": {      "dataset_id": "business_indicator_monthly",      "scope": "monthly_macro_business_cycle_only",      "row_count": 50    }  }}

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

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

快速開始

  1. 把你的金鑰放進 X-API-Key 標頭。
  2. 加上查詢參數(symbol、日期區間、limit)。
  3. 送出請求並讀取 data 陣列。
curl "https://api.twmarketdata.com/v2/datasets/business-indicator-monthly?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/business-indicator-monthly",    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/business-indicator-monthly",    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/business-indicator-monthly。完整機器可讀 schema(參數、認證、回應封裝)見 OpenAPI spec。

備註與限制

  • 此總經資料集的 symbol 參數為 NDC 指標代碼(如 monitoring_signal),非股票代碼。
  • 每月更新:NDC 於落後一段時間後公布上一月景氣指標,故最新可得月份會落後於當前月份。

請求與回應

請求

curl "https://api.twmarketdata.com/v2/datasets/business-indicator-monthly?symbol=2330&start_date=2026-01-01&end_date=2026-06-30&limit=5" \  -H "X-API-Key: $TWMD_API_KEY"

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

回應

JSON
{  "api_version": "v2",  "endpoint": "/v2/datasets/business-indicator-monthly",  "request_id": "req_e3fc727c2a9c",  "plan_id": "enterprise",  "dataset": "business_indicator_monthly",  "dataset_id": "business_indicator_monthly",  "request_context": {    "scope": "monthly_macro_business_cycle_only",    "coverage_type": "monthly_2020_2026_baseline",    "filters": {      "indicator_code": null,      "indicator_name": null,      "month_from": null,      "month_to": null,      "source_family": null,      "limit": 50    },    "min_indicator_month": "2025-10-01",    "max_indicator_month": "2026-04-01"  },  "quality": {    "row_count": 50,    "indicator_count": 8,    "raw_payload_exposed": false  },  "lineage": {    "source_providers": [      "ndc_official"    ],    "source_roles": [      "official_business_indicator_monthly"    ],    "source_families": [      "ndc_business_indicator_signal_csv"    ]  },  "error": null,  "data": [    {      "indicator_month": "2026-04-01",      "indicator_code": "coincident_composite_index",      "indicator_name": "同時指標綜合指數",      "value": 134.730496,      "value_text": "134.7304956",      "value_numeric": 134.730496,      "signal_light": null,      "unit": null,      "source_provider": "ndc_official",      "source_role": "official_business_indicator_monthly",      "source_family": "ndc_business_indicator_signal_csv",      "lineage": {        "date_raw": "202604",        "source_url": "ndc_download_ashx_zip",        "source_file": "景氣指標與燈號.csv",        "normalization": "wide_csv_to_month_indicator_rows"      },      "data_gaps": []    },    {      "indicator_month": "2026-04-01",      "indicator_code": "coincident_index_without_trend",      "indicator_name": "同時指標不含趨勢指數",      "value": 107.572161,      "value_text": "107.5721614",      "value_numeric": 107.572161,      "signal_light": null,      "unit": null,      "source_provider": "ndc_official",      "source_role": "official_business_indicator_monthly",      "source_family": "ndc_business_indicator_signal_csv",      "lineage": {        "date_raw": "202604",        "source_url": "ndc_download_ashx_zip",        "source_file": "景氣指標與燈號.csv",        "normalization": "wide_csv_to_month_indicator_rows"      },      "data_gaps": []    }  ],  "data_count": 50,  "known_gaps": [    "monthly_macro_business_cycle_only",    "not_company_fundamentals",    "not_industry_chain_reference"  ],  "data_gaps": [    "monthly_macro_business_cycle_only",    "not_company_fundamentals",    "not_industry_chain_reference"  ],  "query": {    "indicator_code": null,    "indicator_name": null,    "month_from": null,    "month_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": "business_indicator_monthly",    "request_context": {      "scope": "monthly_macro_business_cycle_only",      "coverage_type": "monthly_2020_2026_baseline",      "filters": {        "indicator_code": null,        "indicator_name": null,        "month_from": null,        "month_to": null,        "source_family": null,        "limit": 50      },      "min_indicator_month": "2025-10-01",      "max_indicator_month": "2026-04-01"    },    "quality": {      "row_count": 50,      "indicator_count": 8,      "raw_payload_exposed": false    },    "lineage": {      "source_providers": [        "ndc_official"      ],      "source_roles": [        "official_business_indicator_monthly"      ],      "source_families": [        "ndc_business_indicator_signal_csv"      ]    },    "error": null,    "data": [      {        "indicator_month": "2026-04-01",        "indicator_code": "coincident_composite_index",        "indicator_name": "同時指標綜合指數",        "value": 134.730496,        "value_text": "134.7304956",        "value_numeric": 134.730496,        "signal_light": null,        "unit": null,        "source_provider": "ndc_official",        "source_role": "official_business_indicator_monthly",        "source_family": "ndc_business_indicator_signal_csv",        "lineage": {          "date_raw": "202604",          "source_url": "ndc_download_ashx_zip",          "source_file": "景氣指標與燈號.csv",          "normalization": "wide_csv_to_month_indicator_rows"        },        "data_gaps": []      },      {        "indicator_month": "2026-04-01",        "indicator_code": "coincident_index_without_trend",        "indicator_name": "同時指標不含趨勢指數",        "value": 107.572161,        "value_text": "107.5721614",        "value_numeric": 107.572161,        "signal_light": null,        "unit": null,        "source_provider": "ndc_official",        "source_role": "official_business_indicator_monthly",        "source_family": "ndc_business_indicator_signal_csv",        "lineage": {          "date_raw": "202604",          "source_url": "ndc_download_ashx_zip",          "source_file": "景氣指標與燈號.csv",          "normalization": "wide_csv_to_month_indicator_rows"        },        "data_gaps": []      }    ],    "known_gaps": [      "monthly_macro_business_cycle_only",      "not_company_fundamentals",      "not_industry_chain_reference"    ],    "warnings": [      "not_investment_advice"    ],    "envelope": {      "dataset_id": "business_indicator_monthly",      "scope": "monthly_macro_business_cycle_only",      "row_count": 50    }  }}

擷取自對此端點的真實呼叫,非手寫。

此資料集的資料列在 "data" 之下。各資料集的信封不同,請以本頁為準,勿沿用其他頁的形狀。

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