AI agent？先讀 /llms.txt 取得全站索引。
總體經濟
台灣公債殖利率曲線
台灣公債殖利率曲線
已驗證來源: TPEx·方案: max·計費: 2 點·
GET /v2/datasets/bond-yield-curve台灣公債殖利率曲線是台灣市場資料集,來源為 TPEx,由 TW Market Data 以 GET /v2/datasets/bond-yield-curve 提供。
總覽
台灣公債殖利率曲線——每列粒度:tenor / trade_date。
| 欄位 | 型別 | 說明 |
|---|---|---|
trade_date | string | |
curve_type | string | |
tenor_label | string | |
maturity_years | number | |
yield_rate | number | |
as_of | string | |
index_version | string |
範例回應
此為本端點的真實回應。資料列位於 "data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。
{ "dataset_id": "bond_yield_curve", "request_context": { "scope": "tw_government_bond_yield_curve", "coverage_type": "daily", "filters": { "trade_date": "2026-08-04", "date_from": null, "date_to": null, "curve_type": null, "tenor_label": null, "limit": 50 }, "min_trade_date": "2026-08-04", "max_trade_date": "2026-08-04" }, "quality": { "row_count": 5, "tenors_present": [ "10Y", "20Y", "2Y" ], "trade_days_in_page": 1, "sensitive_fields_exposed": false }, "lineage": { "source_families": [ "TPEX_GOVBOND_DAILY_02" ], "semantics": "Taiwan government bond yields by tenor per trading day. One row per (trade_date, tenor); order a single date by maturity_years to read it as a curve." }, "error": null, "data": [ { "trade_date": "2026-08-04", "curve_type": "govbond", "tenor_label": "2Y", "maturity_years": 2, "yield_rate": 1.6613, "as_of": "2026-08-04", "index_version": "tpex_govbond_curve:068ec5e779db", "source_provider": "tpex_official", "source_role": "official_tpex_govbond_curve", "source_family": "TPEX_GOVBOND_DAILY_02", "source_authority": "TPEx 公債殖利率曲線", "lineage": { "echo_ok": true, "emitter": "build_bond_yield_curve_candidates", "bond_code": "A15203", "residual_years": 1.952, "source_data_date": "2026-08-04" } }, { "trade_date": "2026-08-04", "curve_type": "govbond", "tenor_label": "5Y", "maturity_years": 5, "yield_rate": 1.83, "as_of": "2026-08-04", "index_version": "tpex_govbond_curve:068ec5e779db", "source_provider": "tpex_official", "source_role": "official_tpex_govbond_curve", "source_family": "TPEX_GOVBOND_DAILY_02", "source_authority": "TPEx 公債殖利率曲線", "lineage": { "echo_ok": true, "emitter": "build_bond_yield_curve_candidates", "bond_code": "A15108", "residual_years": 5, "source_data_date": "2026-08-04" } } ], "data_count": 5, "known_gaps": [ "no_scheduled_producer_history_is_real_but_the_series_does_not_advance_on_its_own", "daily_cadence_by_nature_so_a_stale_max_trade_date_means_a_gap_not_a_quiet_market", "tpex_govbond_source_only_no_corporate_or_swap_curve" ], "warnings": [ "not_investment_advice" ], "envelope": { "dataset_id": "bond_yield_curve", "scope": "tw_government_bond_yield_curve", "row_count": 5 }}擷取自 2026-07-20 的線上 API。
本頁顯示原始中文值；英文頁會以標記取代，以維持全英文。
出處
以下欄位會隨資料一併回傳,記錄這一列的來源。它們屬於出處而非本資料集要講的事實,因此列在這裡而不進欄位表。
source_providersource_rolesource_familysource_authoritylineage相關資料集
可與本資料集對齊的其他資料集。每組都標出可用來 join 的欄位,規劃跨表查詢時不必自己猜。
快速開始
- 把你的金鑰放進 X-API-Key 標頭。
- 加上查詢參數（symbol、日期區間、limit）。
- 送出請求並讀取 data 陣列。
curl "https://api.twmarketdata.com/v2/datasets/bond-yield-curve?symbol=2330" \ -H "X-API-Key: sk_live_..."篩選參數
| 參數 | 必填 | 型別 | 說明 |
|---|---|---|---|
symbol | 是 | string | 股票代碼，例如 2330。 |
start_date | 否 | string (YYYY-MM-DD) | 查詢起始日期。 |
end_date | 否 | string (YYYY-MM-DD) | 查詢結束日期。 |
limit | 否 | integer | 回傳筆數上限。 |
Python 範例
第一個呼叫：
import requests resp = requests.get( "https://api.twmarketdata.com/v2/datasets/bond-yield-curve", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json()["data"])帶日期區間篩選：
import requests # The full verified example — the same call with every supported filter set.resp = requests.get( "https://api.twmarketdata.com/v2/datasets/bond-yield-curve", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["data"]: print(row)OpenAPI
此端點為 GET /v2/datasets/bond-yield-curve。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。
備註與限制
- 後端 meta 未提供涵蓋起訖,故不列;10Y-2Y 倒掛常被讀作衰退訊號,本站不對此作預測性主張。