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

籌碼與資金

鉅額交易日資料

鉅額交易日資料

已驗證來源: TWSE·方案: developer·計費: 2 ·GET /v2/datasets/block-trade-daily

鉅額交易日資料是台灣市場資料集,來源為 TWSE,由 TW Market Data 以 GET /v2/datasets/block-trade-daily 提供。

總覽

鉅額交易日資料——後端 meta 未提供 grain,故此處不述。

欄位型別說明
trade_datestring
marketstring
trading_classificationstring
trade_typestring
trade_volumenumber
trade_volume_market_share_pctnumber
trade_valuenumber
trade_value_market_share_pctnumber

範例回應

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

{  "dataset_id": "block_trade_daily",  "request_context": {    "scope": "twse_block_trade_daily_summary_only",    "coverage_type": "bounded_verified_daily_aggregation_set",    "filters": {      "trade_date": "2026-08-05",      "date_from": null,      "date_to": null,      "market": null,      "source_family": null,      "limit": 50    },    "min_trade_date": "2026-08-05",    "max_trade_date": "2026-08-05"  },  "quality": {    "row_count": 4,    "market_count": 1,    "sensitive_fields_exposed": false  },  "lineage": {    "source_providers": [      "twse_official"    ],    "source_roles": [      "block_trade_daily"    ],    "source_families": [      "official_twse_block_trade_monthly"    ]  },  "error": null,  "data": [    {      "trade_date": "2026-08-05",      "market": "TWSE",      "trading_classification": "Non-paired Trade",      "trade_type": "Basket",      "trade_volume": 0,      "trade_volume_market_share_pct": 0,      "trade_value": 0,      "trade_value_market_share_pct": 0,      "source_provider": "twse_official",      "source_role": "block_trade_daily",      "source_family": "official_twse_block_trade_monthly",      "lineage": {        "selected_table": "table0_daily_rows",        "official_endpoint": "twse_rwd_block_bfiauu_d",        "requested_month_token": "20260801"      },      "data_gaps": []    },    {      "trade_date": "2026-08-05",      "market": "TWSE",      "trading_classification": "Non-paired Trade",      "trade_type": "Single Stock",      "trade_volume": 0,      "trade_volume_market_share_pct": 0,      "trade_value": 0,      "trade_value_market_share_pct": 0,      "source_provider": "twse_official",      "source_role": "block_trade_daily",      "source_family": "official_twse_block_trade_monthly",      "lineage": {        "selected_table": "table0_daily_rows",        "official_endpoint": "twse_rwd_block_bfiauu_d",        "requested_month_token": "20260801"      },      "data_gaps": []    }  ],  "data_count": 4,  "known_gaps": [    "twse_only_scope",    "summary_level_only",    "no_tpex_coverage"  ],  "warnings": [    "not_investment_advice",    "twse_only_scope"  ],  "envelope": {    "dataset_id": "block_trade_daily",    "scope": "twse_block_trade_daily_summary_only",    "row_count": 4  }}

擷取自 2026-07-20 的線上 API。

出處

以下欄位會隨資料一併回傳,記錄這一列的來源。它們屬於出處而非本資料集要講的事實,因此列在這裡而不進欄位表。

source_providersource_rolesource_familylineagedata_gaps

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

快速開始

  1. 把你的金鑰放進 X-API-Key 標頭。
  2. 加上查詢參數(symbol、日期區間、limit)。
  3. 送出請求並讀取 data 陣列。
curl "https://api.twmarketdata.com/v2/datasets/block-trade-daily?symbol=2330" \  -H "X-API-Key: sk_live_..."

篩選參數

參數必填型別說明
symbolstring股票代碼,例如 2330。
start_datestring (YYYY-MM-DD)查詢起始日期。
end_datestring (YYYY-MM-DD)查詢結束日期。
limitinteger回傳筆數上限。

Python 範例

第一個呼叫:

import requests resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/block-trade-daily",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json()["data"])

帶日期區間篩選:

import requests # The full verified example — the same call with every supported filter set.resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/block-trade-daily",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["data"]:    print(row)

OpenAPI

此端點為 GET /v2/datasets/block-trade-daily。完整機器可讀 schema(參數、認證、回應封裝)見 OpenAPI spec

備註與限制

  • 後端 meta 未提供 grain 與欄位清單,故此處不列欄位表,也不推測列數與涵蓋起訖。