市場與價格
利率
提供台灣市場利率快照資料，適合用於折現參數設定、宏觀條件對照與研究流程。
GET
/v2/datasets/interest-rate-snapshotOverview#
利率 API 提供台灣市場利率快照資料，可作為估值折現、風險參數與宏觀條件分析的基礎輸入。
資料對應 canonical topic `interest_rate_snapshot`，對外路徑採 `/v2/datasets/interest-rate-snapshot`。
- 設定折現率或資金成本參數。
- 作為宏觀條件過濾器，搭配價格與財務資料做策略檢查。
- 建立利率變動時間序列並觀察市場反應。
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 對齊。
- 是否可完整讀取仍受 entitlement 控制，實際以控制台方案為準。
Plan Requirement#
- Readiness：live external route（canonical topic）
- 適用方案：Free（限制） / Developer / Pro / Enterprise（實際 entitlement 以控制台為準）