すべてのドキュメントを閲覧

機関投資家の保有者APIリファレンス

企業を保有する機関投資家と、各機関投資家の保有内容。Form 13Fから

概要

Form 13Fは、運用額が1億ドル以上の機関投資運用者が保有する米国株式とオプションのポジションの四半期報告です。これらのルートでは、どの機関投資家が企業を保有しているか、1つの機関投資家が何を保有しているかを、報告四半期ごとに確認できます。すべてのリクエストにBearerキーが必要で、RESTとMCPは1つのクレジット残高を共有します。

ルートは4つです。1つ目は企業を保有する機関投資家を一覧にします。2つ目は1つの機関投資家の保有内容を一覧にします。3つ目は名前で機関投資家を探します。4つ目は1つの機関投資家の13F提出書類を、各カバーページの数値とともに一覧にします。企業は開示書類APIのID、たとえばusa:0000320193で指定します。機関投資家は自身のCIKで指定し、そのinvestor_idはusa:にCIKを10桁にゼロ埋めしたものです。

四半期は報告四半期末で、たとえば2026-06-30です。省略すると最新の四半期が返ります。各行は1つのポジションで、四半期とその出典の開示書類を示します。金額は、提出書類が使った単位にかかわらず米ドルです。

履歴は2021年9月30日に終わる報告四半期から始まります。periodsは保有している四半期を一覧にします。それより前の四半期が一覧にある場合、その四半期は一部しか読み込まれていないため、保有者数は部分的で、保有者の完全な一覧ではありません。

対象は米国のみです。ほかの国の企業は404 not_coveredです。

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

5%超の保有者は次にあります: 大量保有者のページ、インサイダーは次にあります: インサイダー取引のページ。

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

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

課金額すべてのアカウント
企業の機関投資家含まれる
機関投資家の保有内容含まれる
名前検索と提出書類の一覧含まれる

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

  • 料金はCompanies料金で、1,000回の呼び出しにつき$10です。成功した応答は、行数を問わず1回の呼び出しです。空のページ、ヒットのない検索、エラーは無料です。行とnext_cursorがあるページは課金され、次のページが空なら無料です。
  • 数値は小数文字列です。値のないフィールドは省略され、リストは常に存在し、new_positionのようなフラグはtrueの場合だけ送られます。
  • ページはnext_cursorで終わることがあります。それを、ほかのパラメーターを同じにしてcursorとして送り返します。別のリクエストのカーソルは400 invalid_cursorです。
  • periodがない場合、institutionsルートは最新の四半期を返し、最新の報告がそれ以前の四半期にある機関投資家も、その四半期をperiodに入れて一覧にします。1つの四半期だけを読むにはperiodを送ります。
  • reported_priceは、提出書類に書かれたvalueをsharesで割った値です。提出書類が金額をドルで記載するようになった2023年1月3日以降の提出書類で送られ、元本額と、株数のないポジションでは省略されます。それ以前の提出書類は金額を千単位で記載しており、Narwhalはそれをドルで送ります。
  • shares_typeは、株式ならSH、元本額ならPRNです。put_callはオプションのポジションで送られます。
  • other_managersは、そのポジションを共有する、含まれる他の運用者の番号です。その名前は、filingsルートのother_included_managersにあります。
  • shares_changeとnew_positionは、機関投資家の前の四半期との比較で、holdingsルートが送ります。
  • table_entry_totalは、提出者がカバーページで申告した数です。100件の提出書類のうち約2件で誤っているため、正確な数が必要なら行を数えてください。

エンドポイント

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

企業を保有する機関投資家を一覧する

GET /v1/companies/{company_id}/institutions

Form 13Fで企業のポジションを報告した機関投資家を、金額の大きい順に。各行は、1つの機関投資家の1つのポジションで、1つの報告四半期のものです。

行は金額の大きい順です。すべての機関投資家を読むには、next_cursorでページを送ります。

MCP: ツール filings_list_institutional_holders。

パラメータ

パラメータ場所必須種別意味
company_idパスはい文字列企業ID。例:usa:0000320193。usa:AAPLのようなティッカー別名も使えます。
periodクエリいいえ日付報告四半期末。例:2026-06-30。省略すると最新の四半期です。当社にデータがない四半期は404 period_not_publishedです。
cursorクエリいいえ文字列前のページの next_cursor。ほかのパラメータは同じ値にします。
limitクエリいいえ整数1ページあたりの行数。デフォルトは100、最大500。

レスポンスフィールド

フィールド種別送信意味
id文字列常に企業ID。
period日付任意返された報告四半期末。holdingsルートで四半期の範囲を指定した場合は省略されます。
periodslist of date常に保有している報告四半期末。新しい順です。
built_at文字列任意応答の元になったファイルが作成された時刻(UTC)。
holdersオブジェクトの配列常に企業を保有する機関投資家。金額の大きい順です。
holders[].investor_id文字列常に機関投資家のID。usa:にCIKを10桁にゼロ埋めしたものです。
holders[].investor文字列任意機関投資家の名称。提出書類のとおりです。
holders[].filing_id文字列常にこの行の元になった13F提出書類のID。
holders[].form文字列常に提出書類のフォーム。例:13F-HR。
holders[].reportalways "combination"任意提出書類が複合報告のときはcombinationです。ほかの運用者のポジションを含みます。
holders[].amendmentone of restatement, new_holdings, unstated任意訂正が、訂正対象の提出書類に対して行うこと:restatement、new_holdings、unstated。
holders[].filed日付常に提出した日。
holders[].issuer文字列常に発行体の名称。提出書類に印刷されたとおりです。
holders[].class文字列任意証券の種別名。例:COM。
holders[].value文字列常にポジションの価値(米ドル)。
holders[].shares文字列常に株数。shares_typeがPRNの場合は元本額です。
holders[].shares_typeone of SH, PRN任意株式はSH、元本額はPRN。
holders[].put_callone of Put, Call任意オプションのポジションではPutまたはCall。ほかのポジションでは省略されます。
holders[].discretion文字列任意提出書類に記載された投資裁量:SOLE、DFND(共有、定義済み)、OTR(共有、その他)。
holders[].votingオブジェクト常に議決権(株数)。
holders[].voting.sole文字列常に単独の議決権がある株数。
holders[].voting.shared文字列常に共有の議決権がある株数。
holders[].voting.none文字列常に議決権がない株数。
holders[].period日付常にこのポジションの報告四半期末。
holders[].percent_of_portfolio文字列任意ポジションの価値が、提出書類のtable_value_totalに占める割合(パーセント)。
holders[].reported_price文字列任意valueとsharesから求めた1株あたりの価格。上の制限を参照してください。
holders[].other_managerslist of string常にそのポジションを共有する、含まれる他の運用者の番号。
holders[].percent_of_outstanding文字列任意ポジションが企業の発行済み株式に占める割合(パーセント)。通常の株式ポジションのみ。
holders[].outstanding_as_of日付任意percent_of_outstandingの元になった株数の日付。
holders[].confidential_omitted常に true任意提出者が、SECに秘密扱いを求めたポジションを除いた場合はtrue。
next_cursor文字列常にcursorとして渡すと次のページを読み取れます。常に返され、最後のページではnullです。
リクエスト
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/companies/usa:0000320193/institutions?period=2026-09-30&limit=2"
レスポンスの例
{
  "id": "usa:0000320193",
  "period": "2026-09-30",
  "periods": [
    "2026-09-30",
    "2026-06-30",
    "2026-03-31",
    "2025-12-31"
  ],
  "built_at": "2026-11-16T03:09:01Z",
  "holders": [
    {
      "investor_id": "usa:0002012383",
      "investor": "BlackRock, Inc.",
      "filing_id": "usa:0002012383:0002012383-26-003985",
      "form": "13F-HR",
      "report": "combination",
      "filed": "2026-11-13",
      "issuer": "APPLE INC",
      "class": "COM",
      "value": "385329896040",
      "shares": "1157077341",
      "shares_type": "SH",
      "discretion": "SOLE",
      "voting": {
        "sole": "1037578760",
        "shared": "0",
        "none": "119498580"
      },
      "period": "2026-09-30",
      "percent_of_portfolio": "5.6736",
      "reported_price": "333.02",
      "other_managers": [
        "2",
        "3",
        "4"
      ]
    },
    {
      "investor_id": "usa:0002100119",
      "investor": "VANGUARD CAPITAL MANAGEMENT LLC",
      "filing_id": "usa:0002100119:0002100119-26-001711",
      "form": "13F-HR",
      "filed": "2026-11-13",
      "issuer": "APPLE INC",
      "class": "COM",
      "value": "318109956628",
      "shares": "955227784",
      "shares_type": "SH",
      "discretion": "DFND",
      "voting": {
        "sole": "0",
        "shared": "0",
        "none": "955227784"
      },
      "period": "2026-09-30",
      "percent_of_portfolio": "6.6794",
      "reported_price": "333.02",
      "other_managers": []
    }
  ],
  "next_cursor": "eyJrIjoidUdkUmJZRS1vV0Mw…"
}

機関投資家の保有内容を一覧する

GET /v1/investors/{cik}/holdings

Form 13Fで1つの機関投資家が報告した内容を、金額の大きい順に。1つの四半期、または四半期の範囲です。cikは機関投資家自身のCIKです。

report_period_gte、report_period_gt、report_period_lte、report_period_ltで、1回の呼び出しで複数の四半期を読めます。最新の四半期が先で、四半期の中では金額の大きい順です。その場合periodは送られません。periodと範囲を同時に指定すると400 invalid_queryです。

MCP: ツール filings_list_investor_holdings。

パラメータ

パラメータ場所必須種別意味
cikパスはい文字列機関投資家のCIK。1桁から10桁。またはinvestor_id(usa:と1桁から10桁の数字)。先頭のゼロは省略できます。
periodクエリいいえ日付報告四半期末を1つ。省略すると最新の四半期です。範囲のパラメーターとは併用できません。
report_period_gteクエリいいえ日付この日以降に終わる四半期のみ(YYYY-MM-DD)。
report_period_gtクエリいいえ日付この日より後に終わる四半期のみ。
report_period_lteクエリいいえ日付この日以前に終わる四半期のみ。
report_period_ltクエリいいえ日付この日より前に終わる四半期のみ。
cursorクエリいいえ文字列前のページの next_cursor。ほかのパラメータは同じ値にします。
limitクエリいいえ整数1ページあたりの行数。デフォルトは100、最大500。

レスポンスフィールド

フィールド種別送信意味
id文字列常に機関投資家のID。usa:にCIKを10桁にゼロ埋めしたものです。
investor文字列任意機関投資家の名称。提出書類のとおりです。
period日付任意返された報告四半期末。holdingsルートで四半期の範囲を指定した場合は省略されます。
periodslist of date常に保有している報告四半期末。新しい順です。
built_at文字列任意応答の元になったファイルが作成された時刻(UTC)。
holdingsオブジェクトの配列常にポジション。金額の大きい順です。四半期の範囲では、最新の四半期が先です。
holdings[].company_id文字列任意当社の企業リストでの発行体のID。発行体が企業に対応づけられていない場合は省略されます。
holdings[].company文字列任意当社の企業リストでの発行体の名称。
holdings[].ticker文字列任意当社の企業リストでの発行体のティッカー。
holdings[].filing_id文字列常にこの行の元になった13F提出書類のID。
holdings[].form文字列常に提出書類のフォーム。例:13F-HR。
holdings[].reportalways "combination"任意提出書類が複合報告のときはcombinationです。ほかの運用者のポジションを含みます。
holdings[].amendmentone of restatement, new_holdings, unstated任意訂正が、訂正対象の提出書類に対して行うこと:restatement、new_holdings、unstated。
holdings[].filed日付常に提出した日。
holdings[].issuer文字列常に発行体の名称。提出書類に印刷されたとおりです。
holdings[].class文字列任意証券の種別名。例:COM。
holdings[].value文字列常にポジションの価値(米ドル)。
holdings[].shares文字列常に株数。shares_typeがPRNの場合は元本額です。
holdings[].shares_typeone of SH, PRN任意株式はSH、元本額はPRN。
holdings[].put_callone of Put, Call任意オプションのポジションではPutまたはCall。ほかのポジションでは省略されます。
holdings[].discretion文字列任意提出書類に記載された投資裁量:SOLE、DFND(共有、定義済み)、OTR(共有、その他)。
holdings[].votingオブジェクト常に議決権(株数)。
holdings[].voting.sole文字列常に単独の議決権がある株数。
holdings[].voting.shared文字列常に共有の議決権がある株数。
holdings[].voting.none文字列常に議決権がない株数。
holdings[].period日付常にこのポジションの報告四半期末。
holdings[].percent_of_portfolio文字列任意ポジションの価値が、提出書類のtable_value_totalに占める割合(パーセント)。
holdings[].reported_price文字列任意valueとsharesから求めた1株あたりの価格。上の制限を参照してください。
holdings[].other_managerslist of string常にそのポジションを共有する、含まれる他の運用者の番号。
holdings[].shares_change文字列任意機関投資家の前の四半期からのsharesの変化。売却した場合は負です。
holdings[].new_position常に true任意機関投資家が前の四半期にその銘柄を保有していなかった場合はtrue。
holdings[].confidential_omitted常に true任意提出者が、SECに秘密扱いを求めたポジションを除いた場合はtrue。
next_cursor文字列常にcursorとして渡すと次のページを読み取れます。常に返され、最後のページではnullです。
リクエスト
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/investors/1067983/holdings?limit=2"
レスポンスの例
{
  "id": "usa:0001067983",
  "investor": "Berkshire Hathaway Inc",
  "period": "2026-06-30",
  "periods": [
    "2026-06-30",
    "2026-03-31",
    "2025-12-31",
    "2025-09-30"
  ],
  "built_at": "2026-11-14T14:10:32Z",
  "holdings": [
    {
      "company_id": "usa:0000320193",
      "company": "Apple Inc.",
      "ticker": "AAPL",
      "filing_id": "usa:0001067983:0001193125-26-352200",
      "form": "13F-HR",
      "filed": "2026-08-14",
      "issuer": "APPLE INC",
      "class": "COM",
      "value": "65950296923",
      "shares": "227917808",
      "shares_type": "SH",
      "discretion": "DFND",
      "voting": {
        "sole": "227917808",
        "shared": "0",
        "none": "0"
      },
      "period": "2026-06-30",
      "percent_of_portfolio": "22.0383",
      "reported_price": "289.36",
      "other_managers": [
        "1",
        "2",
        "4"
      ],
      "shares_change": "0"
    },
    {
      "company_id": "usa:0000004962",
      "company": "AMERICAN EXPRESS CO",
      "ticker": "AXP",
      "filing_id": "usa:0001067983:0001193125-26-352200",
      "form": "13F-HR",
      "filed": "2026-08-14",
      "issuer": "AMERICAN EXPRESS CO",
      "class": "COM",
      "value": "51282319275",
      "shares": "151610700",
      "shares_type": "SH",
      "discretion": "DFND",
      "voting": {
        "sole": "151610700",
        "shared": "0",
        "none": "0"
      },
      "period": "2026-06-30",
      "percent_of_portfolio": "17.1367",
      "reported_price": "338.25",
      "other_managers": [
        "4",
        "11",
        "13"
      ],
      "shares_change": "0"
    }
  ],
  "next_cursor": "eyJrIjoiT3BDSFhISGJ0Y25T…"
}

名前で機関投資家を検索

GET /v1/investors

名前の一部から、Form 13Fを提出する機関投資家を探します。investor_idを返し、これはほかのルートのcikとしてそのまま使えます。

investor_id、またはその数字部分だけを、ほかのルートのcikとして渡します。

MCP: ツール filings_search_investors。

パラメータ

パラメータ場所必須種別意味
nameクエリはい文字列機関投資家の名前の一部。大文字小文字は不問、2文字から100文字。
cursorクエリいいえ文字列前のページの next_cursor。ほかのパラメータは同じ値にします。
limitクエリいいえ整数1ページあたりの行数。デフォルトは100、最大500。

レスポンスフィールド

フィールド種別送信意味
investorsオブジェクトの配列常に名前にそのテキストが含まれる機関投資家。
investors[].investor_id文字列常に機関投資家のID。usa:にCIKを10桁にゼロ埋めしたものです。
investors[].name文字列常に機関投資家の名称。提出書類のとおりです。
investors[].latest_period日付常に機関投資家の最新の提出書類の報告四半期末。
next_cursor文字列常にcursorとして渡すと次のページを読み取れます。常に返され、最後のページではnullです。
リクエスト
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/investors?name=berkshire&limit=2"
レスポンスの例
{
  "investors": [
    {
      "investor_id": "usa:0000949012",
      "name": "BERKSHIRE ASSET MANAGEMENT LLC/PA",
      "latest_period": "2026-09-30"
    },
    {
      "investor_id": "usa:0001133742",
      "name": "BERKSHIRE CAPITAL HOLDINGS INC",
      "latest_period": "2026-09-30"
    }
  ],
  "next_cursor": "eyJrIjoiajJwemRIcXJfZnNn…"
}

機関投資家の13F提出書類を一覧する

GET /v1/investors/{cik}/filings

機関投資家が行った各13F提出書類のカバーページを、報告四半期の新しい順に。フォーム、報告の種類、提出日、エントリー数、金額の合計、含まれる他の運用者です。

formで1つのフォームだけに絞り込み(例:13F-HR)、範囲のパラメーターで一部の四半期に絞り込みます。

MCP: ツール filings_list_investor_filings。

パラメータ

パラメータ場所必須種別意味
cikパスはい文字列機関投資家のCIK。1桁から10桁。またはinvestor_id(usa:と1桁から10桁の数字)。先頭のゼロは省略できます。
report_period_gteクエリいいえ日付この日以降に終わる四半期のみ(YYYY-MM-DD)。
report_period_gtクエリいいえ日付この日より後に終わる四半期のみ。
report_period_lteクエリいいえ日付この日以前に終わる四半期のみ。
report_period_ltクエリいいえ日付この日より前に終わる四半期のみ。
formクエリいいえ文字列このフォームの提出書類のみ:13F-HR、13F-HR/A、13F-NT、13F-NT/A、13F-CTR。
cursorクエリいいえ文字列前のページの next_cursor。ほかのパラメータは同じ値にします。
limitクエリいいえ整数1ページあたりの行数。デフォルトは100、最大500。

レスポンスフィールド

フィールド種別送信意味
id文字列常に機関投資家のID。usa:にCIKを10桁にゼロ埋めしたものです。
investor文字列任意機関投資家の名称。提出書類のとおりです。
filingsオブジェクトの配列常に13F提出書類。報告四半期の新しい順です。
filings[].filing_id文字列常にこの行の元になった13F提出書類のID。
filings[].form文字列常に提出書類のフォーム。例:13F-HR。
filings[].period日付常に提出書類が対象とする報告四半期末。
filings[].filed日付常に提出した日。
filings[].report_type文字列任意カバーページに印刷された報告の種類。例:13F HOLDINGS REPORT。
filings[].amendmentone of restatement, new_holdings, unstated任意訂正が、訂正対象の提出書類に対して行うこと:restatement、new_holdings、unstated。
filings[].amendment_no文字列任意カバーページに印刷された訂正番号。
filings[].file_number文字列任意カバーページに印刷されたSECファイル番号。
filings[].crd文字列任意カバーページに印刷されたCRD番号。
filings[].table_entry_total整数任意提出者が表で申告したエントリー数。
filings[].table_value_total文字列任意提出者が表で申告した合計金額(米ドル)。
filings[].other_included_managers_count整数任意提出者が申告した、含まれる他の運用者の数。
filings[].other_included_managersオブジェクトの配列常に提出書類がポジションを含める、ほかの運用者。
filings[].other_included_managers[].sequence整数常に運用者の番号。ポジションのother_managersがこれを参照します。
filings[].other_included_managers[].investor_id文字列任意運用者のID。独自に13Fを提出している場合。
filings[].other_included_managers[].name文字列任意運用者の名称。
filings[].other_included_managers[].file_number文字列任意運用者のSECファイル番号。
filings[].other_included_managers[].crd文字列任意運用者のCRD番号。
filings[].confidential_omitted常に true任意提出者が、SECに秘密扱いを求めたポジションを除いた場合はtrue。
filings[].notice常に true任意通知報告の場合はtrue。自らのポジションは一覧にありません。
next_cursor文字列常にcursorとして渡すと次のページを読み取れます。常に返され、最後のページではnullです。
リクエスト
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/investors/1067983/filings?limit=1"
レスポンスの例
{
  "id": "usa:0001067983",
  "investor": "Berkshire Hathaway Inc",
  "filings": [
    {
      "filing_id": "usa:0001067983:0001193125-26-352200",
      "form": "13F-HR",
      "period": "2026-06-30",
      "filed": "2026-08-14",
      "report_type": "13F HOLDINGS REPORT",
      "file_number": "028-04545",
      "table_entry_total": 89,
      "table_value_total": "299253556246",
      "other_included_managers_count": 14,
      "other_included_managers": [
        {
          "sequence": 1,
          "name": "Berkshire Hathaway Homestate Insurance Co.",
          "file_number": "28-2226"
        },
        {
          "sequence": 2,
          "name": "Berkshire Hathaway Life Insurance Co of Nebraska",
          "file_number": "28-5678"
        }
      ]
    }
  ],
  "next_cursor": "eyJrIjoiYzZtVkdUQVZ1TFJB…"
}

エラー

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

コードステータス意味
invalid_query400パラメータが欠けている、未知である、重複している、または範囲外です。
invalid_cursor400このカーソルは、このリクエストが返したものではないか、別のリクエストのものです。
company_not_found404そのIDに一致する企業はありません。
investor_not_found40413F提出者にCIKが一致するものはありません。
period_not_published404指定された四半期の13Fデータは保有していません。
not_covered404その市場、国、企業にはまだ対応していません。
insufficient_credits402クレジット残高が、リクエストの費用に足りません。
company_data_unavailable503この経路の元になる提出書類を、現在は読み取れません。しばらくしてからもう一度お試しください。

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