Cookies 使用設定
我們使用必要 cookies 維持登入與安全，並使用分析 cookies 改善產品體驗。不會用於廣告追蹤。了解更多
文件
Security Master read-only API，提供 AI-friendly 身分、覆蓋、血緣與資料缺口上下文。
公司主檔
/v2/datasets/security-masterSecurity Master 提供股票身分主檔（ticker/market/security_type）與 AI context packet，支援 research assistant、agent orchestration 與 dataset coverage 決策。
此頁同步兩個 read-only endpoint：`/v2/datasets/security-master`（列表）與 `/v2/securities/{ticker}`（單一查詢）。
此 endpoint 常見使用情境：
建議接入步驟：
curl -G "https://api.twmarketdata.com/v2/datasets/security-master" \ -H "X-API-Key: your_api_key_here" \ --data-urlencode "market=TWSE" \ --data-urlencode "active_only=true" \ --data-urlencode "limit=20" \ --data-urlencode "include_ai_context=true"| 欄位 | 型別 | Required | 說明 |
|---|---|---|---|
| market | string | no | 市場別篩選（TWSE / TPEx）。可用於列表與單一 ticker 查詢。 |
| ticker | string | no | 列表 route 的 ticker 篩選條件（lookup route 用 path ticker）。 |
| active_only | boolean | no | 僅回傳 active 標的，預設 true（dataset route）。 |
| limit | integer | no | dataset route 回傳筆數上限。 |
| include_ai_context | boolean | no | dataset route 是否回傳 AI context packet（預設 true）。 |
| include_coverage | boolean | no | lookup route 是否包含 dataset_coverage（預設 true）。 |
| include_data_gaps | boolean | no | lookup route 是否包含 data_gaps（預設 true）。 |
回應重點 section：`security_identity`、`market_identity`、`dataset_coverage`、`source_lineage`、`data_gaps`。
同時提供 `safe_usage_notes`、`survivorship_bias_warning`、`available_tools_or_endpoints`。
{ "dataset_id": "security-master", "items": [ { "security_identity": {"ticker": "2330", "name_zh": "台灣積體電路製造股份有限公司", "market": "TWSE"}, "market_identity": {"market": "TWSE", "source_provider": "twse_official", "source_role": "official_twse_issuer_profile"}, "dataset_coverage": {"price": "available", "technical_indicators": "available"}, "source_lineage": {"source_policy": "official_first"}, "data_gaps": [], "safe_usage_notes": ["not_investment_advice"], "survivorship_bias_warning": {"enabled": true} } ], "available_tools_or_endpoints": [ {"name": "security_master_lookup", "contract": "security_master_lookup(ticker, market?, include_coverage?, include_data_gaps?)"} ]}| 欄位路徑 | 型別 | 說明 |
|---|---|---|
| items[].security_identity | object | ticker/name/security_type/is_active 等主體識別欄位。 |
| items[].market_identity | object | market/source_provider/source_role/source_confidence。 |
| items[].dataset_coverage | object | 各資料家族可用性（available/held/unknown/partial）。 |
| items[].source_lineage | object | official-first lineage 與來源選擇上下文。 |
| items[].data_gaps | array | 缺口與限制（如 TPEx official source 未整合）。 |
| items[].safe_usage_notes | array | 安全使用註記（含 not_investment_advice）。 |
| survivorship_bias_warning | object | 回測使用風險提示（非完整 PIT lifecycle）。 |
| available_tools_or_endpoints | array | 可用工具/route（含 MCP tool plan 提示）。 |
此 API 屬於 TW Market Data 資料集目錄。 查看資料集總覽