Building an AI agent? Start with /llms.txt for the full site index.
Companies & Events
Disposition securities period (preview) — securities placed under disposition measures by the exchange, with the period and the trading restriction applied.
GET /v2/datasets/disposition-securities-perioddisposition-securities-period returns one row per disposition placed on a security, with the start and end of the disposition period and the measure applied (for example matched-auction throttling), sourced from the official TWSE announcements. This is a private-beta preview with partial coverage. Each row carries its source role and lineage back to the upstream disclosure.
| Field | Type | Description |
|---|---|---|
symbol | string | Ticker. |
period_start | string | Start of the disposition period. |
period_end | string | End of the disposition period. |
measure | string | Trading restriction applied during the period. |
source_role | string | Canonical source role (official_twse_disposition). |
lineage | object | Upstream authority + release for the disposition. |
| Rows | 1,709 |
| Window | 2012-01-12 – 2026-06-30 |
| Grade | Reference |
A real response from this endpoint. Rows are returned under "data", and provenance is carried in the shape shown below — it is not identical across datasets, so read this page's rather than assuming another's.
{ "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": "<Chinese value - see the zh page>", "disposition_start_date": "2026-06-09", "disposition_end_date": "2026-06-23", "disposition_type": "<Chinese value - see the zh page>", "disposition_category": "<Chinese value - see the zh page>", "reason": "<Chinese value - see the zh page>", "industry": null, "source_family": "twse_current_disposition_securities_period", "lineage": { "note": "<Chinese value - see the zh page>", "endpoint": "https://www.twse.com.tw/announcement/punish", "source_role": "official_current_list", "source_title": "<Chinese value - see the zh page>", "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": "<Chinese value - see the zh page>", "disposition_start_date": "2026-06-08", "disposition_end_date": "2026-06-22", "disposition_type": "<Chinese value - see the zh page>", "disposition_category": "<Chinese value - see the zh page>", "reason": "<Chinese value - see the zh page>", "industry": null, "source_family": "twse_current_disposition_securities_period", "lineage": { "note": "<Chinese value - see the zh page>", "endpoint": "https://www.twse.com.tw/announcement/punish", "source_role": "official_current_list", "source_title": "<Chinese value - see the zh page>", "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}Captured from the live API on 2026-07-20.
Chinese data values are shown as a marker here so this page stays in English; the /zh page shows them verbatim.
curl "https://api.twmarketdata.com/v2/datasets/disposition-securities-period?symbol=2330" \ -H "X-API-Key: sk_live_..."| Parameter | Required | Type | Description |
|---|---|---|---|
symbol | Yes | string | Ticker, e.g. 2330. |
start_date | No | string (YYYY-MM-DD) | Start of the query range. |
end_date | No | string (YYYY-MM-DD) | End of the query range. |
limit | No | integer | Maximum rows to return. |
A first call:
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"])With a date-range filter:
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)This endpoint is GET /v2/datasets/disposition-securities-period. The full machine-readable schema (parameters, security, response envelope) lives in the OpenAPI spec.