AI agent?先讀 /llms.txt 取得全站索引。
衍生與可轉債
櫃買中心(TPEx)交易之可轉換公司債——上櫃可轉債的每日價格、成交量與轉換條件。
GET /v2/datasets/convertible-bondsconvertible-bonds 以官方 TPEx 資料為源,每交易日每檔可轉債回傳一列,含成交價格與當前轉換條件;每列附來源角色,任一數值可回溯 TPEx 發布,而非僅憑信任。
| 欄位 | 型別 | 說明 |
|---|---|---|
bond_code | string | 可轉債代碼。 |
date | string | 交易日。 |
close | number | 可轉債收盤價。 |
volume | number | 成交量。 |
conversion_price | number | 當前轉換價格(新台幣元)。 |
source_role | string | official_tpex。 |
| 列數 | 609,220 |
| 涵蓋起訖 | 2017-01-17 至 2026-07-16 |
| 分級 | 已驗證 |
TODO —— 尚未擷取到此資料集的真實回應(需要有權限的 API 金鑰,或其必填參數尚未確認)。寧可留白,也不顯示未經實測的範例。
curl "https://api.twmarketdata.com/v2/datasets/convertible-bonds?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 | 回傳筆數上限。 |
第一個呼叫:
import requests resp = requests.get( "https://api.twmarketdata.com/v2/datasets/convertible-bonds", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())帶日期區間篩選:
import requests # The full verified example — the same call with every supported filter set.resp = requests.get( "https://api.twmarketdata.com/v2/datasets/convertible-bonds", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())此端點為 GET /v2/datasets/convertible-bonds。完整機器可讀 schema(參數、認證、回應封裝)見 OpenAPI spec。