EN 登入註冊

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

市場與價格

利率

提供台灣市場利率快照資料，適合用於折現參數設定、宏觀條件對照與研究流程。

GET/v2/datasets/interest-rate-snapshot

Overview

利率 API 提供台灣市場利率快照資料，可作為估值折現、風險參數與宏觀條件分析的基礎輸入。

資料對應 canonical topic `interest_rate_snapshot`，對外路徑採 `/v2/datasets/interest-rate-snapshot`。

設定折現率或資金成本參數。
作為宏觀條件過濾器，搭配價格與財務資料做策略檢查。
建立利率變動時間序列並觀察市場反應。

覆蓋範圍

標的數	起始年	更新時點	含已下市
尚未提供（coming）	尚未提供（coming）	尚未提供（coming）	coming

數字為 DB 實測；未列者以 docs coverage 為準（coming），不逐格編造。

Request

使用此 endpoint 時，建議以 as_of_date 查單日快照，或以 date_from/date_to 查歷史區間。若流程需要長期序列，建議先批次落地再下游使用。

Query Parameters

欄位	型別	Required	說明
as_of_date	string	no	指定單一資料日期（YYYY-MM-DD）。
date_from	string	no	查詢起始日期（YYYY-MM-DD）。
date_to	string	no	查詢結束日期（YYYY-MM-DD）。
limit	integer	no	回傳筆數限制。
offset	integer	no	分頁偏移。

Response Shape

回應採 canonical envelope，頂層包含 query/meta，實際資料位於 envelope.data。

{
  "api_version": "v2",
  "endpoint": "/v2/datasets/interest-rate-snapshot",
  "request_id": "req_rates_1a2b3c4d",
  "plan_id": "developer",
  "dataset": "interest_rate_snapshot",
  "query": {
    "as_of_date": null,
    "date_from": "2026-01-01",
    "date_to": "2026-04-30",
    "limit": 30,
    "offset": 0,
    "sort_by": "as_of_date",
    "sort_order": "desc"
  },
  "meta": {
    "rows_returned": 1
  },
  "envelope": {
    "api_version": "v2",
    "dataset": "interest_rate_snapshot",
    "request_context": {
      "ticker": "TWD_POLICY_RATE",
      "as_of_date": "2026-04-22",
      "family": "taiwan_macro",
      "dataset_view": "interest_rate_snapshot_v1"
    },
    "data": [
      {
        "as_of_date": "2026-04-22",
        "policy_rate_pct": 1.875,
        "overnight_rate_pct": 1.61,
        "source_name": "cbc_official"
      }
    ]
  }
}

Field 說明

欄位路徑	型別	說明
dataset	string	資料集識別，固定為 interest_rate_snapshot。
meta.rows_returned	integer	回傳資料筆數。
envelope.data[].as_of_date	string	資料日期。
envelope.data[].policy_rate_pct	number\|null	政策利率（百分比）。
envelope.data[].overnight_rate_pct	number\|null	隔夜利率（百分比）。
envelope.data[].source_name	string\|null	來源識別（例如 cbc_official）。

Usage Notes / 使用建議

此頁使用 data-api-standard 版型，與技術指標、估值資料、TWSE/TPEx 日線價格頁一致。
若要做跨資料集分析，建議保留 as_of_date 以便和 index-data、market-breadth 對齊。
資料可用範圍會依帳號方案與 API key 權限而定，實際以控制台顯示為準。

限制與注意

覆蓋非全市場、全期間；實際範圍以上方覆蓋小表與回應中的 data_gaps 為準。
資料有缺會如實標記，不以推測值補洞。
本平台聚焦日頻與基本面資料；不提供即時報價、盤中分K與加密貨幣。
TWSE 為 verified baseline；TPEx 歷史深度與還原股價目前為 beta / deferred，逐集標示。
查詢不支援 as_of 參數（列於路線圖）；point-in-time 請以各列的 knowledge_date 自行過濾，該日期保守設為法定申報截止日。日線價格不帶此欄位。

Plan Requirement

Route：/v2/datasets/interest-rate-snapshot
適用方案：實際可用範圍與配額以控制台方案顯示為準

此 API 屬於 TW Market Data 資料集目錄。查看資料集總覽

請求與回應

請求範例

curl --request GET \  --url "https://api.twmarketdata.com/v2/datasets/interest-rate-snapshot?date_from=2026-01-01&date_to=2026-04-30&limit=30" \  --header "X-API-Key: your_api_key_here"

狀態碼

成功回傳利率快照資料

JSON

{  "api_version": "v2",  "endpoint": "/v2/datasets/interest-rate-snapshot",  "request_id": "req_rates_1a2b3c4d",  "plan_id": "developer",  "dataset": "interest_rate_snapshot",  "query": {    "as_of_date": null,    "date_from": "2026-01-01",    "date_to": "2026-04-30",    "limit": 30,    "offset": 0,    "sort_by": "as_of_date",    "sort_order": "desc"  },  "meta": {    "rows_returned": 1  },  "envelope": {    "api_version": "v2",    "dataset": "interest_rate_snapshot",    "request_context": {      "ticker": "TWD_POLICY_RATE",      "as_of_date": "2026-04-22",      "family": "taiwan_macro",      "dataset_view": "interest_rate_snapshot_v1"    },    "data": [      {        "as_of_date": "2026-04-22",        "policy_rate_pct": 1.875,        "overnight_rate_pct": 1.61,        "source_name": "cbc_official"      }    ]  }}