AI agent?先讀 /llms.txt 取得全站索引。
公司與事件
處置證券期間(預覽)——遭交易所列入處置措施的證券,含處置期間與所施加的交易限制。
GET /v2/datasets/disposition-securities-perioddisposition-securities-period 每筆對證券的處置回傳一列,含處置期間起訖與所施加措施(例如分盤集合競價),來源為官方 TWSE 公告。此為私測預覽,涵蓋為部分。每列附來源角色與回溯上游揭露的 lineage。
| 欄位 | 型別 | 說明 |
|---|---|---|
symbol | string | 股票代碼。 |
period_start | string | 處置期間起日。 |
period_end | string | 處置期間迄日。 |
measure | string | 處置期間所施加之交易限制。 |
source_role | string | 正規來源角色(official_twse_disposition)。 |
lineage | object | 處置所屬的上游權威來源與發布。 |
| 列數 | 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。
本頁顯示原始中文值;英文頁會以標記取代,以維持全英文。
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 | 回傳筆數上限。 |
第一個呼叫:
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)此端點為 GET /v2/datasets/disposition-securities-period。完整機器可讀 schema(參數、認證、回應封裝)見 OpenAPI spec。