市場與價格

TPEx 日線價格

提供上櫃股票日線價格資料,適合用於回測、研究與事件對照流程。

GET/v2/datasets/tpex-daily-price

Overview#

TPEx 日線價格 API 提供上櫃股票的日線 OHLCV 與成交相關欄位,適合用於策略回測、研究與事件對照。

資料以未還原(unadjusted)日線為主,日期語意採 Asia/Taipei 交易日。

  • 建立上櫃股票歷史價格序列。
  • 觀察事件前後的價格與成交量變化。
  • 作為技術指標與特徵工程上游資料來源。
  • 與其他市場資料進行跨資料集對照分析。

Request#

使用此 endpoint 時,建議:

Query Parameters#

欄位型別Required說明
symbolstringyes股票代碼(內部對應 ticker)。
start_datestringno查詢起始日期(YYYY-MM-DD)。
end_datestringno查詢結束日期(YYYY-MM-DD)。
limitintegerno回傳筆數(預設 100,最大 5000)。

Response Shape#

回應結構固定為 dataset、rows、count,並附 meta(plan/row_limit/is_limited)。

{
  "dataset": "tpex_daily_price",
  "rows": [
    {
      "symbol": "8069",
      "date": "2026-04-22",
      "open": 32.1,
      "high": 32.9,
      "low": 31.8,
      "close": 32.6,
      "volume_shares": 2745000,
      "turnover_value": 89340000,
      "trade_count": 3241,
      "price_change": 0.5,
      "price_change_sign": "+"
    }
  ],
  "count": 1,
  "meta": {
    "plan": "free",
    "row_limit": 50,
    "is_limited": false
  }
}

Field 說明#

欄位路徑型別說明
rows[].symbolstring股票代碼。
rows[].datestring交易日期(YYYY-MM-DD)。
rows[].opennumber開盤價。
rows[].highnumber最高價。
rows[].lownumber最低價。
rows[].closenumber收盤價。
rows[].volume_sharesnumber成交股數。
rows[].turnover_valuenumber|null成交金額。
rows[].trade_countnumber|null成交筆數。
rows[].price_changenumber|null漲跌價差。
rows[].price_change_signstring|null漲跌符號(+/-)。
countinteger回傳資料筆數。
meta.planstring目前方案代碼。
meta.row_limitinteger方案每次請求可回傳上限。
meta.is_limitedboolean是否因方案限制而截斷資料。

Usage Notes / 使用建議#

  • 此頁為主公開 endpoint 契約;不要與 legacy/canonical 回應格式混用。
  • canonical/supplemental surface 補充:`/v2/datasets/market-prices`。
  • 若需要權值事件調整後序列,請改用對應 adjusted/canonical 路徑。
  • 若需要較低層 canonical payload(含 envelope 與 lineage),請參考「市場價格(Canonical)」與「調整價格(Canonical)」。

Plan Requirement#

  • Free(限制)
  • Developer
  • Pro
  • Enterprise