台湾株 API

パラメータ

なし。

レスポンス

{"data": [...]}、約 2,400 行（上市＋上櫃、ETF を含む。興櫃は除く）。

エラー

共通エラーのみ（両市場とも取得に失敗した場合は 500）。

備考

• ユニバースの構築に使います。サンプリングするときは業種を分散させてください。コードは業種ごとにまとまっているため、[:N] で切り詰めると少数の業種に偏ります。
• リストが約 2,400 件より明らかに短い場合は、片方の市場の読み込みに失敗しています。上場廃止ではなく、データ不完全として扱ってください。
• 片方の市場の読み込みに失敗した場合、サーバーキャッシュは 10 分に短縮されます。

パラメータ

レスポンス

{"stock_id": "<stock_id>", "data": {...}}。data のフィールドは /list の一行と同じです。

エラー

備考

• /list と同じキャッシュから返します。

パラメータ

レスポンス

{"stock_id": "<stock_id>", "data": [ ... ]}。行は date の昇順。

エラー

備考

• start／end は形式を検証しません。形式が不正な値は 400 を返さず、文字列比較で絞り込まれます。必ず YYYY-MM-DD で送ってください。
• トータルリターンのバックテストには price_adj を使ってください。このエンドポイントは未調整の価格です。
• 多数の銘柄を取得する場合は、このエンドポイントをループさせず batch/price（リクエストごとに ≤ 50 銘柄）を使ってください。
• 提供する最も古い日付は 1994-10-01 です。それより後に上場した銘柄は開始日が遅くなります。
• 当日の行は TWSE／TPEx の公式終値ファイルから取得し、公表後（台北時間 14:00 頃）に追加されます。
• サーバーキャッシュ：5 分。

パラメータ

/price/<stock_id> と同じ。

レスポンス

構造とフィールドは /price/<stock_id> と同じです。open／high／low／close は調整後の価格、volume／turnover_* は未調整の系列と同一です。

エラー

/price/<stock_id> と同じ。

備考

• 現金配当と株式配当に対する調整（後復權／向後調整）です。初期の価格は実際の約定価格のままで、各権利落ち日以降の価格に累積係数を掛けるため、直近の調整後価格は未調整の価格より高くなります。トータルリターンのバックテストに使います。
• 未調整の /price 系列が更新されると再構築されます。
• サーバーキャッシュ：5 分。

パラメータ

レスポンス

{"stock_id": "<stock_id>", "data": {...}}。data はフラットなオブジェクトです。

エラー

備考

• 日中の価格確認専用です。履歴はなく、バックテストには使えません。
• サーバーキャッシュ：10 秒。

パラメータ

レスポンス

{"data": {"<stock_id>": {...quote fields...}, ...}}。フィールドは /quote/<stock_id> と同じです。相場データのない銘柄は含まれません。

エラー

備考

• サーバーキャッシュ：10 秒。

パラメータ

なし。

レスポンス

{"data": [{...quote fields...}, ...]}（約 2,800 行）。フィールドは /quote/<stock_id> と同じです。

エラー

備考

• サーバーキャッシュ：10 秒。

パラメータ

リクエストあたりの最大範囲（end − start）：1m 31 日 · 5m 62 日 · 15m 93 日 · 30m 186 日 · 60m 365 日 · 1d 3650 日。

レスポンス

{"stock_id", "schema", "data": [...]}.

エラー

備考

• カバー範囲はリクエストに応じて広がります。上場銘柄ならどれでも照会でき、初回の照会で直近約 30 日分を取り込み、その銘柄をリアルタイム追跡の対象に登録します。その後、過去の履歴（2019-01 以降）をバックフィルします。数年分の履歴をリクエストする前に minute/ohlcv/symbols を確認してください。
• データのない範囲は 200 と [] を返します。
• 形成中の足は返しません。現在の価格は /quote/<stock_id> を使ってください。
• 長い期間は、時間足ごとの上限に収まるよう分割してください。

パラメータ

なし。

レスポンス

{"data": ["2330", "TAIEX", ...]}：分足データをすでに保持している銘柄コード（現在上場中の銘柄と TAIEX）。ソート済み。

エラー

共通エラーのみ。

パラメータ

レスポンス

{"stock_id", "data": [...]}、昇順。

エラー

備考

• レガシーのエンドポイントです。minute/ohlcv/<stock_id>/1m の利用を推奨します。分足データのない上場銘柄は [] を返します（このエンドポイントは取り込みを開始しません）。
• 当日の足は日中の暫定データで、台北時間 16:10 頃以降に公式の足へ置き換わります。
• データがあるのは minute/ohlcv/symbols に含まれる銘柄だけです。

パラメータ

レスポンス

{"stock_id", "data": [{"date", "stock_id", "market_value"}]}。market_value の単位は台湾ドルです。

エラー

400 stock_id が不正、404 データなし、503 アップストリームのクォータ超過。

備考

• サーバーキャッシュ：5 分。

パラメータ

レスポンス

{"date": "YYYY-MM-DD", "twse_ex_etf_market_value": int, "data": [...]}。時価総額の降順。

エラー

備考

• ユニバースは上市＋上櫃＋ETF です（興櫃は除く。ETN はデータなし）。「時価総額の上位 N 銘柄」のような問いには、/market_value/<stock_id> をループさせず、このエンドポイントを使ってください。
• rank と twse_ex_etf_market_value はユニバースが異なります。rank は市場全体（上市＋上櫃、ETF を含む）の順位で、分母を追加した後も変わっていません。分母は上市のみで、ETF（industry_category が {ETF, 上櫃ETF, 上櫃指數股票型基金(ETF)} のいずれか）を除きます。REIT と優先株は除かれません。したがって market_value / twse_ex_etf_market_value が指数ウェイトになるのは、market が "TWSE" で ETF でない行だけです。TPEx または ETF の行をこの分母で割ってもウェイトにはなりません。一方、rank は市場全体の順位のままです。この二つを同じランキングとして読まないでください。
• market は上場市場のタグであり、ETF フラグではありません。ETF フラグは is_etf です。ETF を除いたユニバースを作るときはこれを使います。stock_id の先頭から ETF を推測しないでください（00 は市場の慣例であって仕様ではなく、REIT の 01xxxT も拾えません）。分類を別の場所から取得し直すこともしないでください。is_etf は twse_ex_etf_market_value の計算に使う基準そのものなので、is_etf による絞り込みと分母が食い違うことはありません。
• サーバーキャッシュ：30 分。

パラメータ

レスポンス

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

エラー

400 stock_id が不正、404 データなし、503 アップストリームのクォータ超過。

備考

• 多数の銘柄をバリュー指標でスクリーニングする場合は batch/per を使ってください。
• 当日の行は TWSE／TPEx の公式公表データから取得し、同日午後に追加されます。
• サーバーキャッシュ：5 分。

パラメータ

レスポンス

{"stock_id", "data": [...]}、ロング形式（四半期ごと・項目ごとに一行）。

エラー

400 stock_id が不正、404 データなし、503 アップストリームのクォータ超過。

備考

• start の既定値は 2013-01-01 です。それより前の start を送ると、より古い行が返ります（2330 は 2000-06-30 まで遡れます）。
• サーバーキャッシュ：24 時間。

パラメータ

/financials/<stock_id> と同じ。

レスポンス

/financials/<stock_id> と同じロング形式です。主な type コード：CashAndCashEquivalents、TotalAssets、TotalLiabilities、TotalEquity。末尾が _per のコードは総資産に対する % です。

エラー

400 stock_id が不正、404 データなし、503 アップストリームのクォータ超過。

備考

• start の既定値は 2013-01-01 です。それより前の start を送ると、より古い行が返ります（2330 は 2012-12-31 まで遡れます）。
• サーバーキャッシュ：24 時間。

パラメータ

/financials/<stock_id> と同じ。

レスポンス

/financials/<stock_id> と同じロング形式です。主な type コードは次のとおりです（アップストリームのデータセット独自のコードです。全体の集合は会社や年度によって異なるため、レスポンスを正とし、下記にないものは origin_name で判別してください）。絞り込みには origin_name ではなく type を使ってください。同じコードでも、年度によって項目名の括弧が全角と半角で入れ替わります：

フロー項目は、台湾での申告どおり年初来（YTD）累計です。03-31 の行は Q1 のみ、06-30 は Q1–Q2、09-30 は Q1–Q3、12-31 は通期です。単一四半期の値は、同じ年の前の四半期を差し引いて求めます（Q1 は差し引き不要）。そのため start は 1 月から取得してください。CashBalancesEndOfPeriod は四半期末の残高、CashBalancesBeginningOfPeriod は年初の残高です。このエンドポイントに period パラメータはなく、常に YTD を返します（単一四半期を表示する ?period=quarter はウェブのチャート用ルートにしかなく、ここにはありません）。

エラー

400 stock_id が不正、404 データなし、503 アップストリームのクォータ超過。

備考

• start の既定値は 2013-01-01 です。それより前の start を送ると、より古い行が返ります（2330 は 2012-03-31 まで遡れます）。
• サーバーキャッシュ：24 時間。

パラメータ

レスポンス

{"stock_id", "data": [...]}、月ごとに一行。

エラー

400 stock_id が不正、404 データなし、503 アップストリームのクォータ超過。

備考

• サーバーキャッシュ：24 時間。

パラメータ

レスポンス

{"stock_id", "data": [...]}、ワイド形式：四半期ごとに一行、古い順、比率ごとに一列。各比率は小数第 4 位に丸めた float、または null です。

<ratio>（それぞれ _q と _ttm の両方があります）：

サフィックスなしの列：debt_ratio、current_ratio、quick_ratio は %（×100 済み。流動比率 2.46 倍は 245.7635 で返ります）、equity_multiplier は倍です。

エラー

備考

• 単一四半期の ROE／ROA は年率換算していません。一株あたりの数値には、純利益 ÷ EPS から求めた株式数を使います。銀行・証券会社・保険会社では、いくつかの比率が常に null です（売上総利益率、流動比率などがありません）。
• 行の日付は四半期末ですが、その四半期の決算が公開されるのは数週間後です。バックテストでは各行を利用可能日（法定の申告期限。財務諸表と同じ）までずらしてください。date でそのまま結合すると先読みバイアスになります。
• 項目の欠落や分母がゼロの場合は null を返し、0 にはなりません。
• 含まれないもの：PER／PBR／配当利回り（日次。per/<stock_id> を使用）と、月次売上高に関する比率（前年比／前月比は monthly_revenue/<stock_id> から計算してください）。
• 多数の銘柄 → GET /studio/market/twstock/batch/ratios?stock_ids=...（リクエストごとに ≤ 50 銘柄）。
• 2013-03-31 が下限です。それより前の start を送っても、より古いデータは返りません。
• 財務諸表を更新するのと同じジョブで、一日二回（13:30 と 23:00 UTC）再計算します。
• サーバーキャッシュ：6 時間。

パラメータ

範囲の絞り込みには三段階の効力発生日を使います。cash_ex_date があればそれ、なければ stock_ex_date、それもなければ record_date です。そのため、発表直後で権利落ち日が未定のイベントも返ります。

レスポンス

{"stock_id", "data": [...]}、公告の一行につき一行。

エラー

備考

• 値がゼロの行（cash == 0 かつ stock == 0）も残します。無配の決定が公告されたことを表します。
• 効力発生日は将来の日付になることがあります（公告済みで権利落ち前）。2330 の全履歴を取得したとき、最後の行はリクエスト日の一週間先でした。過去のイベントだけが必要な場合は、日付で絞り込んでください。
• 有効な銘柄で配当履歴はあるが、範囲内にイベントがない場合は 200 ＋ [] を返します（404 とは異なります）。
• 上場廃止の銘柄は 404 です。

パラメータ

レスポンス

{"stock_id", "data": [...]}、一日に複数の記事（週末を含む）。

エラー

備考

• カバー範囲は 2020 年半ば頃から始まります（最も古い行は 2020-08 で、正確な開始時点は公開されていません）。2021-02 頃までは一日に数件、または記事なしと少なく、それより前の日付は [] を返すことがあります。
• 各日の記事は、その日に対する最初のリクエスト時に取得します。
• サーバーキャッシュ：5 分。

パラメータ

レスポンス

{"stock_id", "data": [...]}、ワイド形式、一日につき一行。値の単位はすべて株（股）です。

エラー

400 stock_id が不正、404 データなし、503 アップストリームのクォータ超過。

備考

• 買い越し = *_buy − *_sell。
• 銘柄単位のデータで、区分の集約はしていません。これらは区分ごとの元の列で、どうまとめるかは利用者が決めます。Blave の銘柄別の画面（ウェブ、アプリ、AI チャット）では、取引所の列名に合わせて外資自營商を外資に含め、自營商を自行買賣と避險の合計として扱います。市場全体のエンドポイント（GET /studio/market/twmarket/institutional）はまとめ方が異なります。該当のセクションを参照してください。
• 当日の行は TWSE／TPEx の公式公表データから取得し、取引所の公表後に追加されます。
• サーバーキャッシュ：5 分。

パラメータ

レスポンス

{"stock_id", "data": [...]}、一日につき一行。値の単位は株ではなくロット（張）です。TWSE MI_MARGN と照合して確認済み：2026-09-15 の 2330 は margin_balance: 29282 と margin_limit: 6483092 を返し、同日の TWSE 公表値である今日餘額 29,282、次一營業日限額 6,483,092 と完全に一致しました。各行はそれぞれ date と stock_id を持ちます。全履歴を読む場合（start／end なし）は、すべての数値を同じ行から取ってください。margin_limit は毎日公表し直され、時期によって変わります。

エラー

400 stock_id が不正、404 データなし、503 アップストリームのクォータ超過。

備考

• サーバーキャッシュ：5 分。

パラメータ

レスポンス

{"stock_id", "data": [...]}、日付 × 区分ごとに一行。

エラー

400 stock_id が不正、404 データなし、503 アップストリームのクォータ超過。

備考

• 数値は TDCC（集保結算所）が公表する株主分散表です。
• サーバーキャッシュ：5 分。

パラメータ

レスポンス

{"stock_id", "data": [...]}、一日につき一行。

エラー

400 stock_id が不正、404 データなし、503 アップストリームのクォータ超過。

備考

• start の既定値は 2013-01-01 です。それより前の start を送ると、より古い行が返ります（2330 は 2004-02-12 まで遡れます）。
• サーバーキャッシュ：24 時間。

パラメータ

レスポンス

{"stock_id", "data": [...]}、一日あたり最大 8 行（銀行ごとに一行）、日付・銀行の順でソート。

エラー

備考

• サーバーキャッシュ：5 分。

パラメータ

レスポンス

{"stock_id", "data": [...]}、一日に複数行。

エラー

400 stock_id が不正、404 データなし、503 アップストリームのクォータ超過。

備考

• サーバーキャッシュ：5 分。

パラメータ

レスポンス

{"query": "<name>", "data": [{"broker_id", "broker_name"}]}.

エラー

パラメータ

単日は date を、範囲は start（＋ end）を送ります。両方を送った場合は start が優先されます。

レスポンス

{"stock_id", "data": [...]}、支店ごと・日ごとに一行。

エラー

備考

• データのない日（休場日、2021-06-28 より前、当日の 21:30 頃より前）は 200 ＋ [] です。
• 範囲指定は実際に機能します。start／end を 2026-09-06 → 2026-09-13 にすると、broker/stock/<stock_id> と broker/trader/<trader_id> のどちらも、五つの取引日にまたがる行を返しました。
• サーバーキャッシュ：5 分。

パラメータ

date／start／end のルールは /broker/stock/<stock_id> と同じです。

レスポンス

{"trader_id", "data": [...]}、銘柄ごと・日ごとに一行。フィールドは date、broker_id、broker_name、stock_id、price、buy、sell（/broker/stock と同じ）。

エラー

/broker/stock/<stock_id> と同じです。加えて、コードが不正な場合は 400 {"error": "Invalid trader_id"} を返します。

備考

• サーバーキャッシュ：5 分。

パラメータ

date を指定するか、start／end を指定するか、どちらも指定しません（= 台北時間の今日）。

範囲の意味：処置はその期間（start–end）が範囲と重なる場合に、注意は公告の date が範囲内にある場合に返ります。stock_id を指定しない場合、範囲は両端を含めて最大 366 日です。市場全体でそれより長い範囲は分割してください（リクエストごとに一暦年なら収まります）。このカテゴリの既定と異なり、start／end／date は厳密に検証されます。

レスポンス

{"start", "end", "data": [...]}。start／end には実際に適用された範囲が入ります（date を送った場合はどちらも date と同じ）。行は date、market、kind、stock_id の順でソートされます。公告ごとに一行です。

エラー

備考

• 処置は引け後に公告され、翌取引日から効力が生じます。date は公告日、start は効力が生じる最初の日です。「D 日に処置中か」を調べるには、公告日ではなく date=D（または start=end=D）を使ってください。
• 一つの銘柄で処置期間が重なることがあります（最初の処置期間中に第二次處置が公告される場合）。
• start／end は公告された期間です。期間中に休場日や売買停止があると実際の終了日は延びますが、このデータには記録されません。
• match_minutes は当時の規則に従います（TPEx は 5／20 分 → 2026-08-10 から 2 分）。行ごとに読み取り、固定値を前提にしないでください。
• 処置前の候補リスト（處置候選）は含まれません。
• 出典は「資料來源：臺灣證券交易所、證券櫃檯買賣中心」と表記してください。
• TWSE の開始日は、処置と注意の両方に当てはまります。
• TPEx の夕方の公告は、07:00 の実行で初めて反映されることがあります。

パラメータ

レスポンス

{"data_type", "data": {"<stock_id>": [...rows...]}, "failed": [...]}。行は対応する単一銘柄のエンドポイントと同一です。

• failed：サーバー側での取得に失敗した銘柄コード（レート制限またはアップストリームのエラー）。これらは再試行してください。
• data にも failed にも含まれない銘柄コードは、実際にデータがありません。

エラー

備考

• 市場全体（約 2,000 銘柄）でも約 40 回の呼び出しで済みます。単一銘柄のエンドポイントを大量に並列で呼ばないでください。
• ratios（財務比率）：各銘柄コードの行は、/ratios/<stock_id> のワイド形式の四半期ごとの行です（"data": {"2330": [{"date": "2026-06-30", "stock_id": "2330", "roe_q": 11.3934, ...}], "2317": [...]}）。財務諸表のないコード（ETF）は data にも failed にも含まれません（404 は返しません）。比率ストアが未準備の場合は、すべての銘柄コードが failed に入ります（503 は返しません）。
• dividend は /dividend/<stock_id> と異なります。保存済みのデータだけを読み（更新はしません）、不明な銘柄コードや配当履歴のない銘柄は何も通知されずに結果から外れ（404 は返しません）、アップストリームのクォータの問題は 503 ではなく failed に現れます。