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

衍生與可轉債

可轉債法人買賣

Name: Convertible Bond Institutional Flow
Creator: TW Market Data
License: https://twmarketdata.com/zh-TW/legal/licensing

可轉債法人買賣——逐檔可轉債每日三大法人買/賣/淨額,來源櫃買(TPEx)。

← 可轉債法人買賣資料集總覽

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

可轉債法人買賣是台灣市場資料集,來源為 TPEx,由 TW Market Data 以 GET /v2/datasets/convertible-bond-institutional 提供。

總覽

convertible-bond-institutional 每交易日每檔可轉債回傳一列,含外資、投信、自營商的買、賣、淨額與總淨額。每列附來源家族與 lineage,籌碼可回溯官方發布。

欄位	型別	說明
`trade_date`	string	交易日。
`cb_id`	string	可轉債代碼。
`cb_name`	string	可轉債名稱。
`foreign_buy`	number
`foreign_sell`	number
`foreign_net`	number	外資淨額(買減賣)。
`trust_buy`	number
`trust_sell`	number
`trust_net`	number	投信淨額。
`dealer_buy`	number
`dealer_sell`	number
`dealer_net`	number	自營商淨額。
`total_net`	number	三大法人總淨額。
`market`	string	市場別(TPEx)。

涵蓋範圍

列數	156,809
涵蓋起訖	2022-03-30 – 2026-09-02
分級	已驗證
量測時間	2026-09-03取自資料集登錄表

範例回應

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

{
  "dataset_id": "convertible_bond_institutional",
  "request_context": {
    "scope": "tpex_cb_three_major_institutional_only",
    "coverage_type": "official_dated_daily",
    "filters": {
      "trade_date": null,
      "date_from": null,
      "date_to": null,
      "cb_id": "26107",
      "limit": 50
    },
    "min_trade_date": "2026-01-22",
    "max_trade_date": "2026-04-21"
  },
  "quality": {
    "row_count": 50,
    "cb_count": 1,
    "sensitive_fields_exposed": false
  },
  "lineage": {
    "source_families": [
      "TPEX_CBBIGD"
    ],
    "semantics": "TPEx CBBIGD 可轉債三大法人日交易: foreign/trust/dealer buy/sell/net + total_net (張)"
  },
  "error": null,
  "data": [
    {
      "trade_date": "2026-04-21",
      "cb_id": "26107",
      "cb_name": "華航七",
      "foreign_buy": 0,
      "foreign_sell": 0,
      "foreign_net": 0,
      "trust_buy": 0,
      "trust_sell": 0,
      "trust_net": 0,
      "dealer_buy": 611,
      "dealer_sell": 839,
      "dealer_net": -228,
      "total_net": -228,
      "market": "TPEx",
      "source_family": "TPEX_CBBIGD",
      "lineage": {
        "source": "TPEX_CBBIGD",
        "endpoint": "www/zh-tw/bond/newCb3itrade",
        "unit": "張"
      }
    },
    {
      "trade_date": "2026-04-20",
      "cb_id": "26107",
      "cb_name": "華航七",
      "foreign_buy": 0,
      "foreign_sell": 0,
      "foreign_net": 0,
      "trust_buy": 0,
      "trust_sell": 0,
      "trust_net": 0,
      "dealer_buy": 114,
      "dealer_sell": 110,
      "dealer_net": 4,
      "total_net": 4,
      "market": "TPEx",
      "source_family": "TPEX_CBBIGD",
      "lineage": {
        "source": "TPEX_CBBIGD",
        "endpoint": "www/zh-tw/bond/newCb3itrade",
        "unit": "張"
      }
    }
  ],
  "data_count": 50,
  "known_gaps": [
    "tpex_only",
    "recent_window_initial_load_full_history_backfill_pending",
    "unit_is_lots_張"
  ],
  "warnings": [
    "not_investment_advice"
  ],
  "envelope": {
    "dataset_id": "convertible_bond_institutional",
    "scope": "tpex_cb_three_major_institutional_only",
    "row_count": 50
  }
}

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

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

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

可轉債總覽
可用 cb_id + market + trade_date 對齊
可轉債集保月報
可用 cb_id + market 對齊
選擇權每日Delta
可用 market + trade_date 對齊
選擇權Put/Call Ratio
可用 market + trade_date 對齊
產業價值鏈成員
可用 market + trade_date 對齊

快速開始

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

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

篩選參數

參數	必填	型別	說明
`cb_id`	否	string	以可轉債代碼篩選。
`start_date`	否	string (YYYY-MM-DD)	查詢起始日期。
`end_date`	否	string (YYYY-MM-DD)	查詢結束日期。
`limit`	否	integer	回傳筆數上限。

Python 範例

import requests

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

OpenAPI

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

請求與回應

請求

curl "https://api.twmarketdata.com/v2/datasets/convertible-bond-institutional?start_date=2026-01-01&end_date=2026-06-30&limit=5" \
  -H "X-API-Key: $TWMD_API_KEY"

回應

{
  "dataset_id": "convertible_bond_institutional",
  "quality": {
    "row_count": "<number>",
    "cb_count": "<number>",
    "sensitive_fields_exposed": "<boolean>"
  },
  "error": null,
  "data": [
    {
      "trade_date": "<string>",
      "cb_id": "<string>",
      "cb_name": "<string>",
      "foreign_buy": "<number>",
      "foreign_sell": "<number>",
      "foreign_net": "<number>",
      "trust_buy": "<number>",
      "trust_sell": "<number>",
      "trust_net": "<number>",
      "dealer_buy": "<number>",
      "dealer_sell": "<number>",
      "dealer_net": "<number>",
      "total_net": "<number>",
      "market": "<string>",
      "source_family": "<string>",
      "lineage": {
        "source": "<string>",
        "endpoint": "<string>",
        "unit": "<string>"
      }
    }
  ],
  "data_count": 50,
  "known_gaps": [
    "<string>"
  ],
  "warnings": [
    "<string>"
  ],
  "envelope": {
    "dataset_id": "<string>",
    "scope": "<string>",
    "row_count": "<number>"
  }
}