AI agent？先讀 /llms.txt 取得全站索引。
文件
使用三大法人與融資融券資料，建立可驗證的台股籌碼觀察流程。
這篇適合要追蹤外資、投信、自營商與信用交易變化的研究者與開發者。
若你想把籌碼面接入策略或 AI agent 研究流程，可從本頁的最小查詢流程開始。
Python 3.9+、requests、X-API-Key、symbol（例如 2330）。
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)institutional-flow 資料集 coverage 仍在持續補齊中。請在 workflow 內保留 data_gaps 與缺值處理，不要直接把缺口當成 0。
完成籌碼與事件整合後，可延伸到：