處置及注意股

用於查詢公告的處置股與注意股名單。

處置股

Python其他語言

punish

api.punish?

Signature:
    api.punish(
        timeout: int = 5000,
        cb: Callable[[shioaji.data.Punish], NoneType] = None,
    ) -> shioaji.data.Punish

Parameters

timeout: 逾時毫秒
cb:      callback 函式，timeout=0 時使用

punish

GET /api/v1/data/regulatory_punish

屬性

Punish

code (list[str]):            商品代碼
start_date (list[date]):     處置開始日期
end_date (list[date]):       處置結束日期
updated_at (list[datetime]): 更新時間
interval (list[str]):        撮合間隔
unit_limit (list[float]):    單筆委託上限
total_limit (list[float]):   單日委託上限
description (list[str]):     處置內容
announced_date (list[date]): 公告日期

範例

PythonHTTP

In

api.punish()

Out

Punish[86](
    code=["1591", "1595", ...],
    start_date=["2026-05-21", "2026-05-11", ...],
    end_date=["2026-06-03", "2026-05-22", ...],
    updated_at=["2026-05-20T18:18:31", "2026-05-08T18:18:39", ...],
    interval=["25分鐘", "5分鐘", ...],
    unit_limit=[None, 10, ...],
    total_limit=[None, 30, ...],
    description=["...", "...", ...],
    announced_date=["2026-05-20", "2026-05-08", ...]
)

轉成 DataFrame（以 polars 示範）

In

import polars as pl
punish = api.punish()
df = pl.DataFrame(punish.dict())
df.head()

Out

code	start_date	end_date	updated_at	interval	unit_limit	total_limit	description	announced_date
1591	2026-05-21	2026-06-03	2026-05-20T18:18:31	25分鐘	null	null	...	2026-05-20
1595	2026-05-11	2026-05-22	2026-05-08T18:18:39	5分鐘	10	30	...	2026-05-08

In

curl http://localhost:8080/api/v1/data/regulatory_punish

Out

{
  "code": ["1591", "1595", "..."],
  "start_date": ["2026-05-21", "2026-05-11", "..."],
  "end_date": ["2026-06-03", "2026-05-22", "..."],
  "updated_at": ["2026-05-20T18:18:31", "2026-05-08T18:18:39", "..."],
  "interval": ["25分鐘", "5分鐘", "..."],
  "unit_limit": [null, 10, "..."],
  "total_limit": [null, 30, "..."],
  "description": ["...", "...", "..."],
  "announced_date": ["2026-05-20", "2026-05-08", "..."]
}

---

注意股

Python其他語言

notice

api.notice?

Signature:
    api.notice(
        timeout: int = 5000,
        cb: Callable[[shioaji.data.Notice], NoneType] = None,
    ) -> shioaji.data.Notice

Parameters

timeout: 逾時毫秒
cb:      callback 函式，timeout=0 時使用

notice

GET /api/v1/data/regulatory_notice

屬性

Notice

code (list[str]):            商品代碼
updated_at (list[datetime]): 更新時間
close (list[float]):         收盤價
reason (list[str]):          注意交易資訊
announced_date (list[date]): 公告日期

範例

PythonHTTP

In

api.notice()

Out

Notice[2](
    code=["6775", "6990"],
    updated_at=["2026-05-21T17:18:15", "2026-05-21T17:18:15"],
    close=[51.16, 153.29],
    reason=["...", "..."],
    announced_date=["2026-05-21", "2026-05-21"]
)

轉成 DataFrame（以 polars 示範）

In

import polars as pl
notice = api.notice()
df = pl.DataFrame(notice.dict())
df.head()

Out

code	updated_at	close	reason	announced_date
6775	2026-05-21T17:18:15	51.16	...	2026-05-21
6990	2026-05-21T17:18:15	153.29	...	2026-05-21

In

curl http://localhost:8080/api/v1/data/regulatory_notice

Out

{
  "code": ["6775", "6990"],
  "updated_at": ["2026-05-21T17:18:15", "2026-05-21T17:18:15"],
  "close": [51.16, 153.29],
  "reason": ["...", "..."],
  "announced_date": ["2026-05-21", "2026-05-21"]
}