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

衍生與可轉債

可轉債集保月報

Name: Convertible Bond Custody (Monthly)
Creator: TW Market Data
License: https://twmarketdata.com/zh-TW/legal/licensing

可轉債集保月報——逐檔可轉債月底集保餘額與變動,來源集保結算所(TDCC)。

← 可轉債集保月報資料集總覽

已驗證來源: TDCC·方案: max·計費: 2 點·GET /v2/datasets/convertible-bond-monthly

可轉債集保月報是台灣市場資料集,來源為 TDCC,由 TW Market Data 以 GET /v2/datasets/convertible-bond-monthly 提供。

總覽

convertible-bond-monthly 每月每檔可轉債回傳一列,含集保餘額、上月餘額、變動金額與百分比、發行單位數與集保帳戶數。每列附來源家族與 lineage。

欄位	型別	說明
`data_month`	string	資料月份(YYYY-MM)。
`cb_id`	string	可轉債代碼。
`cb_name`	string	可轉債名稱。
`custody_balance`	number	月底集保餘額。
`last_month_balance`	number	上月餘額。
`change_amount`	number	對上月變動金額。
`change_percent`	number	對上月變動百分比。
`issued_units`	number	發行單位數。
`custody_accounts`	number	集保帳戶數。
`market`	string	市場別。

涵蓋範圍

列數	757
涵蓋起訖	2026-06-01 – 2026-07-01
分級	已驗證
量測時間	2026-09-01取自資料集登錄表

範例回應

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

{
  "dataset_id": "convertible_bond_monthly",
  "request_context": {
    "scope": "tdcc_cb_monthly_custody_only",
    "coverage_type": "official_monthly_accumulator",
    "filters": {
      "data_month": null,
      "month_from": null,
      "month_to": null,
      "cb_id": "20662",
      "limit": 50
    },
    "min_data_month": "2026-06-01",
    "max_data_month": "2026-06-01"
  },
  "quality": {
    "row_count": 1,
    "cb_count": 1,
    "sensitive_fields_exposed": false
  },
  "lineage": {
    "source_families": [
      "TDCC_GETOD_2_8"
    ],
    "semantics": "TDCC getOD id=2-8 可轉債集保月分析: custody_balance/last_month/change/issued/accounts (張)"
  },
  "error": null,
  "data": [
    {
      "data_month": "2026-06-01",
      "cb_id": "20662",
      "cb_name": "世德二",
      "custody_balance": 2378,
      "last_month_balance": 2378,
      "change_amount": 0,
      "change_percent": 0,
      "issued_units": 4000,
      "custody_accounts": 27,
      "market": "TPEx",
      "source_family": "TDCC_GETOD_2_8",
      "lineage": {
        "note": "latest-period-only monthly accumulator",
        "source": "TDCC_getOD_id_2-8"
      }
    }
  ],
  "data_count": 1,
  "known_gaps": [
    "tpex_cb_only",
    "latest_period_only_no_history_monthly_accumulator",
    "unit_is_lots_張"
  ],
  "warnings": [
    "not_investment_advice"
  ],
  "envelope": {
    "dataset_id": "convertible_bond_monthly",
    "scope": "tdcc_cb_monthly_custody_only",
    "row_count": 1
  }
}

擷取自 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-monthly

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

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

可轉債法人買賣
可用 cb_id + market 對齊
可轉債總覽
可用 cb_id + market 對齊
可轉債參考
可用 market 對齊
期貨市場日資料
可用 market 對齊
期交所最後結算價
可用 market 對齊

快速開始

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

curl "https://api.twmarketdata.com/v2/datasets/convertible-bond-monthly?cb_id=20662" \
  -H "X-API-Key: sk_live_..."

篩選參數

參數	必填	型別	說明
`cb_id`	否	string	以可轉債代碼篩選。
`limit`	否	integer	回傳筆數上限。

Python 範例

import requests

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

OpenAPI

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

請求與回應

請求

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

回應

{
  "dataset_id": "convertible_bond_monthly",
  "quality": {
    "row_count": "<number>",
    "cb_count": "<number>",
    "sensitive_fields_exposed": "<boolean>"
  },
  "error": null,
  "data": [
    {
      "data_month": "<string>",
      "cb_id": "<string>",
      "cb_name": "<string>",
      "custody_balance": "<number>",
      "last_month_balance": "<number>",
      "change_amount": "<number>",
      "change_percent": "<number>",
      "issued_units": "<number>",
      "custody_accounts": "<number>",
      "market": "<string>",
      "source_family": "<string>",
      "lineage": {
        "note": "<string>",
        "source": "<string>"
      }
    }
  ],
  "data_count": 1,
  "known_gaps": [
    "<string>"
  ],
  "warnings": [
    "<string>"
  ],
  "envelope": {
    "dataset_id": "<string>",
    "scope": "<string>",
    "row_count": "<number>"
  }
}