EN 登入註冊

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

市場與價格

報酬指數日線

Name: Return index (daily)
Creator: TW Market Data
License: https://twmarketdata.com/zh-TW/legal/licensing

報酬指數日線——含息（股利再投入）的報酬指數,每個指數每交易日一個水準值。

← 報酬指數日線資料集總覽

衍生來源: TWSE·方案: pro·計費: 1 點·GET /v2/datasets/return-index-daily

報酬指數日線是台灣市場資料集,來源為 TWSE,由 TW Market Data 以 GET /v2/datasets/return-index-daily 提供。

總覽

return-index-daily 每個指數每交易日回傳含息（股利再投入）報酬指數水準。此為由官方價格指數與公司行動輸入計算的推導序列,提供可對比的總報酬衡量;每列附回溯上述官方輸入的 lineage,水準值可稽核。

欄位	型別	說明
`trade_date`	string
`market`	string
`index_id`	string
`index_name`	string
`return_index_value`	string

涵蓋範圍

列數	約 10,846
涵蓋起訖	2003-01-02 – 2026-09-04
分級	衍生
量測時間	2026-09-04取自資料集登錄表

範例回應

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

{
  "generated_at": "2026-08-06T05:14:55Z",
  "dataset_id": "return_index_daily",
  "row_count": 1,
  "rows": [
    {
      "trade_date": "2026-08-05",
      "market": "TPEx",
      "index_id": "TPEX_RETURN_INDEX",
      "index_name": "TPEx Return Index",
      "return_index_value": "711.870000",
      "source_name": "tpex_roe",
      "source_url": "https://www.tpex.org.tw/www/zh-tw/indexInfo/ROE?date=2026/08/15"
    }
  ],
  "filters": {
    "market": null,
    "index_id": null,
    "start_date": "2026-08-05",
    "end_date": "2026-08-05",
    "limit": 50
  },
  "request_context": {
    "not_investment_advice": true,
    "public_exposure": true
  },
  "metadata": {
    "public_exposure": true,
    "data_status": "public_api",
    "default_limit": 100,
    "max_limit": 500,
    "allowed_filters": [
      "market",
      "index_id",
      "start_date"
    ],
    "boundary_module": "feature_engine.read_api.return_index_daily_api_boundary",
    "planned_route": "/v2/datasets/return-index-daily",
    "route_public": true
  },
  "not_investment_advice": true,
  "warnings": [
    "not_investment_advice"
  ]
}

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

出處

以下欄位會隨資料一併回傳,記錄這一列的來源。它們屬於出處而非本資料集要講的事實,因此列在這裡而不進欄位表。

source_namesource_url

授權與顯名

本服務部分資料取自政府資料開放平臺(data.gov.tw),依「政府資料開放授權條款-第1版」授權利用。資料提供機關:臺灣證券交易所、證券櫃檯買賣中心、臺灣期貨交易所、臺灣集中保管結算所、國家發展委員會、中央銀行、經濟部統計處、財政部關務署。本服務之加值處理、衍生計算與呈現方式由 TWMD 負責,與各資料提供機關無涉。

引用此資料集

TW Market Data. (n.d.). 報酬指數日線 [Data set]. TW Market Data. Retrieved 2026-09-05, from https://twmarketdata.com/zh-TW/docs/api/market-prices/return-index-daily

版本取自資料集自己的 as_of，不是這一頁的產生日期。沒有 as_of 的資料集就不列這個欄位，不會補一個看起來合理的值。驗證簽章

可與本資料集對齊的其他資料集。每組都標出可用來 join 的欄位,規劃跨表查詢時不必自己猜。

指數成分股
可用 market + trade_date 對齊
產業別指數日資料
可用 market + trade_date 對齊
漲跌停事件
可用 market + trade_date 對齊
價格調整因子
可用 market + trade_date 對齊
大波動日情境卡
可用 market + trade_date 對齊

快速開始

把你的金鑰放進 X-API-Key 標頭。
加上查詢參數（symbol、日期區間、limit）。
送出請求並讀取 rows 陣列。

curl "https://api.twmarketdata.com/v2/datasets/return-index-daily?start_date=2026-08-05&end_date=2026-08-05" \
  -H "X-API-Key: sk_live_..."

篩選參數

參數	必填	型別	說明
`symbol`	是	string	股票代碼，例如 2330。
`start_date`	否	string (YYYY-MM-DD)	查詢起始日期。
`end_date`	否	string (YYYY-MM-DD)	查詢結束日期。
`limit`	否	integer	回傳筆數上限。

Python 範例

import requests

resp = requests.get(
    "https://api.twmarketdata.com/v2/datasets/return-index-daily",
    params={},
    headers={"X-API-Key": "sk_live_..."},
)
resp.raise_for_status()
print(resp.json()["rows"])

OpenAPI

此端點為 GET /v2/datasets/return-index-daily。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。

備註與限制

此資料集的 symbol 參數為指數代碼（如 IR0001），非股票代碼。報酬水準為推導值——若 TWSE 亦公布官方報酬指數,數值會與其對帳。

請求與回應

請求

curl "https://api.twmarketdata.com/v2/datasets/return-index-daily?symbol=2330&start_date=2026-01-01&end_date=2026-06-30&limit=5" \
  -H "X-API-Key: $TWMD_API_KEY"

回應

{
  "generated_at": "2026-08-06T05:14:55Z",
  "dataset_id": "return_index_daily",
  "row_count": 1,
  "rows": [
    {
      "trade_date": "<string>",
      "market": "<string>",
      "index_id": "<string>",
      "index_name": "<string>",
      "return_index_value": "<string>",
      "source_name": "<string>",
      "source_url": "<string>"
    }
  ],
  "filters": {
    "market": "<null>",
    "index_id": "<null>",
    "start_date": "<string>",
    "end_date": "<string>",
    "limit": "<number>"
  },
  "metadata": {
    "public_exposure": "<boolean>",
    "data_status": "<string>",
    "default_limit": "<number>",
    "max_limit": "<number>",
    "allowed_filters": "<array>",
    "boundary_module": "<string>",
    "planned_route": "<string>",
    "route_public": "<boolean>"
  },
  "not_investment_advice": true,
  "warnings": [
    "<string>"
  ]
}