Return Index Daily API

Overview

Return Index Daily API 提供 TWSE / TPEx total return index daily data。

This dataset is a Total Return Index dataset and should be treated separately from price index datasets such as market-index or index-data.

• 查詢 TWSE / TPEx total return index 的日度序列。
• 在研究流程中保留 total-return 與 price-index 的方法論區隔。
• 作為 official-first 指數回報觀察的 read-only dataset contract。

Coverage

Figures are measured from the DB; unlisted fields defer to docs coverage (coming) — we don't fabricate cell by cell.

Request

使用 `market` 與 `index_id` 指定目標 total return index。

可用 `start_date` / `end_date` 做區間查詢，`limit` 預設 100、最大 500。

Query Parameters

Response Shape

回應提供 daily total return index rows，並附 `request_context.not_investment_advice` 等 safety context。

欄位重點包含 `trade_date`、`market`、`index_id`、`index_name`、`return_index_value`、`source_name`、`source_url`。

{  "dataset": "return_index_daily",  "rows": [    {      "trade_date": "2026-05-29",      "market": "TWSE",      "index_id": "TAIEX_TOTAL_RETURN",      "index_name": "TAIEX Total Return Index",      "return_index_value": 32145.67,      "source_name": "TWSE official",      "source_url": "https://www.twse.com.tw/"    }  ],  "count": 1,  "request_context": {    "endpoint": "/v2/datasets/return-index-daily",    "category": "total_return_index",    "not_investment_advice": true,    "warnings": [      "different_from_price_index",      "not_a_buy_sell_signal"    ]  },  "meta": {    "default_limit": 100,    "max_limit": 500  }}

Field 說明

Usage Notes / 使用建議

• Total Return Index。
• Different from price index。
• Source: TWSE / TPEx official。
• Not investment advice。
• Not a buy/sell signal。
• It should not be compared directly with price index levels without understanding total-return methodology。
• Do not merge this dataset into `market-index`; keep it as a separate endpoint contract.

Limitations & notes

• Coverage is not the full market or full history; the actual range is defined by the coverage table above and the data_gaps in the response.
• Missing data is flagged honestly — we don't fill gaps with estimated values.
• The platform focuses on daily-frequency and fundamental data; it does not provide real-time quotes, intraday bars, or cryptocurrencies.
• TWSE is the verified baseline; TPEx history depth and adjusted prices are currently beta / deferred, flagged per dataset.