tw-finance

以一段查詢字串搜尋本站的 ETF、台股、基金與資料集，回傳可引用的清單（id／title／url）。id 可交給 fetch 取完整內容。A single query string; returns citable results for Taiwan ETFs, stocks, funds and datasets.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "A single query string."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

以 search 回傳的 id 取該筆的完整內容（id／title／text／url／metadata）。A string which is a unique identifier for the search document.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "A string which is a unique identifier for the search document."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

台灣加權指數（TAIEX）最新官方收盤、市場廣度（漲跌家數）、台股情緒分數、台指選擇權 Put/Call 比一次取得。Taiwan market snapshot: TAIEX close, breadth, sentiment, PCR.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

以代號查台灣上市 ETF：名稱/發行投信/追蹤指數/市價/折溢價/費用率等基本資料。Look up a Taiwan-listed ETF by code (e.g. 0050).

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "ETF 代號，如 0050、00878"
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false
}

取 ETF 每日收盤價序列（預設近 12 個月、可調 months 1-120）。Daily close history for a Taiwan ETF.

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string"
    },
    "months": {
      "type": "number",
      "description": "回看月數，預設 12、上限 120"
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false
}

以代號或名稱關鍵字查台灣可銷售基金（境內投信/境外/期信）：最新淨值/淨值日/幣別/類型/總代理/今年以來報酬。Search Taiwan-distributed funds by code or name keyword.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "基金代號（如 T1104Y）或名稱關鍵字（如 摩根 科技）"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

取基金每日淨值序列（預設近 12 個月、可調 months 1-120；境內主級別最深約 10 年）。Daily NAV history for a fund.

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string"
    },
    "months": {
      "type": "number"
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false
}

台股情緒綜合分數（本站自製中性參考、含分項）。不含美股 CNN Fear & Greed（站主裁決不透過 MCP 再散布 CNN 資料，見 /us-sentiment 的公開指標原始值）。Taiwan market sentiment (self-made neutral reference); no CNN F&G.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

國發會景氣燈號：最新月燈號/綜合分數/9 項構成指標逐項檢查值與分數/下期發布日（官方預告）。NDC business climate signal with all 9 components.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

主要貨幣即期匯率（多源交叉：ECB/台銀）含當日與近 1 週/1 月/3 月變化；可指定 pair（如 USD/TWD）。Spot FX rates with multi-period changes.

{
  "type": "object",
  "properties": {
    "pair": {
      "type": "string",
      "description": "貨幣對，如 USD/TWD；省略＝全部"
    }
  },
  "additionalProperties": false
}

列出本站「資料形狀 × 資料集」登錄表：有哪些 point（單值）／series（時間序列）／table（表格）／query（條件篩選＋群體聚合）資料集，各自的單位、識別碼種類、來源與深連結；query 母體另附可用欄位、運算子與可排序鍵。先呼叫本工具，即可組合出後續查詢。Catalog of datasets by shape (point/series/table/query) — call this first to compose queries.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

取「一個標的 × 一個欄位 × 一個時點」的單值，如 0050 的折溢價、基金最新淨值、USD/TWD 匯率、景氣對策信號綜合分數。dataset 取自 data_catalog 的 point 清單；回應必附單位、資料日與來源。Single current value for one security and field.

{
  "type": "object",
  "properties": {
    "dataset": {
      "type": "string",
      "description": "資料集，如 etf.premium／fund.nav／fx.rate（見 data_catalog）"
    },
    "id": {
      "type": "string",
      "description": "標的識別碼，如 0050／T1104Y／USD/TWD；可加前綴消歧義，如 etf:0050、fund:T1104Y"
    }
  },
  "required": [
    "dataset"
  ],
  "additionalProperties": false
}

取「一個標的 × 一個欄位 × 一段時間」的時間序列，如 ETF 日收盤、基金淨值歷史。每點只有日期與值；資料缺口會以 gapNote 誠實標示、不靜默補值。Time series for one security and field.

{
  "type": "object",
  "properties": {
    "dataset": {
      "type": "string",
      "description": "資料集，如 etf.close／fund.nav（見 data_catalog）"
    },
    "id": {
      "type": "string",
      "description": "標的識別碼，如 0050、T1104Y"
    },
    "months": {
      "type": "number",
      "description": "回看月數，預設 12、上限 120"
    }
  },
  "required": [
    "dataset",
    "id"
  ],
  "additionalProperties": false
}

取「一個標的的多列資料」，如 ETF 全成分股與權重、景氣對策信號 9 項構成指標、主要貨幣對一覽。回應含欄位定義（columns）與列（rows），截斷時標 truncated。Multi-row table for one security.

{
  "type": "object",
  "properties": {
    "dataset": {
      "type": "string",
      "description": "資料集，如 etf.holdings／fx.pairs／market.climate.components（見 data_catalog）"
    },
    "id": {
      "type": "string",
      "description": "標的識別碼；母體級表格（如 fx.pairs）免填"
    },
    "limit": {
      "type": "number",
      "description": "回列上限，預設與上限皆為 200"
    }
  },
  "required": [
    "dataset"
  ],
  "additionalProperties": false
}

對一個母體下條件篩出一組標的，並對整組計算聚合統計（count／coverage／min／max／mean／median／sum），如「費用率 0.4% 以下的被動 ETF，其費用率中位數」。where 語法為「欄位 運算子 值」以 and 連接（例 fee<=0.4 and type=passive）。回應必附母體大小 population 與欄位覆蓋率 coverage（有幾檔真的有這個欄位）。注意：績效欄位可用於 where 篩選與聚合統計，但不得作為排序鍵——排序即排名，本站不對個別商品做推薦。Filter a universe and aggregate over the matched set.

{
  "type": "object",
  "properties": {
    "universe": {
      "type": "string",
      "description": "母體，如 etf.tw（見 data_catalog）"
    },
    "where": {
      "type": "string",
      "description": "條件式，如 fee<=0.4 and type=passive；省略＝全母體"
    },
    "aggregate": {
      "type": "string",
      "description": "聚合，如 median:fee,count（逗號分隔、最多 4 個）"
    },
    "sort": {
      "type": "string",
      "description": "排序鍵，只接受中性鍵 code／name／holders（規模/人氣），不接受績效欄位"
    },
    "limit": {
      "type": "number",
      "description": "sample 回列數，預設 10、上限 20"
    }
  },
  "required": [
    "universe"
  ],
  "additionalProperties": false
}