スケジュールで更新する
小さなスクリプトで、新しい開示書類と数値を毎日取得します。
ガイドを読む →すべてのAPI
企業の大株主を調べる大量保有報告書API
米国、日本、韓国の5%以上の保有者を、名前、報告された割合、株数、イベント日、開示書類の参照とあわせて読み取れます。
最初のリクエスト
5%以上の保有者を取得する
curl --request GET \
--url "https://api.narwhalapi.com/v1/companies/usa:0000789019/holders" \
--header "Authorization: Bearer $NARWHAL_API_KEY"エンドポイント
GET5%以上の保有者を取得する/v1/companies/{company_id}/holders
5%以上の保有者。報告された保有割合、株数、それを報告した開示書類付き。
パラメータ
company_id必須usa:0000789019 のような企業ID、または usa:MSFT のようなティッカーのエイリアス。
レスポンスフィールド
holderフィールド保有者名で、住所や個人 ID 番号は含まれません
percentフィールド開示書類に書かれたとおりの保有割合です。5.12 は 5.12% を意味します
sharesフィールド保有者について報告された株数
event_dateフィールド開示書類で報告された保有に関するイベントの日付
filedフィールド保有に関する開示書類が提出された日付
filing_idフィールド保有を報告した保有に関する開示書類の識別子
securityフィールド開示書類で有価証券が示されている場合の、有価証券のクラス、種類、isin
リファレンス全文 →
ユースケース
カバレッジ
- 米国開示書類と財務諸表。2009年からの履歴。
- 日本3,800社超。年次と半期。
- 韓国これまでのところ、上場企業の約半数。
ソース
- 米国SEC EDGAR
- 日本EDINET、金融庁
- 韓国DART、金融監督院
関連 API
よくある質問
このエンドポイントは、すべての株主を一覧にしますか。
保有者エンドポイントは、保有に関する開示書類で報告された5%以上の保有者を対象としています。
どの日付と開示書類の参照が返されますか。
各保有者のレコードには、保有者名、パーセント、株数とあわせて、event_date、filed、filing_id が含まれます。
ティッカーのエイリアスを使って保有者をリクエストできますか。
このエンドポイントは、usa:0000789019 のような会社識別子のほか、usa:MSFT のような受け付けられるエイリアスも受け付けます。
保有者の履歴はどこまでさかのぼれますか。
すべてのアカウントで全履歴を取得でき、リアルタイムで提供されます。
提出時のパーセント
パーセントの値が 5.12 の場合は 5.12% を意味し、開示書類に記載されたパーセンテージと一致します。
名前のみ
保有者のレコードには名前が含まれ、住所や個人 ID 番号は含まれません。
名前がある場合の有価証券
開示書類で有価証券が示されている場合、security オブジェクトに class、type、isin が含まれます。
無料キーで始めましょう
12か月間、毎月10ドル分の無料クレジット。カードは不要です。毎月10ドル分の無料クレジット。カードは不要です。