文件

看籌碼

使用三大法人與融資融券資料，建立可驗證的台股籌碼觀察流程。

這篇適合誰#

這篇適合要追蹤外資、投信、自營商與信用交易變化的研究者與開發者。

若你想把籌碼面接入策略或 AI agent 研究流程，可從本頁的最小查詢流程開始。

Prerequisites#

Python 3.9+、requests、X-API-Key、symbol（例如 2330）。

Authentication#

import requests BASE_URL = "https://api.twmarketdata.com"HEADERS = {    "X-API-Key": "your_api_key_here",} def get_dataset(path, params):    response = requests.get(        f"{BASE_URL}{path}",        headers=HEADERS,        params=params,    )    response.raise_for_status()    return response.json()

查詢三大法人買賣#

三大法人買賣超可用於觀察資金流向與籌碼變化。資料單位以 shares 為主，實際欄位請以 API 文件回應為準。

flow = get_dataset(    "/v2/datasets/institutional-flow",    {        "symbol": "2330",        "limit": 10,    },)

查詢融資融券#

融資融券可補充信用交易與市場槓桿情緒，適合與法人流向一起判讀。

margin = get_dataset(    "/v2/datasets/margin-short",    {        "symbol": "2330",        "limit": 10,    },)

查詢公司公告#

announcements = get_dataset(    "/v2/datasets/issuer-announcements",    {        "symbol": "2330",        "limit": 5,    },)

查詢事件日曆#

events = get_dataset(    "/v2/datasets/events",    {        "symbol": "2330",        "limit": 5,    },) structured_events = get_dataset(    "/v2/datasets/structured-events",    {        "symbol": "2330",        "limit": 5,    },)

合併籌碼與事件#

result = {    "institutional_flow": flow.get("rows", []),    "margin_short": margin.get("rows", []),    "announcements": announcements.get("rows", []),    "events": events.get("rows", []),    "structured_events": structured_events.get("rows", []),} print(result)

coverage 注意事項#

institutional-flow 資料集 coverage 仍在持續補齊中。請在 workflow 內保留 data_gaps 與缺值處理，不要直接把缺口當成 0。

資料集介紹：/datasets/institutional-flow、/datasets
API 文件：/docs/api/capital-flow/institutional-flow、/docs/api/capital-flow/margin-short

Next Steps#

完成籌碼與事件整合後，可延伸到：

/docs/api/market-prices/twse-daily-price
/docs/api/market-prices/technical-indicators
/docs/workflows/market-status
/datasets/institutional-flow

Authentication#

import requests BASE_URL = "https://api.twmarketdata.com"HEADERS = {    "X-API-Key": "your_api_key_here",} def get_dataset(path, params):    response = requests.get(        f"{BASE_URL}{path}",        headers=HEADERS,        params=params,    )    response.raise_for_status()    return response.json()

events = get_dataset( "/v2/datasets/events", { "symbol": "2330", "limit": 5, },) structured_events = get_dataset( "/v2/datasets/structured-events", { "symbol": "2330", "limit": 5, },)

result = { "institutional_flow": flow.get("rows", []), "margin_short": margin.get("rows", []), "announcements": announcements.get("rows", []), "events": events.get("rows", []), "structured_events": structured_events.get("rows", []),} print(result)