AI agent?先讀 /llms.txt 取得全站索引。
衍生與可轉債
可轉債總覽——逐檔可轉債條款與每日參考資料(轉換、賣回、贖回、餘額),來源櫃買(TPEx)。
GET /v2/datasets/convertible-bond-overview可轉債總覽是台灣市場資料集,來源為 TPEx,由 TW Market Data 以 GET /v2/datasets/convertible-bond-overview 提供。
convertible-bond-overview 每交易日每檔可轉債回傳一列,含主要條款——轉換期間與轉換價、賣回與贖回條款、發行與流通餘額、票面利率與標的股價。每列附來源家族與 lineage。
| 欄位 | 型別 | 說明 |
|---|---|---|
trade_date | string | 交易日。 |
cb_id | string | 可轉債代碼。 |
cb_name | string | 可轉債名稱。 |
conversion_start_date | string | 轉換期間起日。 |
conversion_end_date | string | 轉換期間迄日。 |
conversion_price | number | 轉換價。 |
next_conversion_price_effective_date | string | |
put_start_date | string | |
put_end_date | string | |
put_price | number | 賣回價。 |
redemption_start_date | null | |
redemption_end_date | null | |
redemption_price | number | 贖回價。 |
cb_delisting_date | string | |
issuance_amount | number | 發行金額。 |
outstanding_amount | number | 流通餘額。 |
reference_price | number | |
underlying_stock_price | number | 標的股價。 |
suspension_start_date | null | |
suspension_end_date | null | |
coupon_rate | number | 票面利率。 |
market | string | 市場別(TPEx)。 |
| 列數 | 612,996 |
| 涵蓋起訖 | 2017-01-17 – 2026-09-02 |
| 分級 | 已驗證 |
| 量測時間 | 2026-09-03取自資料集登錄表 |
此為本端點的真實回應。資料列位於 "data" 之下,來源資訊如下方所示;各資料集形狀不盡相同,請以本頁為準。
{
"dataset_id": "convertible_bond_overview",
"request_context": {
"scope": "tpex_cb_daily_terms_overview_only",
"coverage_type": "official_dated_daily",
"filters": {
"trade_date": null,
"date_from": null,
"date_to": null,
"cb_id": "47631",
"limit": 50
},
"min_trade_date": "2022-03-28",
"max_trade_date": "2022-06-09"
},
"quality": {
"row_count": 50,
"cb_count": 1,
"sensitive_fields_exposed": false
},
"lineage": {
"source_families": [
"TPEX_RSDRS001"
],
"semantics": "TPEx RSdrs001 轉換公司債資訊看板: conversion/put/redemption dates+prices, issuance/outstanding, coupon"
},
"error": null,
"data": [
{
"trade_date": "2022-06-09",
"cb_id": "47631",
"cb_name": "材料一KY",
"conversion_start_date": "2017-09-10",
"conversion_end_date": "2022-06-09",
"conversion_price": 113.6,
"next_conversion_price_effective_date": "2021-09-29",
"put_start_date": "2021-04-29",
"put_end_date": "2021-06-09",
"put_price": 102.0151,
"redemption_start_date": null,
"redemption_end_date": null,
"redemption_price": 0,
"cb_delisting_date": "2022-06-10",
"issuance_amount": 500000000,
"outstanding_amount": 354900000,
"reference_price": 99.8,
"underlying_stock_price": 117,
"suspension_start_date": null,
"suspension_end_date": null,
"coupon_rate": 0,
"market": "TPEx",
"source_family": "TPEX_RSDRS001",
"lineage": {
"report": "轉換公司債資訊看板",
"source": "TPEX_RSdrs001"
}
},
{
"trade_date": "2022-06-08",
"cb_id": "47631",
"cb_name": "材料一KY",
"conversion_start_date": "2017-09-10",
"conversion_end_date": "2022-06-09",
"conversion_price": 113.6,
"next_conversion_price_effective_date": "2021-09-29",
"put_start_date": "2021-04-29",
"put_end_date": "2021-06-09",
"put_price": 102.0151,
"redemption_start_date": null,
"redemption_end_date": null,
"redemption_price": 0,
"cb_delisting_date": "2022-06-10",
"issuance_amount": 500000000,
"outstanding_amount": 354900000,
"reference_price": 99.8,
"underlying_stock_price": 116,
"suspension_start_date": null,
"suspension_end_date": null,
"coupon_rate": 0,
"market": "TPEx",
"source_family": "TPEX_RSDRS001",
"lineage": {
"report": "轉換公司債資訊看板",
"source": "TPEX_RSdrs001"
}
}
],
"data_count": 50,
"known_gaps": [
"tpex_only",
"recent_window_initial_load_full_history_backfill_pending",
"terms_reference_not_trading_quotes"
],
"warnings": [
"not_investment_advice"
],
"envelope": {
"dataset_id": "convertible_bond_overview",
"scope": "tpex_cb_daily_terms_overview_only",
"row_count": 50
}
}擷取自 2026-07-20 的線上 API。
本頁顯示原始中文值;英文頁會以標記取代,以維持全英文。
以下欄位會隨資料一併回傳,記錄這一列的來源。它們屬於出處而非本資料集要講的事實,因此列在這裡而不進欄位表。
source_familylineage本服務部分資料取自政府資料開放平臺(data.gov.tw),依「政府資料開放授權條款-第1版」授權利用。資料提供機關:臺灣證券交易所、證券櫃檯買賣中心、臺灣期貨交易所、臺灣集中保管結算所、國家發展委員會、中央銀行、經濟部統計處、財政部關務署。本服務之加值處理、衍生計算與呈現方式由 TWMD 負責,與各資料提供機關無涉。
TW Market Data. (n.d.). 可轉債總覽 [Data set]. TW Market Data. Retrieved 2026-09-07, from https://twmarketdata.com/zh-TW/docs/api/derivatives/convertible-bond-overview
版本取自資料集自己的 as_of,不是這一頁的產生日期。沒有 as_of 的資料集就不列這個欄位,不會補一個看起來合理的值。 驗證簽章
可與本資料集對齊的其他資料集。每組都標出可用來 join 的欄位,規劃跨表查詢時不必自己猜。
可用 cb_id + market + trade_date 對齊
可用 cb_id + market 對齊
可用 market + trade_date 對齊
可用 market + trade_date 對齊
可用 market + trade_date 對齊
curl "https://api.twmarketdata.com/v2/datasets/convertible-bond-overview?cb_id=47631" \
-H "X-API-Key: sk_live_..."| 參數 | 必填 | 型別 | 說明 |
|---|---|---|---|
cb_id | 否 | string | 以可轉債代碼篩選。 |
start_date | 否 | string (YYYY-MM-DD) | 查詢起始日期。 |
end_date | 否 | string (YYYY-MM-DD) | 查詢結束日期。 |
limit | 否 | integer | 回傳筆數上限。 |
import requests
resp = requests.get(
"https://api.twmarketdata.com/v2/datasets/convertible-bond-overview",
params={"cb_id": "47631"},
headers={"X-API-Key": "sk_live_..."},
)
resp.raise_for_status()
print(resp.json()["data"])此端點為 GET /v2/datasets/convertible-bond-overview。完整機器可讀 schema(參數、認證、回應封裝)見 OpenAPI spec。