大量保有者APIリファレンス

Schedule 13Dと13Gに基づく、企業の5%超の保有者

概要

大量保有者とは、米国企業の株式を5%超保有する個人や会社です。支配権を求める可能性のある保有者はSchedule 13D（activistのタグ）、パッシブな保有者はSchedule 13G（passiveのタグ）で報告し、どちらの修正も報告します。すべてのリクエストにBearerキーが必要で、RESTとMCPは1つのクレジット残高を共有します。

4つのルートで、企業の大量保有者、1つの保有者の企業横断の大量保有、保有者または企業を探す2つの名前検索を取得できます。企業はFilings APIのID（例：usa:0000320193）で指定します。保有者はCIKで指定します。

デフォルトでは、ルートは現在の保有を返します：各保有者の各種類株式における最新の提出書類。最新の提出書類が撤退を報告している保有、または同じ提出者グループの後の提出書類で除かれた保有は、一覧に載りません。全提出書類を新しい順に読むにはhistory=trueを送ります。

履歴は2024年10月の提出書類から始まります。保有者のstakesのページは、limitより行数が少なくてもnext_cursorが付くことがあるので、next_cursorがnullになるまで読み続けてください。対応しているのは米国のみです。

ベースURL： https://api.narwhalapi.com。以下の各ルートは、同じパラメータを持つ独立したMCPツールです。

役員、取締役、10%保有者は次にあります：インサイダー取引のページ。

企業IDは次が返すものです：開示書類 API 企業検索から返されます。

すべてのアカウントで利用できるもの

課金額	すべてのアカウント
大量保有者、4ルート	含まれる

参照：料金表で、呼び出し1回の料金を確認できます。ルートに別の記載がない限り、リクエストはそのAPIの料金で課金されます。

カレンダー料金ではなくCompanies料金で課金されます。成功した各レスポンスは、行数に関係なく1回の呼び出しです。空のページも課金されます。エラーは課金されません。ヒットのない検索も課金されます。
数値は小数文字列です。値のないフィールドは省略され、リストは常に存在し、officerのようなフラグはtrueの場合だけ返されます。
共同提出には報告者1人につき1行があり、各行はfiling_idを共有します。各報告者は自分のカバーページに同じグループの数値を記載するので、1つの提出書類の人をまたいでsharesを合算しないでください。行をfiling_idでまとめ、グループの数値はgroup_totalから読み取ります。
提出書類に記載がない数値や、正確に読み取れなかった数値は省略されます。推定は行いません。
保有者のページが読み取る企業ファイルは最大30件です。そのため、数百社にわたる共同提出の保有者では、短いページがカーソル付きで返ります。
読み取れない提出書類が少数あり、回答から除かれます。CUSIPは回答に含まれません。

エンドポイント

すべてのルートは GET で、キーを次のヘッダーで渡す必要があります: Authorization: Bearer ヘッダー。例はレスポンスの形を示すもので、ライブデータではありません。

企業の大量保有者を一覧表示

GET /v1/companies/{company_id}/beneficial-owners

Schedule 13Dと13G、およびその修正に基づく、企業の株式の5%超の保有者。デフォルトでは各保有者の各種類株式における現在の保有。historyを指定すると全提出書類を一覧表示します。

日付は、各保有の最新の提出書類を選ぶ前に提出書類を絞り込みます。そのためfiled_lteを使うと、その日時点の企業の大量保有者が得られます。

MCP: ツール filings_list_beneficial_owners。

パラメータ

パラメータ	場所	必須	種別	意味
`company_id`	パス	はい	文字列	企業ID。例：`usa:0000320193`。`usa:AAPL`のようなティッカー別名も使えます。
`schedule`	クエリ	いいえ	one of 13D, 13G	`13D`（支配権を求める可能性のある保有者）または`13G`（パッシブな保有者）だけ。
`type`	クエリ	いいえ	one of activist, passive	`activist`は`13D`と同じ、`passive`は`13G`と同じです。`schedule`も指定する場合は、両者が一致している必要があります。
`history`	クエリ	いいえ	ブール値	`false`（デフォルト）は現在の保有を返します。`true`は全提出書類を新しい順に一覧表示します。
`is_latest`	クエリ	いいえ	ブール値	`history=true`の場合のみ。`true`は各保有の最新の提出書類だけを残し、`false`はそれより前のものを残します。
`filed`	クエリ	いいえ	日付	この日に提出されたものだけ。
`filed_from`	クエリ	いいえ	日付	`filed_gte`と同じ。
`filed_to`	クエリ	いいえ	日付	`filed_lte`と同じ。
`filed_gt`	クエリ	いいえ	日付	この日より後に提出されたものだけ。
`filed_gte`	クエリ	いいえ	日付	この日以降に提出されたものだけ。
`filed_lt`	クエリ	いいえ	日付	この日より前に提出されたものだけ。
`filed_lte`	クエリ	いいえ	日付	この日以前に提出されたものだけ。
`cursor`	クエリ	いいえ	文字列	前のページの `next_cursor`。ほかのパラメータは同じ値にします。
`limit`	クエリ	いいえ	整数	1ページあたりの行数。デフォルトは50、最大1000。

レスポンスフィールド

フィールド	種別	送信	意味
`id`	文字列	常に	ownersルートでは企業ID、stakesルートでは保有者ID。
`company`	文字列	任意	企業の名前。
`owners`	オブジェクトの配列	常に	企業の大量保有者。新しい順。
`owners[].filing_id`	文字列	常に	その行の元となる提出書類のID。
`owners[].form`	one of 13D, 13D/A, 13G, 13G/A	常に	スケジュールと、それが以前のものを修正するかどうか：`13D`、`13D/A`、`13G`、`13G/A`。
`owners[].filed`	日付	常に	提出した日。
`owners[].accepted`	日時	任意	SECが提出を受理した時刻。
`owners[].event_date`	日付	任意	提出が必要になった出来事の日付。
`owners[].amendment_number`	整数	任意	提出書類が示す場合の、修正の番号。
`owners[].filer_id`	文字列	任意	提出書類の最初の提出者のID。提出した会社です。
`owners[].filer`	文字列	任意	最初の提出者の名前。報告者と異なる場合があります。
`owners[].holder_id`	文字列	任意	報告者のID。個人にはありません。
`owners[].holder`	文字列	常に	報告者の名前。
`owners[].holder_type`	文字列	任意	報告者のカバーページコード：`IN`個人、`CO`法人、`PN`パートナーシップ、`IA`投資顧問、`HC`持株会社、`BK`銀行、その他。
`owners[].citizenship`	文字列	任意	報告者の国籍または組織地。
`owners[].class_title`	文字列	任意	株式の種類の名称。
`owners[].shares`	文字列	任意	報告者が保有していると報告した株数。共同提出では、人ごとの値を合算しないでください。`group_total`を使います。
`owners[].percent_of_class`	文字列	任意	報告者が保有していると報告した、種類株式に対する割合（%）。
`owners[].sole_voting_power`	文字列	任意	報告者が単独で議決権を行使できる株数。
`owners[].shared_voting_power`	文字列	任意	報告者が議決権を共有している株数。
`owners[].sole_dispositive_power`	文字列	任意	報告者が単独で売却できる株数。
`owners[].shared_dispositive_power`	文字列	任意	報告者が売却する権限を共有している株数。
`owners[].group_box`	one of a, b, ab	任意	カバーの2行目で報告者がチェックした内容：`a`はグループの構成員、`b`は構成員でないか認めていない、`ab`は両方。
`owners[].rule`	文字列	任意	13Gが提出された根拠規則：`13d-1(b)`、`13d-1(c)`、`13d-1(d)`。
`owners[].funds`	文字列	任意	13Dの資金源コード。例：`WC`、`AF`、`PF`、`OO`。
`owners[].type`	one of activist, passive	任意	Schedule 13Dは`activist`、Schedule 13Gは`passive`。
`owners[].legal_proceedings`	常に true	任意	法的手続きに関するカバーのボックスにチェックがある場合はtrue。
`owners[].excludes_certain_shares`	常に true	任意	特定の株式を除外するカバーのボックスにチェックがある場合はtrue。
`owners[].previously_filed`	常に true	任意	提出書類に以前提出済みのフラグが付いている場合はtrue。
`owners[].issuer_address`	文字列	任意	企業の住所（提出書類の記載どおり）。
`owners[].purpose`	文字列	任意	13Dの項目4、取引の目的。4,000文字で切り詰められます。
`owners[].items`	オブジェクト	任意	13Dの項目1、2、3、5、6、または13Gの項目8のテキスト。それぞれ4,000文字で切り詰められます。提出書類に記載のある項目だけ。
`owners[].joint`	整数	任意	提出書類に名前が挙がっている人数。
`owners[].repeat`	常に true	任意	提出書類で、先に挙がった人がすでに示した数値を、その報告者も示している場合はtrue。
`owners[].group_total`	文字列	任意	共同提出では、構成員が報告した合計のうち最大のもの。グループの数値はここで読み取ります。
`owners[].is_latest`	ブール値	常に	リクエストで対象となった提出書類のうち、その保有の最新のものである場合はtrue。
`owners[].exit`	常に true	任意	提出書類が、保有者の持分を5%以下、または株式なしと報告している場合はtrue。
`owners[].superseded`	常に true	任意	同じ提出者グループの後の提出書類に載っていない保有の、最新の提出書類である場合はtrue。
`next_cursor`	文字列	常に	cursorとして渡すと次のページを読み取れます。常に返され、最後のページではnullです。

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/companies/usa:0000320193/beneficial-owners?limit=1"

{
  "id": "usa:0000320193",
  "company": "Apple Inc.",
  "owners": [
    {
      "filing_id": "usa:0000320193:0002100119-26-000139",
      "form": "13G",
      "filed": "2026-04-29",
      "accepted": "2026-04-29T16:40:10Z",
      "event_date": "2026-03-31",
      "filer_id": "usa:0002100119",
      "filer": "VANGUARD CAPITAL MANAGEMENT LLC",
      "holder_id": "usa:0002100119",
      "holder": "Vanguard Capital Management",
      "holder_type": "IA",
      "citizenship": "PA",
      "class_title": "Common Stock",
      "shares": "1099168953",
      "percent_of_class": "7.48",
      "sole_voting_power": "145321305",
      "shared_voting_power": "0",
      "sole_dispositive_power": "1099168953",
      "shared_dispositive_power": "0",
      "rule": "13d-1(b)",
      "issuer_address": "1 Apple Park Way, Cupertino, CA, 95014",
      "is_latest": true
    }
  ],
  "next_cursor": null
}

保有者の大量保有を一覧表示

GET /v1/investors/{cik}/beneficial-ownership

1つの保有者が企業をまたいで保有しているもの。Schedule 13Dと13Gに基づきます。デフォルトでは各企業の各種類株式における現在の保有。historyを指定すると全提出書類を一覧表示します。ページの行数がlimitより少なくてもnext_cursorが付くことがあります。nullになるまで読み続けてください。

cikは保有者のCIKです。各行のcompany_idとcompanyは、保有先の企業を示します。tickerは1社の保有に絞り込みます。どの企業にも一致しないティッカーは404 company_not_foundです。

ページの行数がlimitより少ないことがあります。next_cursorがnullになるまでnext_cursorをたどってください。

MCP: ツール filings_list_investor_beneficial_ownership。

パラメータ

パラメータ	場所	必須	種別	意味
`cik`	パス	はい	文字列	保有者のCIK。1〜10桁。
`schedule`	クエリ	いいえ	one of 13D, 13G	`13D`（支配権を求める可能性のある保有者）または`13G`（パッシブな保有者）だけ。
`type`	クエリ	いいえ	one of activist, passive	`activist`は`13D`と同じ、`passive`は`13G`と同じです。`schedule`も指定する場合は、両者が一致している必要があります。
`history`	クエリ	いいえ	ブール値	`false`（デフォルト）は現在の保有を返します。`true`は全提出書類を新しい順に一覧表示します。
`is_latest`	クエリ	いいえ	ブール値	`history=true`の場合のみ。`true`は各保有の最新の提出書類だけを残し、`false`はそれより前のものを残します。
`filed`	クエリ	いいえ	日付	この日に提出されたものだけ。
`filed_from`	クエリ	いいえ	日付	`filed_gte`と同じ。
`filed_to`	クエリ	いいえ	日付	`filed_lte`と同じ。
`filed_gt`	クエリ	いいえ	日付	この日より後に提出されたものだけ。
`filed_gte`	クエリ	いいえ	日付	この日以降に提出されたものだけ。
`filed_lt`	クエリ	いいえ	日付	この日より前に提出されたものだけ。
`filed_lte`	クエリ	いいえ	日付	この日以前に提出されたものだけ。
`cursor`	クエリ	いいえ	文字列	前のページの `next_cursor`。ほかのパラメータは同じ値にします。
`limit`	クエリ	いいえ	整数	1ページあたりの行数。デフォルトは50、最大1000。
`ticker`	クエリ	いいえ	文字列	このティッカーの企業における保有だけ。

レスポンスフィールド

フィールド	種別	送信	意味
`id`	文字列	常に	ownersルートでは企業ID、stakesルートでは保有者ID。
`holder`	文字列	任意	保有者の名前。
`stakes`	オブジェクトの配列	常に	保有者の保有。新しい順。
`stakes[].filing_id`	文字列	常に	その行の元となる提出書類のID。
`stakes[].form`	one of 13D, 13D/A, 13G, 13G/A	常に	スケジュールと、それが以前のものを修正するかどうか：`13D`、`13D/A`、`13G`、`13G/A`。
`stakes[].filed`	日付	常に	提出した日。
`stakes[].accepted`	日時	任意	SECが提出を受理した時刻。
`stakes[].event_date`	日付	任意	提出が必要になった出来事の日付。
`stakes[].amendment_number`	整数	任意	提出書類が示す場合の、修正の番号。
`stakes[].filer_id`	文字列	任意	提出書類の最初の提出者のID。提出した会社です。
`stakes[].filer`	文字列	任意	最初の提出者の名前。報告者と異なる場合があります。
`stakes[].holder_id`	文字列	任意	報告者のID。個人にはありません。
`stakes[].holder`	文字列	常に	報告者の名前。
`stakes[].holder_type`	文字列	任意	報告者のカバーページコード：`IN`個人、`CO`法人、`PN`パートナーシップ、`IA`投資顧問、`HC`持株会社、`BK`銀行、その他。
`stakes[].citizenship`	文字列	任意	報告者の国籍または組織地。
`stakes[].class_title`	文字列	任意	株式の種類の名称。
`stakes[].shares`	文字列	任意	報告者が保有していると報告した株数。共同提出では、人ごとの値を合算しないでください。`group_total`を使います。
`stakes[].percent_of_class`	文字列	任意	報告者が保有していると報告した、種類株式に対する割合（%）。
`stakes[].sole_voting_power`	文字列	任意	報告者が単独で議決権を行使できる株数。
`stakes[].shared_voting_power`	文字列	任意	報告者が議決権を共有している株数。
`stakes[].sole_dispositive_power`	文字列	任意	報告者が単独で売却できる株数。
`stakes[].shared_dispositive_power`	文字列	任意	報告者が売却する権限を共有している株数。
`stakes[].group_box`	one of a, b, ab	任意	カバーの2行目で報告者がチェックした内容：`a`はグループの構成員、`b`は構成員でないか認めていない、`ab`は両方。
`stakes[].rule`	文字列	任意	13Gが提出された根拠規則：`13d-1(b)`、`13d-1(c)`、`13d-1(d)`。
`stakes[].funds`	文字列	任意	13Dの資金源コード。例：`WC`、`AF`、`PF`、`OO`。
`stakes[].type`	one of activist, passive	任意	Schedule 13Dは`activist`、Schedule 13Gは`passive`。
`stakes[].legal_proceedings`	常に true	任意	法的手続きに関するカバーのボックスにチェックがある場合はtrue。
`stakes[].excludes_certain_shares`	常に true	任意	特定の株式を除外するカバーのボックスにチェックがある場合はtrue。
`stakes[].previously_filed`	常に true	任意	提出書類に以前提出済みのフラグが付いている場合はtrue。
`stakes[].issuer_address`	文字列	任意	企業の住所（提出書類の記載どおり）。
`stakes[].purpose`	文字列	任意	13Dの項目4、取引の目的。4,000文字で切り詰められます。
`stakes[].items`	オブジェクト	任意	13Dの項目1、2、3、5、6、または13Gの項目8のテキスト。それぞれ4,000文字で切り詰められます。提出書類に記載のある項目だけ。
`stakes[].joint`	整数	任意	提出書類に名前が挙がっている人数。
`stakes[].repeat`	常に true	任意	提出書類で、先に挙がった人がすでに示した数値を、その報告者も示している場合はtrue。
`stakes[].group_total`	文字列	任意	共同提出では、構成員が報告した合計のうち最大のもの。グループの数値はここで読み取ります。
`stakes[].is_latest`	ブール値	常に	リクエストで対象となった提出書類のうち、その保有の最新のものである場合はtrue。
`stakes[].exit`	常に true	任意	提出書類が、保有者の持分を5%以下、または株式なしと報告している場合はtrue。
`stakes[].superseded`	常に true	任意	同じ提出者グループの後の提出書類に載っていない保有の、最新の提出書類である場合はtrue。
`stakes[].company_id`	文字列	常に	保有先の企業のID。
`stakes[].company`	文字列	任意	保有先の企業の名前。
`next_cursor`	文字列	常に	cursorとして渡すと次のページを読み取れます。常に返され、最後のページではnullです。

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/investors/0000102909/beneficial-ownership?filed_lte=2025-10-31&limit=1"

{
  "id": "usa:0000102909",
  "holder": "The Vanguard Group",
  "stakes": [
    {
      "filing_id": "usa:0001770450:0000102909-25-000347",
      "form": "13G/A",
      "filed": "2025-10-31",
      "accepted": "2025-10-31T11:42:47Z",
      "event_date": "2025-09-30",
      "amendment_number": 8,
      "filer_id": "usa:0000102909",
      "filer": "VANGUARD GROUP INC",
      "holder_id": "usa:0000102909",
      "holder": "The Vanguard Group",
      "holder_type": "IA",
      "citizenship": "PA",
      "class_title": "Common Stock",
      "shares": "10397351",
      "percent_of_class": "8.26",
      "sole_voting_power": "0",
      "shared_voting_power": "733054",
      "sole_dispositive_power": "9549123",
      "shared_dispositive_power": "848228",
      "rule": "13d-1(b)",
      "issuer_address": "201 Merritt 7, Norwalk, CT, 06851",
      "is_latest": true,
      "company_id": "usa:0001770450",
      "company": "Xerox Holdings Corp"
    }
  ],
  "next_cursor": "eyJrIjoiNzk3NDg5Njg3OTc0…"
}

名前で大量保有の提出者を検索

GET /v1/beneficial-ownership/filers

Schedule 13Dまたは13Gを提出する保有者を、名前の先頭で探します。stakesルートでcikとして使うidを返します。

stakesルートでcikとして渡すidを返します。名前にはIncなどの語を除いて、英字または数字が2文字以上必要で、そうでない場合は400 invalid_nameです。

MCP: ツール filings_search_beneficial_ownership_filers。

パラメータ

パラメータ	場所	必須	種別	意味
`name`	クエリ	はい	文字列	名前の最初の文字。英字または数字を2文字以上。
`country`	クエリ	いいえ	文字列	検索するレジストリの3文字の国コード。省略はUSAを意味します。ルートが対応していない国は404 not_coveredです。
`limit`	クエリ	いいえ	整数	返すヒット数。デフォルトは20、最大100。

レスポンスフィールド

フィールド	種別	送信	意味
`filers`	オブジェクトの配列	常に	名前がそのテキストで始まる提出者。
`filers[].id`	文字列	常に	提出者のID。stakesルートで`cik`として渡します。
`filers[].name`	文字列	常に	提出者が提出書類で使った名前。

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/beneficial-ownership/filers?name=vanguard&limit=3"

{
  "filers": [
    {
      "id": "usa:0002100119",
      "name": "VANGUARD CAPITAL MANAGEMENT LLC"
    },
    {
      "id": "usa:0001623658",
      "name": "Vanguard Charitable Endowment Program"
    },
    {
      "id": "usa:0002059874",
      "name": "Vanguard Development Holdings Limited"
    }
  ]
}

名前で大量保有者のいる企業を検索

GET /v1/beneficial-ownership/companies

Schedule 13Dまたは13Gの提出書類が出されている企業を、名前の先頭で探します。ownersルートでcompany_idとして使うidを返します。

ownersルートでcompany_idとして渡すidを返します。

MCP: ツール filings_search_beneficial_ownership_companies。

パラメータ

パラメータ	場所	必須	種別	意味
`name`	クエリ	はい	文字列	名前の最初の文字。英字または数字を2文字以上。
`country`	クエリ	いいえ	文字列	検索するレジストリの3文字の国コード。省略はUSAを意味します。ルートが対応していない国は404 not_coveredです。
`limit`	クエリ	いいえ	整数	返すヒット数。デフォルトは20、最大100。

レスポンスフィールド

フィールド	種別	送信	意味
`companies`	オブジェクトの配列	常に	名前がそのテキストで始まる企業。
`companies[].id`	文字列	常に	企業のID。ownersルートで`company_id`として渡します。
`companies[].name`	文字列	常に	企業の名前。

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/beneficial-ownership/companies?name=apple&limit=2"

{
  "companies": [
    {
      "id": "usa:0000320193",
      "name": "Apple Inc."
    },
    {
      "id": "usa:0001418121",
      "name": "Apple Hospitality REIT, Inc."
    }
  ]
}

エラー

エラーは共通の problem 形式で返され、次のコードを含みます: request_id。参照： APIエラーとクレジットで形式とクレジットヘッダーを確認できます。失敗したリクエストには課金されません。

コード	ステータス	意味
`invalid_query`	400	パラメータが欠けている、未知である、重複している、または範囲外です。
`invalid_cursor`	400	このカーソルは、このリクエストが返したものではないか、別のリクエストのものです。
`invalid_name`	400	Incなどの語を除くと、名前の英字または数字が2文字未満です。
`company_not_found`	404	そのIDに一致する企業はありません。
`investor_not_found`	404	そのCIKに一致するSchedule 13Dまたは13Gの提出者はいません。
`not_covered`	404	その市場、国、企業にはまだ対応していません。
`insufficient_credits`	402	クレジット残高が、リクエストの費用に足りません。
`company_data_unavailable`	503	この経路の元になる提出書類を、現在は読み取れません。しばらくしてからもう一度お試しください。

このページは役に立ちましたか?