すべてのAPI

DART APIの対応範囲が稼働中

DART による韓国企業の開示書類と財務諸表を公開しています。金額は提出時のウォンのままです。

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

最初のリクエスト

企業の開示書類を一覧表示する

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/filings" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

エンドポイント

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 のように、項目名をカンマで区切ります。


リファレンス全文 →
GET5%以上の保有者を取得する/v1/companies/{company_id}/holders

5%以上の保有者。報告された保有割合、株数、それを報告した開示書類付き。

パラメータ

  • company_id必須

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


リファレンス全文 →

ユースケース

スケジュールで更新する

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

ガイドを読む →

新しい開示書類の通知を受け取る

開示書類の公開時にウェブフックを受け取り、検証します。

ガイドを読む →

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

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

ガイドを読む →

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

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

ガイドを読む →

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

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

ガイドを読む →

カバレッジ

  • 韓国これまでのところ、上場企業の約半数。

ソース

関連 API

NarwhalでSEC EDGAR APIを使う

SEC EDGAR による米国の開示書類と標準化された XBRL 財務データ、公開中

APIを見る →

EDINET APIの対応範囲が稼働中

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

APIを見る →

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

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

APIを見る →

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

data.gov.tw の TWSE OpenAPI と TPEx オープンデータによる台湾の企業財務データ

APIを見る →

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

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

APIを見る →

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

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

APIを見る →

よくある質問

韓国の開示書類の対象は公開済みですか。

はい。上場企業の約半数が読み込み済みで、順次追加されています。

韓国では、どの報告期間が使われますか。

韓国の財務諸表の対象は、年次と四半期のみです。

韓国の大量保有報告書は含まれますか。

はい。DART の5%報告書が含まれます。

DART のソース

DART は、韓国の金融監督院の開示システムです。

ウォンの金額

財務金額は、開示書類で報告されたとおりのウォンのままです。

一部のみ読み込み済み

上場企業の約半数が読み込み済みです。