選股器

選股器——衍生便利面,回傳符合一組篩選條件的證券,係基於官方市場與財務資料計算而得。

衍生來源: TWSE / TPEx·方案: pro·計費: 3 點·GET /v2/datasets/screener

總覽

screener 依所給篩選條件,每檔符合的證券回傳一列,係在官方 TWSE／TPEx 市場與財務資料集之上計算而成。它是衍生便利層:底層數值來自官方來源,但符合清單本身由 TWMD 計算,而非交易所發布。

欄位	型別	說明
`symbol`	string	符合證券的股票代碼。
`name`	string	證券名稱。
`matched_filters`	array	此列所滿足的篩選條件。
`as_of`	string	本次篩選計算所依據的資料日期。
`source_role`	string	twmd_derived_screener。

涵蓋範圍

列數	7,625,469
涵蓋起訖	2006-01-02 至 2026-07-16
分級	衍生

範例回應

TODO —— 尚未擷取到此資料集的真實回應（需要有權限的 API 金鑰，或其必填參數尚未確認）。寧可留白，也不顯示未經實測的範例。

快速開始

把你的金鑰放進 X-API-Key 標頭。
加上查詢參數（symbol、日期區間、limit）。
送出請求並讀取回傳內容。

curl "https://api.twmarketdata.com/v2/datasets/screener?symbol=2330" \  -H "X-API-Key: sk_live_..."

篩選參數

參數	必填	型別	說明
`symbol`	否	string	以股票代碼篩選單一標的。
`limit`	否	integer	回傳筆數上限。

Python 範例

第一個呼叫：

import requests resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/screener",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())

帶日期區間篩選：

import requests # The full verified example — the same call with every supported filter set.resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/screener",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())

OpenAPI

此端點為 GET /v2/datasets/screener。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。

備註與限制

係在官方資料之上的衍生／計算便利結果——本身非官方發布清單。結果取決於篩選條件與 as_of 資料日期;固定 as_of 即可重現同一次篩選。

請求與回應

請求

curl "https://api.twmarketdata.com/v2/datasets/screener?symbol=2330&limit=5" \  -H "X-API-Key: $TWMD_API_KEY"

以 X-API-Key 標頭認證，使用儀表板發放的 sk_live_ 金鑰。

回應

TODO —— 尚未擷取到此資料集的真實回應（需要有權限的金鑰，或其必填參數尚未確認）。寧可不顯示範例，也不編造。

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

總覽

欄位	型別	說明
`symbol`	string	符合證券的股票代碼。
`name`	string	證券名稱。
`matched_filters`	array	此列所滿足的篩選條件。
`as_of`	string	本次篩選計算所依據的資料日期。
`source_role`	string	twmd_derived_screener。

參數

必填

型別

說明

symbol

否

string

以股票代碼篩選單一標的。

limit

否

integer

回傳筆數上限。

Python 範例

第一個呼叫：

import requests resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/screener",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())

帶日期區間篩選：

import requests # The full verified example — the same call with every supported filter set.resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/screener",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())