すべてのAPI

台湾の開示書類を扱うMOPS API

台湾の TWSE と TPEx に上場する約1,980社の財務諸表を取得できます。この API が現在対象としているのは、2026年の半期報告書です。

稼働中97.81% uptime, last 30日295 ms 標準応答

最初のリクエスト

半期財務情報を取得する

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/twn:2330/financials?period=semiannual&fields=revenue,net_income,total_assets" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
レスポンスの例
{
  "id": "twn:2330",
  "currency": "TWD",
  "semiannual": [
    {
      "fy": 2026,
      "fh": 1,
      "end": "2026-06-30",
      "derived": [],
      "revenue": "2404483690000",
      "net_income": "1279041690000",
      "total_assets": "9375654727000"
    }
  ],
  "as_of": "2026-10-24"
}

エンドポイント

GET企業を一覧する/v1/companies

企業名で検索してIDを取得します。そのIDを、ほかのすべての呼び出しで使います。

パラメータ

  • q任意

    企業名などの検索テキスト。


リファレンス全文 →
GET企業の開示書類を一覧表示する/v1/companies/{company_id}/filings

企業の開示書類を新しい順に並べたもので、各書類の公式コピーへのリンク付きです。

パラメータ

  • company_id必須

    usa:0000789019 のような企業ID、または usa:MSFT のようなティッカーのエイリアス。

  • type任意

    annual などの開示書類のカテゴリ。


リファレンス全文 →
GET標準化された企業の財務諸表を取得/v1/companies/{company_id}/financials

企業の標準化された財務諸表。期間ごとに1行で、提出時の通貨で表示されます。

パラメータ

  • company_id必須

    usa:0000789019 のような企業ID、または usa:MSFT のようなティッカーのエイリアス。

  • period任意

    レジストリに応じて annual または semiannual。

  • statement任意

    income、balance、cash_flow、per_share のいずれか。

  • fields任意

    revenue,net_income のように、項目名をカンマで区切ります。


リファレンス全文 →

ユースケース

企業データを数年分読み込む

長い履歴をページ送りで取得し、ジョブが止まっても再開します。

ガイドを読む →

スケジュールで更新する

小さなスクリプトで、新しい開示書類と数値を毎日取得します。

ガイドを読む →

利用上限を超えないようにする

レスポンスをキャッシュし、リクエストを失うことなく429エラーに対処します。

ガイドを読む →

企業についてエージェントに質問する

MCPを通じて、LLMエージェントに開示書類と財務情報の読み取りアクセスを与えます。

ガイドを読む →

カバレッジ

  • 台湾約1,980社。2026年の半期報告書。

ソース

  • 台湾TWSEおよびTPExの上場企業

関連 API

企業の年次報告を扱うESEF API

EU・EEA 26か国の企業の年次報告書

APIを見る →

Companies House APIで英国企業の財務報告

英国の規制市場の発行体による年次報告書

APIを見る →

EDINET APIの対応範囲が稼働中

日本の開示書類と財務諸表、公開中

APIを見る →

DART APIの対応範囲が稼働中

韓国の開示書類と財務諸表、公開中

APIを見る →

企業開示書類APIで開示書類を取得

開示書類の一覧、個別のレコード、企業をまたいだ最新の開示書類

APIを見る →

よくある質問

台湾の会社 ID はどのような仕組みですか。

台湾の会社 ID は、twn: と証券コードを組み合わせたものです。例: twn:2330。

貸借対照表は、どの日付を対象としていますか。

貸借対照表は、各報告日ごとに提供されます。

台湾の5%以上の保有者は含まれますか。

いいえ。台湾の5%以上の保有者は含まれません。

TWSE OpenAPI と TPEx オープンデータ

data.gov.tw 上の台湾政府オープンデータライセンス第1.0版に基づき、台湾証券取引所(TWSE)の OpenAPI と台北取引所(TPEx)のオープンデータを使用しています。これらのソースは MOPS の開示書類を反映しています。

半期の数値

損益と1株あたりの数値は、半期の累計です(period=semiannual)。通期の数値は、年次報告書とともに追加されます。

台湾ドルの整数

金額は、千単位のソース値を拡大した台湾ドルの整数です。EPS などの1株あたりの数値は小数で、拡大されません。