籌碼與資金

籌碼流向

提供法人與參與者拆分的籌碼流向資料,適合籌碼面分析與策略研究。

GET/v2/datasets/chip-flows

Overview#

籌碼流向 API 提供法人與參與者拆分的買賣超流向資料,適合做籌碼面研究與策略訊號。

此頁為 productized endpoint,採 canonical envelope 回應。

  • 追蹤外資/投信/自營商資金流向。
  • 建立籌碼動能訊號。
  • 與價格資料做事件對照。

Request#

可使用 ticker、participant_type、flow_type 與日期區間做條件查詢。

Query Parameters#

欄位型別Required說明
tickerstringno股票代碼。
marketstringno市場代碼,預設 tw。
flow_typestringno流向類型過濾。
participant_typestringno參與者類型過濾。
date_fromstringno查詢起始日期(YYYY-MM-DD)。
date_tostringno查詢結束日期(YYYY-MM-DD)。
limitintegerno回傳筆數限制。

Response Shape#

回應為 canonical envelope 格式,頂層包含 query/meta 與 envelope.data。

{
  "api_version": "v2",
  "endpoint": "/v2/datasets/chip-flows",
  "request_id": "req_chip_4422",
  "plan_id": "pro",
  "dataset": "chip_flows",
  "query": {
    "ticker": "2330",
    "market": "tw",
    "flow_type": null,
    "participant_type": "foreign",
    "date_from": "2026-04-01",
    "date_to": "2026-04-22",
    "limit": 50
  },
  "meta": {
    "rows_returned": 1
  },
  "envelope": {
    "api_version": "v2",
    "dataset": "chip_flows",
    "request_context": {
      "ticker": "2330",
      "as_of_date": "2026-04-22",
      "family": "chip_deep",
      "dataset_view": "broker_trading_daily_agg_v2"
    },
    "data": [
      {
        "ticker": "2330",
        "trade_date": "2026-04-22",
        "participant_type": "foreign",
        "net_volume": 1250000,
        "net_value": 1024000000,
        "source_dataset": "broker_trading_daily"
      }
    ]
  }
}

Field 說明#

欄位路徑型別說明
datasetstring資料集識別,固定為 chip_flows。
meta.rows_returnedinteger回傳資料筆數。
envelope.data[].tickerstring股票代碼。
envelope.data[].trade_datestring交易日期。
envelope.data[].participant_typestring|null參與者類型。
envelope.data[].net_volumenumber|null買賣超張數。
envelope.data[].net_valuenumber|null買賣超金額。
envelope.data[].source_datasetstring|null來源資料集標記。

Usage Notes / 使用建議#

  • 此頁為 productized endpoint。
  • 若需要融資融券補充面,請參考 `/v2/datasets/margin-short`。
  • 若需要法人淨買超寬表,請參考 `/v2/datasets/institutional-flow`。

Plan Requirement#

  • Free(限制)
  • Developer
  • Pro
  • Enterprise