AI agent？先讀 /llms.txt 取得全站索引。
衍生與可轉債
可轉債參考——每檔可轉換公司債的主檔資料(發行人、條款、重要日期),來源為 TPEx。
GET /v2/datasets/bond-convertible-referencebond-convertible-reference 為參考型資料集:每檔可轉債一筆主檔紀錄,非時間序列。用於將可轉債代碼解析為發行人、轉換條款與重要日期;每筆紀錄附回溯 TPEx 發布的來源角色。
| 欄位 | 型別 | 說明 |
|---|---|---|
bond_code | string | 可轉債代碼。 |
issuer_symbol | string | 發行公司股票代碼。 |
issue_date | string | 發行日期。 |
maturity_date | string | 到期日期。 |
conversion_price | number | 參考轉換價格(新台幣元)。 |
source_role | string | official_tpex。 |
| 列數 | 1,474 |
| 涵蓋起訖 | 參考資料，無時間序列 |
| 分級 | 參考 |
此為本端點的真實回應。資料列位於 "data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。
{ "dataset_id": "bond_convertible_reference", "request_context": { "scope": "bond_convertible_reference_latest_snapshot_only", "coverage_type": "latest_snapshot_only", "filters": { "bond_code": null, "market": null, "issuer": null, "underlying_ticker": null, "source_family": null, "limit": 50 } }, "quality": { "row_count": 50, "bond_code_count": 50, "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": null, "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 }, { "bond_code": "12561", "market": "TPEx", "bond_name": "鮮活果汁一KY", "issuer": "鮮活果汁-KY", "bond_type": "5", "issue_date": "2025-10-08", "maturity_date": "2028-10-08", "coupon_rate": 0, "conversion_terms": { "Currency": "1", "SeriesNumber": "1", "PutOptionDate": "20271008", "OfferingMethod": "7", "PutOptionPrice": "100.5006", "PrincipalRepayment": "1", "Conversion/ExchangePeriodEndDate": "20281008", "Conversion/ExchangePeriodStartDate": "20260109", "Conversion/ExchangePriceAtIssuance": "190.0000" }, "underlying_ticker": null, "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": "1256", "source_date": "20260605", "source_index": 3, "series_number": "1", "tranche_number": null }, "data_gaps": [ "underlying_ticker_not_provided" ], "not_investment_advice": true } ], "data_count": 50, "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": 50 }}擷取自 2026-07-20 的線上 API。
本頁顯示原始中文值；英文頁會以標記取代，以維持全英文。
curl "https://api.twmarketdata.com/v2/datasets/bond-convertible-reference?symbol=2330" \ -H "X-API-Key: sk_live_..."| 參數 | 必填 | 型別 | 說明 |
|---|---|---|---|
symbol | 否 | string | 以股票代碼篩選單一標的。 |
limit | 否 | integer | 回傳筆數上限。 |
第一個呼叫：
import requests resp = requests.get( "https://api.twmarketdata.com/v2/datasets/bond-convertible-reference", 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-convertible-reference", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["data"]: print(row)此端點為 GET /v2/datasets/bond-convertible-reference。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。