Building an AI agent? Start with /llms.txt for the full site index.
Derivatives & Convertibles
Convertible-bond reference — the master record for each convertible-bond issue (issuer, terms, key dates), sourced from TPEx.
GET /v2/datasets/bond-convertible-referencebond-convertible-reference is a reference dataset: one master record per convertible-bond issue, not a time series. Use it to resolve a bond code to its issuer, conversion terms and key dates. Each record carries its source role back to the TPEx publication.
| Field | Type | Description |
|---|---|---|
bond_code | string | Convertible-bond code. |
issuer_symbol | string | Ticker of the issuing company. |
issue_date | string | Issue date of the bond. |
maturity_date | string | Maturity date of the bond. |
conversion_price | number | Reference conversion price (TWD). |
source_role | string | official_tpex. |
| Rows | 1,474 |
| Window | Reference data, no time series |
| Grade | Reference |
A real response from this endpoint. Rows are returned under "data", and provenance is carried in the shape shown below — it is not identical across datasets, so read this page's rather than assuming another's.
{ "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": "<Chinese value - see the zh page>", "issuer": "<Chinese value - see the zh page>", "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": "<Chinese value - see the zh page>", "issuer": "<Chinese value - see the zh page>", "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 }}Captured from the live API on 2026-07-20.
Chinese data values are shown as a marker here so this page stays in English; the /zh page shows them verbatim.
curl "https://api.twmarketdata.com/v2/datasets/bond-convertible-reference?symbol=2330" \ -H "X-API-Key: sk_live_..."| Parameter | Required | Type | Description |
|---|---|---|---|
symbol | No | string | Ticker to filter to a single security. |
limit | No | integer | Maximum rows to return. |
A first call:
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"])With a date-range filter:
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)This endpoint is GET /v2/datasets/bond-convertible-reference. The full machine-readable schema (parameters, security, response envelope) lives in the OpenAPI spec.