TW Market Data LogoTW Market Data

核心資料

市場與價格

TWSE / TPEx 日線、還原價格、指數與市場廣度

財務與成長

月營收、財報三表、財務指標與估值資料

籌碼與資金

三大法人與融資融券資料

公司與結構

公司與事件

公司基本資料、公告、事件、公司行動與股利

分類與結構

主題分類、指數分類與跨資料集 mapping

策略與量化

Features、Factor Data、Time Alignment 與 Screener

平台能力

API 存取

REST API、認證與第一個 request

查詢與工具

Search API、Query API、欄位清單與查詢範例

Tools / MCP

Agent workflow、MCP tools 與 OpenAPI 入口

方案價格文件觀點文章
EN儀表板

TW Market Data(TWMD)提供之歷史資料與統計,非投資建議;投資決策與風險由您自行判斷。

隱私政策|服務條款|幫助中心||EN|TW Market Data © 2026

文件總覽

DASHBOARD

儀表板定價

FOR AI AGENTS

MCP Serverllms.txt工具清單OpenAPI SpecAgent 工作流範例
Webhooks建置中

OVERVIEW

總覽快速開始認證來源政策資料分級資料血緣市場覆蓋

DATA APIS

基金/ETF 主檔稅籍/商業登記ETF 持股明細

GUIDES

如何取得財報三表如何查三大法人籌碼如何看市場狀態如何接策略・AI Agent

SDKS

Release StatusPython SDKJavaScript / TypeScript SDK

AI agent?先讀 /llms.txt 取得全站索引。

基金與企業情報

基金/ETF 主檔

基金/ETF 主檔——每檔上市基金與 ETF 的參考資料(識別、發行機構、類型)。

參考來源: Issuer·方案: free·計費: 1 點·GET /v2/datasets/fund-etf-metadata

總覽

fund-etf-metadata 為參考型資料集:每檔基金/ETF 一筆紀錄,用於將代碼解析為發行機構與類型。屬 metadata,非價格或資金流時間序列。

欄位型別說明
symbolstring基金/ETF 代碼。
namestring基金/ETF 名稱。
issuerstring發行機構。
fund_typestring基金/ETF 類型。

涵蓋範圍

列數257
涵蓋起訖參考資料,無時間序列
分級參考

範例回應

此為本端點的真實回應。資料列位於 "data" 之下,來源資訊如下方所示;各資料集形狀不盡相同,請以本頁為準。

{  "dataset_id": "fund_etf_metadata",  "request_context": {    "scope": "fund_etf_metadata_latest_snapshot_only",    "coverage_type": "latest_snapshot_only",    "filters": {      "fund_code": null,      "market": null,      "issuer": null,      "fund_type": null,      "source_as_of_date": null,      "source_family": null,      "limit": 50    },    "min_source_as_of_date": "2026-06-04",    "max_source_as_of_date": "2026-06-04"  },  "quality": {    "row_count": 50,    "fund_count": 50,    "sensitive_fields_exposed": false  },  "lineage": {    "source_providers": [      "twse_official"    ],    "source_roles": [      "official_twse_t187ap47_l"    ],    "source_families": [      "twse_fund_etf_metadata"    ]  },  "error": null,  "data": [    {      "fund_code": "00400A",      "market": "TWSE",      "fund_name": "國泰台股動能高息主動式ETF證券投資信託基金",      "issuer": null,      "listing_date": "2026-04-09",      "fund_type": "國內成分證券主動式交易所交易基金(股票)",      "underlying_index": "不適用",      "currency": null,      "source_as_of_date": "2026-06-04",      "source_provider": "twse_official",      "source_role": "official_twse_t187ap47_l",      "source_family": "twse_fund_etf_metadata",      "lineage": {        "depth": "latest_snapshot_only",        "source_name": "t187ap47_L",        "tpex_supplemental_probe_status": "pass"      },      "data_gaps": [        "issuer_not_provided_by_source",        "currency_not_provided_by_source"      ],      "not_investment_advice": true    },    {      "fund_code": "00401A",      "market": "TWSE",      "fund_name": "摩根台灣鑫收益主動式ETF證券投資信託基金",      "issuer": null,      "listing_date": "2026-04-10",      "fund_type": "國內成分證券主動式交易所交易基金(股票)",      "underlying_index": "不適用",      "currency": null,      "source_as_of_date": "2026-06-04",      "source_provider": "twse_official",      "source_role": "official_twse_t187ap47_l",      "source_family": "twse_fund_etf_metadata",      "lineage": {        "depth": "latest_snapshot_only",        "source_name": "t187ap47_L",        "tpex_supplemental_probe_status": "pass"      },      "data_gaps": [        "issuer_not_provided_by_source",        "currency_not_provided_by_source"      ],      "not_investment_advice": true    }  ],  "data_count": 50,  "known_gaps": [    "latest_snapshot_only",    "twse_first_baseline",    "tpex_supplemental_not_full_baseline"  ],  "warnings": [    "not_investment_advice"  ],  "not_investment_advice": true,  "envelope": {    "dataset_id": "fund_etf_metadata",    "scope": "fund_etf_metadata_latest_snapshot_only",    "row_count": 50  }}

擷取自 2026-07-20 的線上 API。

本頁顯示原始中文值;英文頁會以標記取代,以維持全英文。

快速開始

  1. 把你的金鑰放進 X-API-Key 標頭。
  2. 加上查詢參數(symbol、日期區間、limit)。
  3. 送出請求並讀取 data 陣列。
curl "https://api.twmarketdata.com/v2/datasets/fund-etf-metadata?symbol=2330" \  -H "X-API-Key: sk_live_..."

篩選參數

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

Python 範例

第一個呼叫:

import requests resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/fund-etf-metadata",    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/fund-etf-metadata",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["data"]:    print(row)

OpenAPI

此端點為 GET /v2/datasets/fund-etf-metadata。完整機器可讀 schema(參數、認證、回應封裝)見 OpenAPI spec。

請求與回應

請求

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

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

回應

JSON
{  "dataset_id": "fund_etf_metadata",  "request_context": {    "scope": "fund_etf_metadata_latest_snapshot_only",    "coverage_type": "latest_snapshot_only",    "filters": {      "fund_code": null,      "market": null,      "issuer": null,      "fund_type": null,      "source_as_of_date": null,      "source_family": null,      "limit": 50    },    "min_source_as_of_date": "2026-06-04",    "max_source_as_of_date": "2026-06-04"  },  "quality": {    "row_count": 50,    "fund_count": 50,    "sensitive_fields_exposed": false  },  "lineage": {    "source_providers": [      "twse_official"    ],    "source_roles": [      "official_twse_t187ap47_l"    ],    "source_families": [      "twse_fund_etf_metadata"    ]  },  "error": null,  "data": [    {      "fund_code": "00400A",      "market": "TWSE",      "fund_name": "國泰台股動能高息主動式ETF證券投資信託基金",      "issuer": null,      "listing_date": "2026-04-09",      "fund_type": "國內成分證券主動式交易所交易基金(股票)",      "underlying_index": "不適用",      "currency": null,      "source_as_of_date": "2026-06-04",      "source_provider": "twse_official",      "source_role": "official_twse_t187ap47_l",      "source_family": "twse_fund_etf_metadata",      "lineage": {        "depth": "latest_snapshot_only",        "source_name": "t187ap47_L",        "tpex_supplemental_probe_status": "pass"      },      "data_gaps": [        "issuer_not_provided_by_source",        "currency_not_provided_by_source"      ],      "not_investment_advice": true    },    {      "fund_code": "00401A",      "market": "TWSE",      "fund_name": "摩根台灣鑫收益主動式ETF證券投資信託基金",      "issuer": null,      "listing_date": "2026-04-10",      "fund_type": "國內成分證券主動式交易所交易基金(股票)",      "underlying_index": "不適用",      "currency": null,      "source_as_of_date": "2026-06-04",      "source_provider": "twse_official",      "source_role": "official_twse_t187ap47_l",      "source_family": "twse_fund_etf_metadata",      "lineage": {        "depth": "latest_snapshot_only",        "source_name": "t187ap47_L",        "tpex_supplemental_probe_status": "pass"      },      "data_gaps": [        "issuer_not_provided_by_source",        "currency_not_provided_by_source"      ],      "not_investment_advice": true    }  ],  "data_count": 50,  "known_gaps": [    "latest_snapshot_only",    "twse_first_baseline",    "tpex_supplemental_not_full_baseline"  ],  "warnings": [    "not_investment_advice"  ],  "not_investment_advice": true,  "envelope": {    "dataset_id": "fund_etf_metadata",    "scope": "fund_etf_metadata_latest_snapshot_only",    "row_count": 50  }}

擷取自對此端點的真實呼叫,非手寫。

此資料集的資料列在 "data" 之下。各資料集的信封不同,請以本頁為準,勿沿用其他頁的形狀。

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