API Thị trường Đài Loan

6 endpoint

Cập nhật lần cuối 2026-11
URL gốc
https://api.blave.org
Xác thực
Gửi header api-key + secret-key trong mọi request
Quyền truy cập
API plan or Blave Agent plan
Giới hạn tần suất
500 request / 5 phút cho mỗi key và mỗi IP

Quy ước

Chuỗi dữ liệu ngày của toàn thị trường (không có stock_id). start / end là YYYY-MM-DD tùy chọn; bỏ qua để lấy toàn bộ lịch sử. Đừng cộng các endpoint theo từng cổ phiếu để thay thế — phạm vi và đơn vị khác nhau.

OHLC ngày của TAIEX

GET/studio/market/twmarket/index/<index_id>
Dữ liệu từ
1999-01-05
Tần suất cập nhật
Hằng ngày

Tham số

TênMô tảGiá trị hợp lệMặc định
index_id
string · pathBắt buộc
Chỉ hỗ trợ TAIEXTAIEX (không phân biệt hoa thường)
start
string · query
Ngày đầu tiênYYYY-MM-DD1999-01-05
end
string · query
Ngày cuối cùngYYYY-MM-DDhôm nay

Ví dụ

Python
body = requests.get(f"{BASE_URL}/studio/market/twmarket/index/TAIEX", headers=headers,                    params={"start": "2024-01-01", "end": "2024-12-31"}, timeout=60).json()# {"index_id": "TAIEX", "data": [{"date": "2024-01-02", "open": 17939.79, "high": 17956.74, "low": 17784.97, "close": 17853.76}, ...]}

Phản hồi

{"index_id": "TAIEX", "data": [{"date", "open", "high", "low", "close"}]}; giá tính bằng điểm chỉ số. Không có khối lượng — dùng /twmarket/turnover.

Lỗi

Mã trạng tháiNội dung phản hồiTrường hợp
400{"error": "Unsupported index"}Không phải TAIEX
503{"error": "Market data is not ready on this server. Please retry later."} / giới hạn tần suất upstreamKho dữ liệu chưa sẵn sàng / upstream ngừng hoạt động

Ghi chú

  • Chuỗi dữ liệu là chỉ số do TWSE công bố chính thức.
  • Cache máy chủ: 5 phút.

Giá trị giao dịch toàn thị trường

GET/studio/market/twmarket/turnover
Dữ liệu từ
1990-01-04
Tần suất cập nhật
Hằng ngày

Tham số

TênMô tảGiá trị hợp lệMặc định
start
string · query
Ngày đầu tiênYYYY-MM-DD1990-01-04
end
string · query
Ngày cuối cùngYYYY-MM-DDhôm nay

Ví dụ

Python
data = requests.get(f"{BASE_URL}/studio/market/twmarket/turnover", headers=headers,                    params={"start": "2024-01-01"}, timeout=60).json()["data"]# [{"date": "2024-01-02", "volume": 6411778806.0, "value": 301290668897.0, "trades": 2267660.0}, ...]

Phản hồi

{"data": [...]}.

TrườngĐơn vịMô tả
date—Ngày giao dịch
volumecổ phiếu成交股數
valueTWD成交金額
tradessố lệnh成交筆數

Lỗi

503 kho dữ liệu chưa sẵn sàng hoặc giới hạn tần suất upstream. Khoảng không có dòng nào trả về 200 với "data": [].

Ghi chú

  • Số liệu là thống kê giao dịch toàn thị trường do TWSE công bố chính thức.
  • Cache máy chủ: 5 phút.

Mua/bán ròng của tổ chức toàn thị trường

GET/studio/market/twmarket/institutional
Dữ liệu từ
2004-04-07
Tần suất cập nhật
Hằng ngày

Tham số

TênMô tảGiá trị hợp lệMặc định
start
string · query
Ngày đầu tiênYYYY-MM-DD2004-04-07
end
string · query
Ngày cuối cùngYYYY-MM-DDhôm nay

Ví dụ

Python
data = requests.get(f"{BASE_URL}/studio/market/twmarket/institutional", headers=headers,                    params={"start": "2024-01-01"}, timeout=60).json()["data"]# [{"date": "2024-01-02", "foreign": 1047078183.0, "investment_trust": 189637635.0,#   "dealer": -4448119903.0, "total": -3211404085.0}, ...]

Phản hồi

{"data": [{"date", "foreign", "investment_trust", "dealer", "total"}]}; mọi giá trị là giá trị ròng (mua − bán) tính bằng TWD.

Lỗi

503 kho dữ liệu chưa sẵn sàng hoặc giới hạn tần suất upstream. Khoảng không có dòng nào trả về 200 với "data": [].

Ghi chú

  • Tầng toàn thị trường. foreign là 外資及陸資, không gồm giao dịch tự doanh của tự doanh nước ngoài (外資自營商); dealer là 自營商 (自行買賣 + 避險), trong đó TWSE đã tính sẵn 外資自營商. Endpoint theo từng cổ phiếu (GET /studio/market/twstock/institutional/<stock_id>) là một tầng khác: nó trả về các cột gốc theo từng loại và không gộp nhóm gì. Đừng trộn lẫn hai tầng này.
  • foreign + investment_trust + dealer bằng total, tức 三大法人合計 do sàn công bố, ở mọi ngày. 外資自營商 không phải là một cột riêng: nó nằm ở chứng quyền/ETN, loại mà Blave không cung cấp, và đã bằng 0 mỗi ngày kể từ sau 2024-08-16.
  • Cache máy chủ: 5 phút.

Dư nợ ký quỹ toàn thị trường

GET/studio/market/twmarket/margin
Dữ liệu từ
2001-01-03
Tần suất cập nhật
Hằng ngày

Tham số

TênMô tảGiá trị hợp lệMặc định
start
string · query
Ngày đầu tiênYYYY-MM-DD2001-01-03
end
string · query
Ngày cuối cùngYYYY-MM-DDhôm nay

Ví dụ

Python
data = requests.get(f"{BASE_URL}/studio/market/twmarket/margin", headers=headers,                    params={"start": "2024-01-01"}, timeout=60).json()["data"]# [{"date": "2024-01-02", "margin_balance": 8012561, "margin_balance_prev": 7999081,#   "margin_balance_value": 248424271000, "short_balance": 369678, "short_balance_prev": 359738}, ...]

Phản hồi

{"data": [...]}.

TrườngĐơn vịMô tả
date—Ngày giao dịch
margin_balance / margin_balance_prevlô (張)融資餘額 hôm nay / ngày trước
margin_balance_valueTWD融資餘額金額
short_balance / short_balance_prevlô (張)融券餘額 hôm nay / ngày trước

Lỗi

503 kho dữ liệu chưa sẵn sàng hoặc giới hạn tần suất upstream. Khoảng không có dòng nào trả về 200 với "data": [].

Ghi chú

  • Cache máy chủ: 5 phút.

Tỷ lệ ký quỹ duy trì toàn thị trường

GET/studio/market/twmarket/margin_maintenance
Dữ liệu từ
2002-11-26
Tần suất cập nhật
Hằng ngày

Tham số

TênMô tảGiá trị hợp lệMặc định
start
string · query
Ngày đầu tiênYYYY-MM-DD2002-11-26
end
string · query
Ngày cuối cùngYYYY-MM-DDhôm nay

Ví dụ

Python
data = requests.get(f"{BASE_URL}/studio/market/twmarket/margin_maintenance", headers=headers,                    params={"start": "2026-10-01"}, timeout=60).json()["data"]# Live capture 2026-11-06 (abridged with ...):# [{"date": "2026-10-01", "maintenance_ratio": 195.084}, {"date": "2026-10-02", "maintenance_ratio": 197.024},#  ..., {"date": "2026-11-06", "maintenance_ratio": 151.93}]   # 24 trading days

Phản hồi

{"data": [...]}, mỗi ngày giao dịch một dòng, cũ nhất trước.

TrườngĐơn vịMô tả
date—Ngày giao dịch
maintenance_ratio%融資維持率 toàn thị trường của cổ phiếu niêm yết TWSE (ví dụ 151.93 = 151.93%)

Lỗi

Mã trạng tháiNội dung phản hồiTrường hợp
400{"error": "Invalid start date, expected YYYY-MM-DD"} (hoặc end)Ngày sai định dạng
400{"error": "start must not be after end"}Khoảng bị đảo ngược
503{"error": "Market data is not ready on this server. Please retry later."}Kho dữ liệu chưa sẵn sàng
503{"error": "Upstream rate limit. Please retry shortly."}Quota upstream đã hết

Ghi chú

  • Chỉ gồm cổ phiếu niêm yết TWSE (上市); không có chuỗi OTC (上櫃).
  • Tỷ lệ này là giá trị thị trường của cổ phiếu mua ký quỹ chia cho khoản vay ký quỹ, tính theo phần trăm. Mỗi tài khoản dưới 130% sẽ bị gọi ký quỹ, nên khi con số toàn thị trường giảm dần về mức đó, khả năng bán giải chấp tăng lên.
  • Cache máy chủ: 5 phút.

Điểm cổ tức hằng ngày của TAIEX

GET/studio/market/twmarket/dividend_points
Dữ liệu từ
2003-01-02 (thực tế); dự báo đến hôm nay + 120 ngày
Tần suất cập nhật
Hằng ngày, khoảng 17:00 giờ Đài Bắc (thực tế)

Tham số

TênMô tảGiá trị hợp lệMặc định
start
string · query
Ngày đầu tiênbắt buộc đúng YYYY-MM-DD2003-01-02
end
string · query
Ngày cuối cùng; âm thầm bị giới hạn ở hôm nay + 120 ngàybắt buộc đúng YYYY-MM-DDhôm nay + 120 ngày

Ví dụ

Python
import pandas as pdpayload = requests.get(f"{BASE_URL}/studio/market/twmarket/dividend_points", headers=headers,                       params={"start": "2026-08-01"}, timeout=60).json()# {"data": [{"date": "2026-08-03", "points": 2.853, "estimated": false}, ...,#           {"date": "2026-08-28", "points": 3.846, "estimated": true}, ...],#  "meta": {"estimated_coverage": 0.9999, "degraded": false}}df = pd.DataFrame(payload["data"])future_div = df[df["estimated"]].set_index("date")["points"]# fair basis at t for settlement T: futures_price - (spot_index - future_div.loc[t_plus_1:T].sum())

Phản hồi

{"data": [{"date", "points", "estimated"}], "meta": {"estimated_coverage", "degraded"}}.

TrườngKiểuMô tả
data[].datestringNgày
data[].pointsfloatSố điểm chỉ số bị trừ do các sự kiện trừ cổ tức trong ngày đó
data[].estimatedboolfalse = thực tế (từ chênh lệch giữa chỉ số TR và chỉ số giá; ngày không có sự kiện ≈ 0); true = dự báo (các ngày trong tuần ở tương lai, điền không ở nơi không có sự kiện)
meta.estimated_coveragefloat | nullPhần tỷ trọng TAIEX có dữ liệu đầu vào đọc được cho dự báo; null khi không có dòng ước tính
meta.degradedbooltrue = dự báo thiếu độ phủ đáng kể — hãy coi là cận dưới

Lỗi

Mã trạng tháiNội dung phản hồiTrường hợp
400{"error": "Invalid start date, expected YYYY-MM-DD"} (hoặc end)Ngày sai định dạng
503thông báo lỗiĐộ phủ dự báo dưới 90%, kho dữ liệu chưa sẵn sàng, hoặc giới hạn tần suất upstream

Ghi chú

  • Trước ~17:00 giờ Đài Bắc, dòng thực tế mới nhất là của ngày giao dịch trước đó.
  • Các dự báo xa hơn ~2 tuần dựa vào mẫu của năm trước.
  • Các dòng dự báo luôn được trả về từ ngày mai đến end, kể cả khi start muộn hơn ngày mai — hãy lọc phía client.
  • Cache máy chủ: 5 phút (dữ liệu đầu vào của dự báo 1 giờ).
  • Phần thực tế là chỉ số tổng lợi nhuận so với chỉ số giá; dự báo dùng cổ tức đã công bố cộng với mẫu của năm trước.