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

市場與價格

市場概況快照

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

市場概況快照——每交易日的市場層級匯總:指數水準、總成交金額與上漲／下跌／平盤家數。

← 市場概況快照資料集總覽

參考來源: TWSE·方案: developer·計費: 2 點·GET /v2/datasets/market-overview-snapshots

市場概況快照是台灣市場資料集,來源為 TWSE,由 TW Market Data 以 GET /v2/datasets/market-overview-snapshots 提供。

總覽

market-overview-snapshots 每個市場每交易日回傳一列匯總,概括全市場——指數水準、總成交金額與上漲、下跌、平盤家數。此為參考型概況面;每列附來源角色,數字可回溯官方發布。歷史回補完成前,涵蓋為部分。

欄位	型別	說明
`market_code`	string
`as_of_date`	string
`index_level`	number
`index_change`	number
`index_change_pct`	number
`advancers`	number	上漲家數。
`decliners`	number	下跌家數。
`unchanged`	number
`turnover_value`	number
`volume_shares`	number
`transaction_count`	null
`listed_count`	null
`traded_count`	null
`market_scope`	string
`currency`	string
`is_placeholder`	boolean

涵蓋範圍

列數	約 4,174
涵蓋起訖	2009-01-05 – 2026-09-04
分級	參考
量測時間	2026-09-04取自資料集登錄表

範例回應

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

{
  "api_version": "v2",
  "dataset": "market_overview_snapshots",
  "dataset_version": "v2.0.0-preview",
  "release_version": "v2.2026-08-03.preview",
  "release_date": "2026-08-03",
  "data_as_of": "2026-08-03",
  "request_context": {
    "ticker": "TWSE",
    "as_of_date": "2026-08-03",
    "family": "taiwan_macro",
    "field_group_type": "canonical",
    "dataset_view": "market_overview_snapshots_v1",
    "scope": "market_overview_snapshots_only",
    "coverage_type": "seeded_anchor_snapshot_set",
    "supported_sort_by": [
      "as_of_date"
    ],
    "supported_filter_fields": [
      "market",
      "as_of_date",
      "date_from"
    ],
    "market_filter": "TWSE",
    "date_range": {
      "date_from": null,
      "date_to": null
    }
  },
  "data": [
    {
      "market_code": "TWSE",
      "as_of_date": "2026-08-03",
      "index_level": 43386.41,
      "index_change": 266.66,
      "index_change_pct": 0.62,
      "advancers": 794,
      "decliners": 472,
      "unchanged": 101,
      "turnover_value": 874370836763,
      "volume_shares": 8862026246,
      "transaction_count": null,
      "listed_count": null,
      "traded_count": null,
      "provider": "twse_official",
      "source_role": "official_market_overview",
      "lineage": {
        "emitter": "build_market_overview_snapshot_candidates",
        "derivation": "index_data_items(TWSE_TAIEX) LEFT JOIN market_breadth_items(TWSE) on as_of_date",
        "source_date": "2026-08-03"
      },
      "data_gaps": [
        "missing_transaction_count_from_approved_inputs",
        "missing_listed_count_from_approved_inputs"
      ],
      "not_investment_advice": true,
      "market_scope": "TWSE",
      "currency": "TWD",
      "is_placeholder": false
    }
  ],
  "quality": {
    "freshness_state": "fresh",
    "freshness_as_of": "2026-08-03",
    "completeness_ratio": 1,
    "quality_status": "ready"
  },
  "lineage": {
    "source_role": "canonical",
    "selected_source": "market_overview_snapshots",
    "fallback_chain": [],
    "policy_notes": [
      "official/public-first canonical",
      "market_overview_snapshots is the seeded anchor surface for index and breadth derivations",
      "not_investment_advice"
    ]
  },
  "error": {
    "error_code": null,
    "error_message": null,
    "dataset": "market_overview_snapshots",
    "request_id": "read-api-20260803",
    "blocking_gate": null
  },
  "dataset_id": "market_overview_snapshots",
  "data_count": 1,
  "known_gaps": [
    "missing_listed_count_from_approved_inputs",
    "missing_transaction_count_from_approved_inputs"
  ],
  "warnings": [
    "not_investment_advice"
  ]
}

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

出處

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

providersource_rolelineagedata_gapsnot_investment_advice

授權與顯名

本服務部分資料取自政府資料開放平臺(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/market-prices/market-overview-snapshots

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

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

指數分類
可用 as_of_date 對齊
市場廣度
可用 as_of_date 對齊
個股市值權重
可用 as_of_date 對齊
技術指標
可用 as_of_date 對齊
估值資料
可用 as_of_date 對齊

快速開始

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

curl "https://api.twmarketdata.com/v2/datasets/market-overview-snapshots?as_of_date=2026-08-03" \
  -H "X-API-Key: sk_live_..."

篩選參數

參數	必填	型別	說明
`market`	否	string	由端點自身在 envelope.request_context.supported_filter_fields 宣告。
`as_of_date`	否	string	由端點自身在 envelope.request_context.supported_filter_fields 宣告。
`date_from`	否	string	由端點自身在 envelope.request_context.supported_filter_fields 宣告。

Python 範例

import requests

resp = requests.get(
    "https://api.twmarketdata.com/v2/datasets/market-overview-snapshots",
    params={"as_of_date": "2026-08-03"},
    headers={"X-API-Key": "sk_live_..."},
)
resp.raise_for_status()
print(resp.json()["data"])

OpenAPI

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

備註與限制

部分涵蓋:此概況面仍在回補,故歷史視窗可能短於逐檔價格資料集。請視為市場層級摘要,而非逐檔證券資料。

請求與回應

請求

curl "https://api.twmarketdata.com/v2/datasets/market-overview-snapshots" \
  -H "X-API-Key: $TWMD_API_KEY"

回應

{
  "api_version": "v2",
  "dataset": "market_overview_snapshots",
  "dataset_version": "v2.0.0-preview",
  "release_version": "v2.2026-08-03.preview",
  "release_date": "2026-08-03",
  "data_as_of": "2026-08-03",
  "data": [
    {
      "market_code": "<string>",
      "as_of_date": "<string>",
      "index_level": "<number>",
      "index_change": "<number>",
      "index_change_pct": "<number>",
      "advancers": "<number>",
      "decliners": "<number>",
      "unchanged": "<number>",
      "turnover_value": "<number>",
      "volume_shares": "<number>",
      "transaction_count": "<null>",
      "listed_count": "<null>",
      "traded_count": "<null>",
      "provider": "<string>",
      "source_role": "<string>",
      "lineage": {
        "emitter": "<string>",
        "derivation": "<string>",
        "source_date": "<string>"
      },
      "data_gaps": "<array>",
      "not_investment_advice": "<boolean>",
      "market_scope": "<string>",
      "currency": "<string>",
      "is_placeholder": "<boolean>"
    }
  ],
  "quality": {
    "freshness_state": "<string>",
    "freshness_as_of": "<string>",
    "completeness_ratio": "<number>",
    "quality_status": "<string>"
  },
  "error": {
    "error_code": "<null>",
    "error_message": "<null>",
    "dataset": "<string>",
    "request_id": "<string>",
    "blocking_gate": "<null>"
  },
  "dataset_id": "market_overview_snapshots",
  "data_count": 1,
  "known_gaps": [
    "<string>"
  ],
  "warnings": [
    "<string>"
  ]
}