市場與價格
提供台灣市場利率快照資料,適合用於折現參數設定、宏觀條件對照與研究流程。
/v2/datasets/interest-rate-snapshot利率 API 提供台灣市場利率快照資料,可作為估值折現、風險參數與宏觀條件分析的基礎輸入。
資料對應 canonical topic `interest_rate_snapshot`,對外路徑採 `/v2/datasets/interest-rate-snapshot`。
使用此 endpoint 時,建議以 as_of_date 查單日快照,或以 date_from/date_to 查歷史區間。若流程需要長期序列,建議先批次落地再下游使用。
| 欄位 | 型別 | 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 | 分頁偏移。 |
回應採 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" } ] }}| 欄位路徑 | 型別 | 說明 |
|---|---|---|
| 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)。 |
此 API 屬於 TW Market Data 資料集目錄。 查看資料集總覽