AI agent？先讀 /llms.txt 取得全站索引。
市場結構與參考
權證參考——每檔上市權證的主檔（識別、標的、類型與主要契約條件）。
GET /v2/datasets/warrants-referencewarrants-reference 為參考型資料集:每檔上市權證一筆現用紀錄,用於將權證代碼解析為標的、類型與契約條件。此為現有上市權證的現用快照,非價格或成交時間序列。
| 欄位 | 型別 | 說明 |
|---|---|---|
symbol | string | 權證代碼。 |
warrant_name | string | 權證名稱。 |
underlying_symbol | string | 標的證券代碼。 |
warrant_type | string | 認購／認售與類型。 |
last_trading_date | string | 權證最後交易日。 |
source_role | string | official_twse_warrant_master。 |
| 列數 | 51,570 |
| 涵蓋起訖 | 參考資料，無時間序列 |
| 分級 | 參考 |
此為本端點的真實回應。資料列位於 "data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。
{ "dataset_id": "warrants_reference", "request_context": { "scope": "warrants_reference_latest_snapshot_only", "coverage_type": "latest_snapshot_only", "filters": { "warrant_code": null, "market": null, "underlying_ticker": null, "issuer": null, "warrant_type": null, "source_family": null, "limit": 50 } }, "quality": { "row_count": 50, "warrant_count": 50, "sensitive_fields_exposed": false }, "lineage": { "source_providers": [ "tpex_official" ], "source_roles": [ "official_tpex_warrant_issue" ], "source_families": [ "tpex_warrant_issue" ] }, "error": null, "data": [ { "warrant_code": "700008", "market": "TPEx", "underlying_ticker": "4749", "issuer": null, "warrant_type": "認購", "strike_price": null, "exercise_ratio": null, "listing_date": "2025-10-01", "expiry_date": "2026-06-30", "settlement_style": null, "exercise_style": null, "source_provider": "tpex_official", "source_role": "official_tpex_warrant_issue", "source_family": "tpex_warrant_issue", "lineage": { "depth": "latest_snapshot_only", "source_name": "tpex_warrant_issue" }, "data_gaps": [ "issuer_not_provided_by_source" ], "not_investment_advice": true }, { "warrant_code": "700018", "market": "TPEx", "underlying_ticker": "3324", "issuer": null, "warrant_type": "認購", "strike_price": null, "exercise_ratio": null, "listing_date": "2025-10-01", "expiry_date": "2026-06-30", "settlement_style": null, "exercise_style": null, "source_provider": "tpex_official", "source_role": "official_tpex_warrant_issue", "source_family": "tpex_warrant_issue", "lineage": { "depth": "latest_snapshot_only", "source_name": "tpex_warrant_issue" }, "data_gaps": [ "issuer_not_provided_by_source" ], "not_investment_advice": true } ], "data_count": 50, "known_gaps": [ "latest_snapshot_only", "reference_only_not_daily_quotes", "no_daily_quote_coverage" ], "warnings": [ "not_investment_advice" ], "not_investment_advice": true, "envelope": { "dataset_id": "warrants_reference", "scope": "warrants_reference_latest_snapshot_only", "row_count": 50 }}擷取自 2026-07-20 的線上 API。
本頁顯示原始中文值；英文頁會以標記取代，以維持全英文。
curl "https://api.twmarketdata.com/v2/datasets/warrants-reference?symbol=2330" \ -H "X-API-Key: sk_live_..."| 參數 | 必填 | 型別 | 說明 |
|---|---|---|---|
symbol | 否 | string | 以股票代碼篩選單一標的。 |
limit | 否 | integer | 回傳筆數上限。 |
第一個呼叫：
import requests resp = requests.get( "https://api.twmarketdata.com/v2/datasets/warrants-reference", 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/warrants-reference", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["data"]: print(row)此端點為 GET /v2/datasets/warrants-reference。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。