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

股票分割/面額事件增強公司行動ESG(TESG)公司行動下市生命週期處置證券期間公司風險事件事件日曆

GUIDES

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

SDKS

Release StatusPython SDKJavaScript / TypeScript SDK

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

公司與事件

處置證券期間

處置證券期間(預覽)——遭交易所列入處置措施的證券,含處置期間與所施加的交易限制。

參考來源: TWSE·方案: pro·計費: 2 點·GET /v2/datasets/disposition-securities-period

總覽

disposition-securities-period 每筆對證券的處置回傳一列,含處置期間起訖與所施加措施(例如分盤集合競價),來源為官方 TWSE 公告。此為私測預覽,涵蓋為部分。每列附來源角色與回溯上游揭露的 lineage。

欄位型別說明
symbolstring股票代碼。
period_startstring處置期間起日。
period_endstring處置期間迄日。
measurestring處置期間所施加之交易限制。
source_rolestring正規來源角色(official_twse_disposition)。
lineageobject處置所屬的上游權威來源與發布。

涵蓋範圍

列數1,709
涵蓋起訖2012-01-12 至 2026-06-30
分級參考

範例回應

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

{  "api_version": "v2",  "dataset": "disposition_securities_period",  "dataset_version": "v2.0.0-preview",  "release_version": "v2.2026-06-09.preview",  "release_date": "2026-06-09",  "data_as_of": "2026-06-09",  "request_context": {    "ticker": "TWSE",    "as_of_date": "2026-06-09",    "family": "market_structure_corporate_actions",    "field_group_type": "canonical",    "dataset_view": "disposition_securities_period_v1",    "source_table": "disposition_securities_period_items",    "scope": "disposition_securities_period_twse_current_snapshot_only",    "coverage_type": "twse_current_disposition_snapshot",    "snapshot_mode": "current_snapshot_only",    "supported_filter_fields": [      "market",      "ticker",      "date_from"    ],    "market_filter": "TWSE",    "ticker_filter": null,    "date_range": {      "date_from": null,      "date_to": null    }  },  "data": [    {      "ticker": "6890",      "market": "TWSE",      "security_name": "來億-KY",      "disposition_start_date": "2026-06-09",      "disposition_end_date": "2026-06-23",      "disposition_type": "第一次處置",      "disposition_category": "連續三次",      "reason": "1處置原因:該有價證券之交易,連續三個營業日達本公司「公布注意交易資訊」標準。\n2處置期間:自民國一百十五年六月九日起至一百十五年六月二十三日﹝十個營業日,如遇:a有價證券最後交易日在處置期間,僅處置至最後交易日,b有價證券停止買賣、全日暫停交易則順延執行,c開休市日變動則調整處置迄日〕。\n3處置措施:\na以人工管制之撮合終端機執行撮合作業(約每五分鐘撮合一次)。\nb投資人每日委託買賣該有價證券數量單筆達十交易單位或多筆累積達三十交易單位以上時,應就其當日已委託之買賣,向該投資人收取全部之買進價金或賣出證券。\nc信用交易部分,應收足融資自備款或融券保證金。有關信用交易了結部分,則依相關規定辦理。",      "industry": null,      "source_family": "twse_current_disposition_securities_period",      "lineage": {        "note": "提供處置有價證券連結資訊<br>\n1.<a href='notice.html?querytype=2&startDate=20260508&endDate=20260608&stockNo=6890' target='_blank'>處置原因</a>:提供公布日期近一個月之「公布注意交易資訊」數據標準<br>\n2.<a href='https://mopsov.twse.com.tw/mops/web/t146sb05?step=1&firstin=Y&co_id=6890' target='_blank'>公開資訊觀測站</a>:提供財務業務與重大訊息之精華版資訊",        "endpoint": "https://www.twse.com.tw/announcement/punish",        "source_role": "official_current_list",        "source_title": "公布處置有價證券資訊 (115/06/09 至 115/06/09)",        "source_family": "twse_current_disposition_securities_period",        "request_params": {          "endDate": "20260609",          "stockNo": "",          "response": "json",          "startDate": "20260609"        },        "source_provider": "twse_openapi",        "announcement_date": "2026-06-08"      },      "data_gaps": [],      "not_investment_advice": true    },    {      "ticker": "1718",      "market": "TWSE",      "security_name": "中纖",      "disposition_start_date": "2026-06-08",      "disposition_end_date": "2026-06-22",      "disposition_type": "第一次處置",      "disposition_category": "連續三次",      "reason": "1處置原因:該有價證券之交易,連續三個營業日達本公司「公布注意交易資訊」標準。\n2處置期間:自民國一百十五年六月八日起至一百十五年六月二十二日﹝十個營業日,如遇:a有價證券最後交易日在處置期間,僅處置至最後交易日,b有價證券停止買賣、全日暫停交易則順延執行,c開休市日變動則調整處置迄日〕。\n3處置措施:\na以人工管制之撮合終端機執行撮合作業(約每五分鐘撮合一次)。\nb投資人每日委託買賣該有價證券數量單筆達十交易單位或多筆累積達三十交易單位以上時,應就其當日已委託之買賣,向該投資人收取全部之買進價金或賣出證券。\nc信用交易部分,應收足融資自備款或融券保證金。有關信用交易了結部分,則依相關規定辦理。",      "industry": null,      "source_family": "twse_current_disposition_securities_period",      "lineage": {        "note": "提供處置有價證券連結資訊<br>\n1.<a href='notice.html?querytype=2&startDate=20260505&endDate=20260605&stockNo=1718' target='_blank'>處置原因</a>:提供公布日期近一個月之「公布注意交易資訊」數據標準<br>\n2.<a href='https://mopsov.twse.com.tw/mops/web/t146sb05?step=1&firstin=Y&co_id=1718' target='_blank'>公開資訊觀測站</a>:提供財務業務與重大訊息之精華版資訊",        "endpoint": "https://www.twse.com.tw/announcement/punish",        "source_role": "official_current_list",        "source_title": "公布處置有價證券資訊 (115/06/09 至 115/06/09)",        "source_family": "twse_current_disposition_securities_period",        "request_params": {          "endDate": "20260609",          "stockNo": "",          "response": "json",          "startDate": "20260609"        },        "source_provider": "twse_openapi",        "announcement_date": "2026-06-05"      },      "data_gaps": [],      "not_investment_advice": true    }  ],  "quality": {    "freshness_state": "fresh",    "freshness_as_of": "2026-06-09",    "completeness_ratio": 1,    "quality_status": "ready",    "ticker_count": 43  },  "lineage": {    "source_role": "canonical",    "selected_source": "disposition_securities_period",    "fallback_chain": [],    "policy_notes": [      "official/public-first canonical",      "TWSE current snapshot only",      "no historical completeness claim"    ],    "source_families": [      "twse_current_disposition_securities_period"    ]  },  "error": {    "error_code": null,    "error_message": null,    "dataset": "disposition_securities_period",    "request_id": "read-api-20260609",    "blocking_gate": null  },  "dataset_id": "disposition_securities_period",  "data_count": 48,  "known_gaps": [    "twse_only_scope",    "no_tpex_coverage",    "no_historical_completeness"  ],  "warnings": [    "not_investment_advice",    "twse_only_scope"  ],  "not_investment_advice": true}

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

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

快速開始

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

備註與限制

  • 私測預覽:涵蓋為部分且結構在正式上線前可能變動——無處置紀錄意指「未收錄」,而非「從未處置」。
  • 處置期間會限制證券的交易方式:重建過去某日的盤中成交假設時,請套用期間起訖界線。

請求與回應

請求

curl "https://api.twmarketdata.com/v2/datasets/disposition-securities-period?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",  "dataset": "disposition_securities_period",  "dataset_version": "v2.0.0-preview",  "release_version": "v2.2026-06-09.preview",  "release_date": "2026-06-09",  "data_as_of": "2026-06-09",  "request_context": {    "ticker": "TWSE",    "as_of_date": "2026-06-09",    "family": "market_structure_corporate_actions",    "field_group_type": "canonical",    "dataset_view": "disposition_securities_period_v1",    "source_table": "disposition_securities_period_items",    "scope": "disposition_securities_period_twse_current_snapshot_only",    "coverage_type": "twse_current_disposition_snapshot",    "snapshot_mode": "current_snapshot_only",    "supported_filter_fields": [      "market",      "ticker",      "date_from"    ],    "market_filter": "TWSE",    "ticker_filter": null,    "date_range": {      "date_from": null,      "date_to": null    }  },  "data": [    {      "ticker": "6890",      "market": "TWSE",      "security_name": "來億-KY",      "disposition_start_date": "2026-06-09",      "disposition_end_date": "2026-06-23",      "disposition_type": "第一次處置",      "disposition_category": "連續三次",      "reason": "1處置原因:該有價證券之交易,連續三個營業日達本公司「公布注意交易資訊」標準。\n2處置期間:自民國一百十五年六月九日起至一百十五年六月二十三日﹝十個營業日,如遇:a有價證券最後交易日在處置期間,僅處置至最後交易日,b有價證券停止買賣、全日暫停交易則順延執行,c開休市日變動則調整處置迄日〕。\n3處置措施:\na以人工管制之撮合終端機執行撮合作業(約每五分鐘撮合一次)。\nb投資人每日委託買賣該有價證券數量單筆達十交易單位或多筆累積達三十交易單位以上時,應就其當日已委託之買賣,向該投資人收取全部之買進價金或賣出證券。\nc信用交易部分,應收足融資自備款或融券保證金。有關信用交易了結部分,則依相關規定辦理。",      "industry": null,      "source_family": "twse_current_disposition_securities_period",      "lineage": {        "note": "提供處置有價證券連結資訊<br>\n1.<a href='notice.html?querytype=2&startDate=20260508&endDate=20260608&stockNo=6890' target='_blank'>處置原因</a>:提供公布日期近一個月之「公布注意交易資訊」數據標準<br>\n2.<a href='https://mopsov.twse.com.tw/mops/web/t146sb05?step=1&firstin=Y&co_id=6890' target='_blank'>公開資訊觀測站</a>:提供財務業務與重大訊息之精華版資訊",        "endpoint": "https://www.twse.com.tw/announcement/punish",        "source_role": "official_current_list",        "source_title": "公布處置有價證券資訊 (115/06/09 至 115/06/09)",        "source_family": "twse_current_disposition_securities_period",        "request_params": {          "endDate": "20260609",          "stockNo": "",          "response": "json",          "startDate": "20260609"        },        "source_provider": "twse_openapi",        "announcement_date": "2026-06-08"      },      "data_gaps": [],      "not_investment_advice": true    },    {      "ticker": "1718",      "market": "TWSE",      "security_name": "中纖",      "disposition_start_date": "2026-06-08",      "disposition_end_date": "2026-06-22",      "disposition_type": "第一次處置",      "disposition_category": "連續三次",      "reason": "1處置原因:該有價證券之交易,連續三個營業日達本公司「公布注意交易資訊」標準。\n2處置期間:自民國一百十五年六月八日起至一百十五年六月二十二日﹝十個營業日,如遇:a有價證券最後交易日在處置期間,僅處置至最後交易日,b有價證券停止買賣、全日暫停交易則順延執行,c開休市日變動則調整處置迄日〕。\n3處置措施:\na以人工管制之撮合終端機執行撮合作業(約每五分鐘撮合一次)。\nb投資人每日委託買賣該有價證券數量單筆達十交易單位或多筆累積達三十交易單位以上時,應就其當日已委託之買賣,向該投資人收取全部之買進價金或賣出證券。\nc信用交易部分,應收足融資自備款或融券保證金。有關信用交易了結部分,則依相關規定辦理。",      "industry": null,      "source_family": "twse_current_disposition_securities_period",      "lineage": {        "note": "提供處置有價證券連結資訊<br>\n1.<a href='notice.html?querytype=2&startDate=20260505&endDate=20260605&stockNo=1718' target='_blank'>處置原因</a>:提供公布日期近一個月之「公布注意交易資訊」數據標準<br>\n2.<a href='https://mopsov.twse.com.tw/mops/web/t146sb05?step=1&firstin=Y&co_id=1718' target='_blank'>公開資訊觀測站</a>:提供財務業務與重大訊息之精華版資訊",        "endpoint": "https://www.twse.com.tw/announcement/punish",        "source_role": "official_current_list",        "source_title": "公布處置有價證券資訊 (115/06/09 至 115/06/09)",        "source_family": "twse_current_disposition_securities_period",        "request_params": {          "endDate": "20260609",          "stockNo": "",          "response": "json",          "startDate": "20260609"        },        "source_provider": "twse_openapi",        "announcement_date": "2026-06-05"      },      "data_gaps": [],      "not_investment_advice": true    }  ],  "quality": {    "freshness_state": "fresh",    "freshness_as_of": "2026-06-09",    "completeness_ratio": 1,    "quality_status": "ready",    "ticker_count": 43  },  "lineage": {    "source_role": "canonical",    "selected_source": "disposition_securities_period",    "fallback_chain": [],    "policy_notes": [      "official/public-first canonical",      "TWSE current snapshot only",      "no historical completeness claim"    ],    "source_families": [      "twse_current_disposition_securities_period"    ]  },  "error": {    "error_code": null,    "error_message": null,    "dataset": "disposition_securities_period",    "request_id": "read-api-20260609",    "blocking_gate": null  },  "dataset_id": "disposition_securities_period",  "data_count": 48,  "known_gaps": [    "twse_only_scope",    "no_tpex_coverage",    "no_historical_completeness"  ],  "warnings": [    "not_investment_advice",    "twse_only_scope"  ],  "not_investment_advice": true}

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

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

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