Building an AI agent? Start with /llms.txt for the full site index.

市場與價格

利率

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

This documentation page is currently available in Chinese only; English versions are coming soon.

GET/v2/datasets/interest-rate-snapshot

Overview

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

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

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

Coverage

Instruments	Start year	Update timing	Includes delisted
Not yet available (coming)	Not yet available (coming)	Not yet available (coming)	coming

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

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 權限而定，實際以控制台顯示為準。

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.

Plan Requirement

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

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

請求與回應

Request example

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"

Status codes

成功回傳利率快照資料

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"      }    ]  }}

Overview

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

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

設定折現率或資金成本參數。

作為宏觀條件過濾器，搭配價格與財務資料做策略檢查。

建立利率變動時間序列並觀察市場反應。

Instruments

Start year

Update timing

Includes delisted

Not yet available (coming)

coming

欄位

型別

Required

說明

as_of_date

string

指定單一資料日期（YYYY-MM-DD）。

date_from

string

查詢起始日期（YYYY-MM-DD）。

date_to

string

查詢結束日期（YYYY-MM-DD）。

limit

integer

回傳筆數限制。

offset

integer

分頁偏移。

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 權限而定，實際以控制台顯示為準。

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.

{ "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" } ] }}