AI agent？先讀 /llms.txt 取得全站索引。
市場與價格
漲跌停事件:每筆為某股某日某方向鎖於當日漲跌停之事件,含前收、收盤、漲跌幅、套用之 era 幅度、是否鎖至收盤、連續次數、鎖量。衍生自正規化價格+漲跌幅制度沿革。非預測、非建議。
GET /v2/datasets/limit-events即將開放——此資料集建置中,尚未可透過 API 查詢。下方涵蓋與誠實限制為真實資料庫狀態;serving 上線(預計 8/1)後脫離「建置中」。
| 欄位 | 型別 | 說明 |
|---|---|---|
direction | enum | up / down |
prev_close | TWD | not split-adjusted (R-02 pending) |
close | TWD | |
pct_change | ratio | |
limit_pct_applied | ratio | era band |
approx_band_pp | pp | |
locked_at_close | bool | |
consecutive_count | int | |
volume_at_limit | shares |
333,951 列,1994-01-10 至 2026-07-17。除息日已校正(3,228 列以官方限價逐值判定:133 確認、3,095 為除息落差誤判已解旗 limit_confirmed=false)。其餘 330,723 非除息列 method='approx'(era band ±7%/±10%,非逐日精確;前收未除權調整),完整逐日精確待 R-02/D-ticket。
此為本端點的真實回應。資料列位於 "data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。
{ "dataset_id": "limit-events", "row_count": 3, "data": [ { "symbol": "1303", "market": "TWSE", "trade_date": "2026-07-01", "direction": "up", "prev_close": 166.5, "close": 183.0, "pct_change": 0.0990990990990991, "limit_pct_applied": 0.1, "locked_at_close": true, "method": "approx", "limit_confirmed": null }, { "symbol": "1435", "market": "TWSE", "trade_date": "2026-07-01", "direction": "up", "prev_close": 27.35, "close": 30.05, "pct_change": 0.0987202925045704, "limit_pct_applied": 0.1, "locked_at_close": true, "method": "approx", "limit_confirmed": null }, { "symbol": "1447", "market": "TWSE", "trade_date": "2026-07-01", "direction": "up", "prev_close": 7.52, "close": 8.27, "pct_change": 0.0997340425531915, "limit_pct_applied": 0.1, "locked_at_close": true, "method": "approx", "limit_confirmed": null } ]}擷取自 2026-07-20 的線上 API。
curl "https://api.twmarketdata.com/v2/datasets/limit-events?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/limit-events", 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/limit-events", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["data"]: print(row)此端點為 GET /v2/datasets/limit-events。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。