AI agent？先讀 /llms.txt 取得全站索引。
市場結構與參考
因子庫(座標):橫斷面股票因子『值』(規模/價值/動能/品質/低波動族),每筆為某股某日某因子之原始因子值、族別、定義與公式版本。因子值僅為座標:無訊號、無評分、無買賣標籤。非預測、非建議。
GET /v2/datasets/factor-library即將開放——此資料集建置中,尚未可透過 API 查詢。下方涵蓋與誠實限制為真實資料庫狀態;serving 上線(預計 8/1)後脫離「建置中」。
| 欄位 | 型別 | 說明 |
|---|---|---|
factor_name | text | e.g. dividend_yield_z |
factor_value | numeric | raw coordinate |
factor_family | enum | size/value/momentum/quality/low_vol |
factor_definition | text | |
formula_version | text | |
as_of_source_date | date | PIT input date |
276,456 列,2026-05-08 至 2026-05-28(三週原型窗,尚非長期歷史)。factor_value 為原始座標;as_of_source_date 記錄輸入資料日(point-in-time);formula_version 釘住配方。紅線:設計上零訊號/評分/評級欄。
此為本端點的真實回應。資料列位於 "data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。
{ "dataset_id": "factor-library", "row_count": 3, "data": [ { "ticker": "2330", "trade_date": "2026-05-08", "factor_name": "mom_return_1m_z", "factor_value": 0.36200502, "factor_family": "momentum", "formula_version": "factor_library_v1.0.0", "as_of_source_date": null }, { "ticker": "2330", "trade_date": "2026-05-08", "factor_name": "mom_return_3m_z", "factor_value": 0.47261153, "factor_family": "momentum", "formula_version": "factor_library_v1.0.0", "as_of_source_date": null }, { "ticker": "2330", "trade_date": "2026-05-08", "factor_name": "mom_return_6m_z", "factor_value": 0.54743423, "factor_family": "momentum", "formula_version": "factor_library_v1.0.0", "as_of_source_date": null } ]}擷取自 2026-07-20 的線上 API。
curl "https://api.twmarketdata.com/v2/datasets/factor-library?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/factor-library", 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/factor-library", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["data"]: print(row)此端點為 GET /v2/datasets/factor-library。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。