Skip to main content

Ownership Institutional Trades

取得指定個股在日期區間內、每個交易日的三大法人（外資及陸資、投信、自營商）買進、賣出與買賣超股數。

GET /ownership/institutional-trades/{symbol}
info

屬於 開發者 及 進階用戶 方案的專屬功能！

Parameters​

NameTypeDescription
symbol*string個股代號（如 2330）
fromstring開始日期（格式：yyyy-MM-dd），預設 30 天前
tostring結束日期（格式：yyyy-MM-dd），預設今天
sortstring依日期排序，預設 desc 降冪；可選 asc 升冪

Response​

NameTypeDescription
type*string證券類型
exchange*string交易所
market*string市場別
symbol*string個股代號
data*object[]有法人交易的交易日各一筆
data.date*string日期
data.foreign*object外資及陸資合計（不含外資自營商）
data.foreign.buy*number買進股數（股）
data.foreign.sell*number賣出股數（股）
data.foreign.net*number買賣超股數（股，買進 − 賣出）
data.trust*object投信，子欄位同 foreign
data.dealer*object自營商合計（含自行買賣與避險），子欄位同 foreign
data.total*number三大法人合計買賣超股數（股，為 foreign.net、trust.net、dealer.net 之和）
資料說明
  • 資料來源：整理自臺灣證券交易所與證券櫃檯買賣中心公開之三大法人買賣超日報資訊。
  • 資料頻率：僅在該股當日有三大法人交易時才有一筆，無法人進出的交易日不會出現在 data 陣列中。
  • 歷史涵蓋：上市、上櫃個股自 2013 年起；興櫃個股亦涵蓋，起始日依個股而異，請以實際回傳為準。
  • 查詢區間：單次查詢 from 與 to 的間隔須小於 1 年，超過會回傳 400；日期不合法或 from 晚於 to 亦回傳 400。
  • 查無資料：代號不存在或該區間無資料時，皆回傳 200 與 data: []（不回 404）；此時 type／exchange／market 為預設值，不代表該代號的真實屬性。
  • 呼叫額度：台股盤後籌碼系列 API 共用同一呼叫額度（以方案的「台股盤後籌碼」額度計）。

Example​

curl -X 'GET' \
  'https://api.fugle.tw/marketdata/v1.0/stock/ownership/institutional-trades/2330?from=2026-08-13&to=2026-08-13' \
  -H 'X-API-KEY: <YOUR_API_KEY>'

Response Body：

{
  "type": "EQUITY",
  "exchange": "TWSE",
  "market": "TSE",
  "symbol": "2330",
  "data": [
    {
      "date": "2026-08-13",
      "foreign": {
        "buy": 18369301,
        "sell": 14397070,
        "net": 3972231
      },
      "trust": {
        "buy": 2350600,
        "sell": 1614607,
        "net": 735993
      },
      "dealer": {
        "buy": 482295,
        "sell": 389114,
        "net": 93181
      },
      "total": 4801405
    }
  ]
}
Last updated on