AI agent？先讀 /llms.txt 取得全站索引。

衍生與可轉債

可轉債參考

Name: Convertible-bond reference
Creator: TW Market Data
License: https://twmarketdata.com/zh-TW/legal/licensing

可轉債參考——每檔可轉換公司債的主檔資料(發行人、條款、重要日期),來源為 TPEx。

← 可轉債參考資料集總覽

參考來源: TPEx·方案: free·計費: 1 點·GET /v2/datasets/bond-convertible-reference

可轉債參考是台灣市場資料集,來源為 TPEx,由 TW Market Data 以 GET /v2/datasets/bond-convertible-reference 提供。

總覽

bond-convertible-reference 為參考型資料集:每檔可轉債一筆主檔紀錄,非時間序列。用於將可轉債代碼解析為發行人、轉換條款與重要日期;每筆紀錄附回溯 TPEx 發布的來源角色。

欄位	型別	說明
`bond_code`	string	可轉債代碼。
`market`	string
`bond_name`	string
`issuer`	string
`bond_type`	string
`issue_date`	string	發行日期。
`maturity_date`	string	到期日期。
`coupon_rate`	number
`conversion_terms`	object
`underlying_ticker`	string

涵蓋範圍

列數	約 1,542
涵蓋起訖	2012-12-10 – 2026-08-31
分級	參考
量測時間	2026-09-01取自資料集登錄表

範例回應

此為本端點的真實回應。資料列位於 "data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。

{
  "dataset_id": "bond_convertible_reference",
  "request_context": {
    "scope": "bond_convertible_reference_latest_snapshot_only",
    "coverage_type": "latest_snapshot_only",
    "filters": {
      "bond_code": "11011",
      "market": null,
      "issuer": null,
      "underlying_ticker": null,
      "source_family": null,
      "limit": 50
    }
  },
  "quality": {
    "row_count": 1,
    "bond_code_count": 1,
    "sensitive_fields_exposed": false
  },
  "lineage": {
    "source_providers": [
      "tpex_official"
    ],
    "source_roles": [
      "bond_convertible_reference_issuance_master"
    ],
    "source_families": [
      "bond_ISSBD5_data"
    ]
  },
  "error": null,
  "data": [
    {
      "bond_code": "11011",
      "market": "TPEx",
      "bond_name": "台泥一永",
      "issuer": "台泥",
      "bond_type": "5",
      "issue_date": "2024-12-10",
      "maturity_date": "2029-12-10",
      "coupon_rate": 0,
      "conversion_terms": {
        "Currency": "1",
        "SeriesNumber": "1",
        "PutOptionDate": "20271210",
        "OfferingMethod": "7",
        "PutOptionPrice": "100.0000",
        "PrincipalRepayment": "1",
        "Conversion/ExchangePeriodEndDate": "20291210",
        "Conversion/ExchangePeriodStartDate": "20250311",
        "Conversion/ExchangePriceAtIssuance": "36.5000"
      },
      "underlying_ticker": "1101",
      "source_provider": "tpex_official",
      "source_role": "bond_convertible_reference_issuance_master",
      "source_family": "bond_ISSBD5_data",
      "lineage": {
        "v1_scope": "clean_bondcode_reference_only",
        "source_url": "https://www.tpex.org.tw/openapi/v1/bond_ISSBD5_data",
        "issuer_code": "1101",
        "source_date": "20260605",
        "source_index": 2,
        "series_number": "1",
        "tranche_number": null
      },
      "data_gaps": [
        "underlying_ticker_not_provided"
      ],
      "not_investment_advice": true
    }
  ],
  "data_count": 1,
  "known_gaps": [
    "clean_bondcode_reference_only",
    "latest_snapshot_only",
    "blank_or_placeholder_bondcode_rows_excluded"
  ],
  "warnings": [
    "not_investment_advice"
  ],
  "not_investment_advice": true,
  "envelope": {
    "dataset_id": "bond_convertible_reference",
    "scope": "bond_convertible_reference_latest_snapshot_only",
    "row_count": 1
  }
}

擷取自 2026-07-20 的線上 API。

本頁顯示原始中文值；英文頁會以標記取代，以維持全英文。

出處

以下欄位會隨資料一併回傳,記錄這一列的來源。它們屬於出處而非本資料集要講的事實,因此列在這裡而不進欄位表。

source_providersource_rolesource_familylineagedata_gapsnot_investment_advice

授權與顯名

本服務部分資料取自政府資料開放平臺(data.gov.tw),依「政府資料開放授權條款-第1版」授權利用。資料提供機關:臺灣證券交易所、證券櫃檯買賣中心、臺灣期貨交易所、臺灣集中保管結算所、國家發展委員會、中央銀行、經濟部統計處、財政部關務署。本服務之加值處理、衍生計算與呈現方式由 TWMD 負責,與各資料提供機關無涉。

引用此資料集

TW Market Data. (n.d.). 可轉債參考 [Data set]. TW Market Data. Retrieved 2026-09-05, from https://twmarketdata.com/zh-TW/docs/api/derivatives/bond-convertible-reference

版本取自資料集自己的 as_of，不是這一頁的產生日期。沒有 as_of 的資料集就不列這個欄位，不會補一個看起來合理的值。驗證簽章

可與本資料集對齊的其他資料集。每組都標出可用來 join 的欄位,規劃跨表查詢時不必自己猜。

可轉債法人買賣
可用 market 對齊
可轉債總覽
可用 market 對齊
可轉債集保月報
可用 market 對齊
期貨市場日資料
可用 market 對齊
期交所最後結算價
可用 market 對齊

快速開始

把你的金鑰放進 X-API-Key 標頭。
加上查詢參數（symbol、日期區間、limit）。
送出請求並讀取 data 陣列。

curl "https://api.twmarketdata.com/v2/datasets/bond-convertible-reference?bond_code=11011" \
  -H "X-API-Key: sk_live_..."

篩選參數

參數	必填	型別	說明
`symbol`	否	string	以股票代碼篩選單一標的。
`limit`	否	integer	回傳筆數上限。

Python 範例

import requests

resp = requests.get(
    "https://api.twmarketdata.com/v2/datasets/bond-convertible-reference",
    params={"bond_code": "11011"},
    headers={"X-API-Key": "sk_live_..."},
)
resp.raise_for_status()
print(resp.json()["data"])

OpenAPI

此端點為 GET /v2/datasets/bond-convertible-reference。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。

備註與限制

參考／查表型資料集——每檔可轉債一筆主檔紀錄,非價格時間序列;用於將可轉債代碼解析為條款,每日數字請查詢 convertible-bonds。

請求與回應

請求

curl "https://api.twmarketdata.com/v2/datasets/bond-convertible-reference?symbol=2330&limit=5" \
  -H "X-API-Key: $TWMD_API_KEY"

回應

{
  "dataset_id": "bond_convertible_reference",
  "quality": {
    "row_count": "<number>",
    "bond_code_count": "<number>",
    "sensitive_fields_exposed": "<boolean>"
  },
  "error": null,
  "data": [
    {
      "bond_code": "<string>",
      "market": "<string>",
      "bond_name": "<string>",
      "issuer": "<string>",
      "bond_type": "<string>",
      "issue_date": "<string>",
      "maturity_date": "<string>",
      "coupon_rate": "<number>",
      "conversion_terms": {
        "Currency": "<string>",
        "SeriesNumber": "<string>",
        "PutOptionDate": "<string>",
        "OfferingMethod": "<string>",
        "PutOptionPrice": "<string>",
        "PrincipalRepayment": "<string>",
        "Conversion/ExchangePeriodEndDate": "<string>",
        "Conversion/ExchangePeriodStartDate": "<string>",
        "Conversion/ExchangePriceAtIssuance": "<string>"
      },
      "underlying_ticker": "<string>",
      "source_provider": "<string>",
      "source_role": "<string>",
      "source_family": "<string>",
      "lineage": {
        "v1_scope": "<string>",
        "source_url": "<string>",
        "issuer_code": "<string>",
        "source_date": "<string>",
        "source_index": "<number>",
        "series_number": "<string>",
        "tranche_number": "<null>"
      },
      "data_gaps": "<array>",
      "not_investment_advice": "<boolean>"
    }
  ],
  "data_count": 1,
  "known_gaps": [
    "<string>"
  ],
  "warnings": [
    "<string>"
  ],
  "not_investment_advice": true,
  "envelope": {
    "dataset_id": "<string>",
    "scope": "<string>",
    "row_count": "<number>"
  }
}