ファンド保有銘柄APIリファレンス
ETFやファンドの保有内容と、企業を保有するファンド。Form N-PORTから
概要
Form N-PORTは、米国の登録ファンド(ETFまたは投資信託)がSECに提出する、保有内容の報告書です。これらのルートでは、1つのファンドが保有するすべてと、企業を保有するファンドを、報告書1件ずつ確認できます。すべてのリクエストにBearerキーが必要で、RESTとMCPは1つのクレジット残高を共有します。
ルートは2つです。1つ目は、1つのファンドの保有銘柄を金額の大きい順に一覧にし、ファンドの合計と資産クラス別の構成を添えます。2つ目は、企業のポジションを報告したファンドを一覧にします。ファンドは、シリーズID(例:S000002839)、VOOやVFIAXのようなティッカー、またはARCX:VOOのような銘柄IDで指定します。企業は開示書類APIのID、たとえばusa:0000320193で指定します。
報告は四半期ごとです。四半期は暦の四半期末で、たとえば2026-06-30です。報告は、そのas_の日付を含む四半期に属します。省略すると最新の報告が返ります。金額は、value_またはcurrencyが別の通貨を示さない限り米ドルです。
各保有銘柄にはas_があり、これはファンドの報告書の日付です。開示書類のfiledの日付より数週間古いため、保有銘柄が今日のポートフォリオになることはありません。
対象は米国のみです。ほかの国の企業やファンドは404 not_です。
ベースURL: https:/。 以下の各ルートは、同じパラメータを持つ独立したMCPツールです。
企業を保有する機関投資家は次にあります: 機関投資家の保有者のページ。 ファンドの価格と履歴は次にあります: ファンドのページ。
企業IDは次が返すものです: 開示書類 API 企業検索から返されます。
すべてのアカウントで利用できるもの
| 課金額 | すべてのアカウント |
|---|---|
| ファンドの保有銘柄 | 含まれる |
| 企業を保有するファンド | 含まれる |
参照: 料金表 で、呼び出し1回の料金を確認できます。ルートに別の記載がない限り、リクエストはそのAPIの料金で課金されます。
- 料金はCompanies料金で、1回の呼び出しが$0.01(1,000回あたり$10)です。成功した応答は、行数を問わず1回の呼び出しです。エラーは無料で、企業を保有するファンドがない場合のようにデータのない応答も無料です。
asset_で保有銘柄が1件も残らなくても、ファンドのページは課金されます。どのファンドのページにも、ファンドの合計と構成が含まれるためです。class - マネー・マーケット・ファンドは対象外です。
- 識別子のない保有銘柄があります。保有銘柄に
lei、isin、company_がない場合があります。多くは債券(地方債、資産担保証券、ローン)とデリバティブです。これらの保有銘柄は、ファンドが報告した名称で、id issuerとtitleに入れて返されます。 periodsは、ファンドについて保有している四半期を一覧にします。- シリーズIDのないファンド(一部のトラストなど)は、登録者番号(10桁。例:
0000884394)で指定します。ティッカーではまだ見つかりません。 - 数値は小数文字列です。値のないフィールドは省略され、リストは常に存在し、
amendmentのようなフラグはtrueの場合だけ送られます。 - ページは
next_で終わることがあります。それを、ほかのパラメーターを同じにしてcursor cursorとして送り返します。別のリクエストのカーソルは400invalid_です。cursor periodがない場合、holdingsルートはファンドの最新の報告を返します。companyルートは各ファンドの最新の報告を返すため、行は異なる四半期のものになることがあり、各行のas_がどの時点かを示します。1つの四半期だけを読むにはof periodを送ります。fundとcompositionは、asset_やclass limitで何が残っても、どのページでも報告全体を表します。total_は報告全体の件数、holdings returnedはこのページの行数です。全体を返すには大きすぎる報告ではtruncatedが設定され、最大の保有銘柄だけが残ります。- companyルートが一覧にするのは株式のポジションのみです。
balanceとpercent_は、ファンドが報告したとおりです。of_ net_ assets balance_は、unit balanceが株数、元本額、金額のどれかを示します。- 応答例は実際の回答で、リストを短くし、カーソルを省いています。
エンドポイント
すべてのルートは GET で、キーを次のヘッダーで渡す必要があります: Authorization: Bearer ヘッダー。例はレスポンスの形を示すもので、ライブデータではありません。
ETFやファンドの保有内容を一覧する
GET /v1/funds/{fund_id}/holdings
1つのETFまたはファンドがForm N-PORTで報告したすべての保有銘柄を、金額の大きい順に、ファンドの合計と資産クラス別の構成とともに返します。fund_は、シリーズID、ティッカー、または銘柄IDです。報告は1回に1件です。
行は金額の大きい順です。すべての保有銘柄を読むには、next_でページを送ります。fund、composition、行の上の数値は、どのページでも同じです。
as_は、報告をその日付で選びます。その四半期のファンドの報告がその日付時点のものである場合にのみ返り、そうでなければ404 period_です。
MCP: ツール filings_。
パラメータ
| パラメータ | 場所 | 必須 | 種別 | 意味 |
|---|---|---|---|---|
fund_ | パス | はい | 文字列 | ファンド:S000002839のようなシリーズID、VOOやVFIAXのようなティッカー、ARCX:VOOのような銘柄ID、またはシリーズIDのないファンドでは登録者の10桁の番号。シリーズIDまたは登録者番号の前にusa:を付けてもかまいません。 |
period | クエリ | いいえ | 日付 | 暦の四半期末。例:2026-06-30。報告は、そのas_の日付を含む四半期に属します。省略すると、ファンドの最新の報告です。ファンドに報告がない四半期は404 period_です。 |
as_ | クエリ | いいえ | 日付 | 報告の保有銘柄の基準日。例:2026-06-30。periodがない場合は、四半期の選択にも使われます。その四半期のファンドの報告がその日付時点のものである場合にのみ返り、そうでなければ404 period_です。 |
asset_ | クエリ | いいえ | one of equity, debt, cash, derivative, other | 保有銘柄の1つのクラスだけを残します:equity、debt、cash、derivative、other。ファンドの合計と構成は、引き続き報告全体を表します。 |
cursor | クエリ | いいえ | 文字列 | 前のページの next_。ほかのパラメータは同じ値にします。 |
limit | クエリ | いいえ | 整数 | 1ページあたりの行数。デフォルトは100、最大500。 |
レスポンスフィールド
| フィールド | 種別 | 送信 | 意味 |
|---|---|---|---|
id | 文字列 | 常に | ファンドのID。usa:にシリーズIDを付けたもの、またはシリーズIDがない場合はusa:に登録者番号を付けたものです。 |
name | 文字列 | 任意 | ファンドの名称。提出されたとおりです。シリーズ名のないファンドは、登録者の名称になります。 |
registrant_ | 文字列 | 任意 | 登録者のID。usa:に10桁のCIKを付けたものです。1つの登録者が多くのファンドについて提出することがあります。 |
registrant | 文字列 | 任意 | 登録者の名称。ファンドについて提出するトラストまたは会社です。 |
tickers | list of string | 常に | ファンドの各シェアクラスのティッカー。まだティッカーのないファンドでは空です。 |
listings | list of string | 常に | ファンドのティッカーのうち、当社が持っている銘柄の銘柄ID。例:ARCX:VOO。ない場合は空です。 |
period | 日付 | 任意 | 返された報告の暦の四半期末。 |
as_ | 日付 | 任意 | ファンドの報告の基準日。 |
periods | list of date | 常に | ファンドに報告がある暦の四半期末。新しい順です。 |
net_ | 文字列 | 任意 | 報告日時点のファンドの純資産(currency建て)。 |
currency | 文字列 | 任意 | ファンドの数値の通貨。米ドルの場合は省略されます。 |
built_ | 文字列 | 任意 | 応答の元になったファイルが作成された時刻(UTC)。 |
total_ | 整数 | 任意 | asset_やlimitで何が残っても、報告全体が一覧にする保有銘柄の数。 |
truncated | ブール値 | 任意 | 報告が大きすぎて全体を返せず、最大の保有銘柄だけを保有している場合はtrue。total_とcompositionは、引き続き報告全体を数えます。 |
returned | 整数 | 常に | このページが返す保有銘柄の数。 |
fund | オブジェクト | 任意 | 返された報告のファンド全体の数値(currency建て)。 |
fund.total_ | 文字列 | 任意 | ファンドの総資産。 |
fund.total_ | 文字列 | 任意 | ファンドの総負債。 |
fund.net_ | 文字列 | 任意 | ファンドの純資産。 |
fund.borrowings_ | 文字列 | 任意 | 1年以内に期限が来る借入金。 |
fund.borrowings_ | 文字列 | 任意 | 1年を超えて期限が来る借入金。 |
fund.delayed_ | 文字列 | 任意 | 繰延受渡の条件で購入した投資の未払金。 |
fund.standby_ | 文字列 | 任意 | スタンドバイ・コミットメントの未払金。 |
fund.liquidation_ | 文字列 | 任意 | ファンドの優先株式の清算優先権。 |
fund.cash_ | 文字列 | 任意 | ファンドが保有銘柄の一覧の外で報告している現金。 |
fund.returns | オブジェクトの配列 | 常に | 報告が対象とする3か月の各月における、各シェアクラスのトータルリターン(パーセント)。 |
fund.returns[].class_ | 文字列 | 常に | シェアクラスのID。 |
fund.returns[].month_ | 文字列 | 任意 | 3か月のうち最初の月のトータルリターン(パーセント)。 |
fund.returns[].month_ | 文字列 | 任意 | 2か月目のトータルリターン(パーセント)。 |
fund.returns[].month_ | 文字列 | 任意 | 3か月目のトータルリターン(パーセント)。 |
fund.interest_ | オブジェクトの配列 | 常に | 報告するファンドの場合:金利が1ベーシスポイントと100ベーシスポイント動いたときのポートフォリオの価値の変化。通貨別です。 |
fund.interest_ | 文字列 | 常に | 数値の通貨。 |
fund.interest_ | オブジェクト | 任意 | 金利が1ベーシスポイント動いたときの価値の変化。期間は3か月と1、5、10、30年:three_、one_、five_、ten_、thirty_。 |
fund.interest_ | オブジェクト | 任意 | 金利が100ベーシスポイント動いたときの価値の変化。5つの期間は同じです。 |
fund.credit_ | オブジェクト | 任意 | 投資適格の保有銘柄のクレジットスプレッドリスク。ファンドが報告したとおりで、期間は3か月と1、5、10、30年です。 |
fund.credit_ | 文字列 | 任意 | 3か月の数値。 |
fund.credit_ | 文字列 | 任意 | 1年の数値。 |
fund.credit_ | 文字列 | 任意 | 5年の数値。 |
fund.credit_ | 文字列 | 任意 | 10年の数値。 |
fund.credit_ | 文字列 | 任意 | 30年の数値。 |
fund.credit_ | オブジェクト | 任意 | 投資適格未満の保有銘柄のクレジットスプレッドリスク。ファンドが報告したとおりで、期間は3か月と1、5、10、30年です。 |
fund.credit_ | 文字列 | 任意 | 3か月の数値。 |
fund.credit_ | 文字列 | 任意 | 1年の数値。 |
fund.credit_ | 文字列 | 任意 | 5年の数値。 |
fund.credit_ | 文字列 | 任意 | 10年の数値。 |
fund.credit_ | 文字列 | 任意 | 30年の数値。 |
fund.securities_ | オブジェクトの配列 | 常に | 報告が名前を挙げている、ファンドの証券の借り手と、それぞれに貸し出した価値。 |
fund.securities_ | 文字列 | 常に | 借り手の名称。 |
fund.securities_ | 文字列 | 任意 | 借り手の法人識別子(LEI)。 |
fund.securities_ | 文字列 | 任意 | この借り手に貸し出している証券の価値。 |
composition | オブジェクトの配列 | 常に | 報告全体を資産クラス別に示したもの:保有銘柄の数、その価値、純資産に対するパーセントの合計。asset_では絞り込まれません。 |
composition[].asset_ | one of equity, debt, cash, derivative, other | 常に | クラス:equity、debt、cash、derivative、other。 |
composition[].holdings | 整数 | 常に | 報告がこのクラスで一覧にする保有銘柄の数。 |
composition[].value | 文字列 | 任意 | このクラスの価値(currency建て)。 |
composition[].percent_ | 文字列 | 任意 | このクラスの保有銘柄の、純資産に対するパーセントの合計。 |
holdings | オブジェクトの配列 | 常に | 保有銘柄。金額の大きい順です。 |
holdings[].filing_ | 文字列 | 常に | この行の元になったN-PORT開示書類のID。 |
holdings[].form | 文字列 | 常に | 開示書類のフォーム。例:NPORT-P。 |
holdings[].amendment | 常に true | 任意 | 開示書類が以前の開示書類を訂正するものである場合はtrue。 |
holdings[].filed | 日付 | 常に | 提出した日。 |
holdings[].as_ | 日付 | 常に | ファンドの報告の日付。filedより数週間古くなります。 |
holdings[].issuer | 文字列 | 常に | 発行体の名称。ファンドが報告したとおりです。 |
holdings[].title | 文字列 | 任意 | 発行銘柄の名称。ファンドが報告したとおりです。 |
holdings[].lei | 文字列 | 任意 | 発行体の法人識別子(LEI)。ファンドが示さなかった場合は省略されます。 |
holdings[].isin | 文字列 | 任意 | ISIN。ファンドが示した場合のみ。米国とカナダの証券、および一部のその他の証券のISINは送られません。 |
holdings[].asset_ | one of equity, debt, cash, derivative, other | 常に | 保有銘柄のクラス:equity、debt、cash、derivative、other。 |
holdings[].asset_ | 文字列 | 常に | 保有銘柄に対するファンド独自の分類:equity_、equity_、debt、asset_、asset_、asset_、asset_、loan、structured_、short_、repurchase_、derivative_、derivative_、derivative_、derivative_、derivative_、derivative_、commodity、real_、other。 |
holdings[].issuer_ | 文字列 | 任意 | 発行者の種類:corporate、us_、us_、us_、municipal、non_、private_、registered_、other。 |
holdings[].restricted | ブール値 | 任意 | 保有銘柄が制限付き証券の場合はtrue。 |
holdings[].fair_ | one of 1, 2, 3 | 任意 | ファンドが保有銘柄に付けた公正価値レベル:1、2、3。 |
holdings[].derivative_ | 文字列 | 任意 | デリバティブの場合、ファンドが報告した種類。例:fut。 |
holdings[].debt | オブジェクト | 任意 | 債券の保有銘柄の条件。 |
holdings[].debt.maturity_ | 日付 | 任意 | 満期日。 |
holdings[].debt.coupon_ | one of fixed, floating, variable, none | 任意 | fixed、floating、variable、none。 |
holdings[].debt.coupon_ | 文字列 | 任意 | クーポンレート(パーセント)。 |
holdings[].debt.in_ | ブール値 | 任意 | 発行体がデフォルトしている場合はtrue。 |
holdings[].debt.interest_ | ブール値 | 任意 | 利息の支払いが延滞している場合はtrue。 |
holdings[].debt.paid_ | ブール値 | 任意 | 利息が現物で支払われる場合があるときはtrue。 |
holdings[].debt.mandatory_ | ブール値 | 任意 | 債券が強制転換証券の場合はtrue。 |
holdings[].debt.contingent_ | ブール値 | 任意 | 債券が偶発転換証券の場合はtrue。 |
holdings[].securities_ | オブジェクト | 任意 | 保有銘柄の貸出、または貸出に対する現金担保の保有について、ファンドが報告している内容。 |
holdings[].securities_ | ブール値 | 任意 | 保有銘柄が貸出中の場合はtrue。 |
holdings[].securities_ | 文字列 | 任意 | 貸出中の保有銘柄の価値。 |
holdings[].securities_ | ブール値 | 任意 | 保有銘柄が貸出の現金担保である場合はtrue。 |
holdings[].securities_ | 文字列 | 任意 | その現金担保の価値。 |
holdings[].securities_ | ブール値 | 任意 | 保有銘柄の一部が、貸出で受け取った現金以外の担保でもある場合はtrue。 |
holdings[].position | one of long, short | 任意 | longまたはshort。 |
holdings[].balance | 文字列 | 任意 | 保有している量:株数、元本額、または金額。balance_が示すとおりです。 |
holdings[].balance_ | one of shares, principal, currency | 任意 | shares、principal、currency。 |
holdings[].currency | 文字列 | 任意 | balanceが金額の場合の、その通貨。 |
holdings[].exchange_ | 文字列 | 任意 | 保有銘柄が米ドル建てでない場合に、ファンドが使った米ドルへの為替レート。 |
holdings[].value | 文字列 | 任意 | 保有銘柄の価値。value_が別の通貨を示さない限り米ドルです。開示書類に記載がない場合は省略されます。 |
holdings[].value_ | 文字列 | 任意 | valueの通貨。米ドルの場合は省略されます。 |
holdings[].percent_ | 文字列 | 任意 | 保有銘柄の価値が、ファンドの純資産に占める割合(パーセント)。ファンドが報告したとおりです。 |
holdings[].country | 文字列 | 任意 | 報告が保有銘柄に付けている2文字の国コード。 |
holdings[].company_ | 文字列 | 任意 | 当社の企業リストにおける発行体のID。保有銘柄が企業と対応づけられていない場合は省略されます。 |
holdings[].company | 文字列 | 任意 | 当社の企業リストでの発行体の名称。 |
holdings[].ticker | 文字列 | 任意 | 当社の企業リストでの発行体のティッカー。 |
next_ | 文字列 | 常に | cursorとして渡すと次のページを読み取れます。常に返され、最後のページではnullです。 |
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/funds/VOO/holdings?limit=2"{
"id": "usa:S000002839",
"name": "VANGUARD 500 INDEX FUND",
"registrant_id": "usa:0000036405",
"registrant": "VANGUARD INDEX FUNDS",
"tickers": [
"VFFSX",
"VFIAX",
"VFINX",
"VOO"
],
"listings": [
"ARCX:VOO"
],
"period": "2026-06-30",
"as_of": "2026-06-30",
"periods": [
"2026-06-30",
"2026-03-31",
"2025-12-31",
"2025-09-30"
],
"net_assets": "1671231561960.14",
"built_at": "2026-11-15T23:36:04Z",
"total_holdings": 520,
"returned": 2,
"fund": {
"total_assets": "1673632288919.41",
"total_liabilities": "2400726959.27",
"net_assets": "1671231561960.14",
"borrowings_within_year": "0",
"borrowings_after_year": "0",
"delayed_delivery_payables": "0",
"standby_commitment_payables": "0",
"liquidation_preference": "0",
"cash_not_in_holdings": "0",
"returns": [
{
"class_id": "C000007773",
"month_1": "10.48124793",
"month_2": "5.24963951",
"month_3": "-0.96247233"
},
{
"class_id": "C000007774",
"month_1": "10.49014889",
"month_2": "5.25936275",
"month_3": "-0.95490903"
}
],
"interest_rate_risk": [],
"securities_lending_borrowers": [
{
"name": "Nomura Securities International Inc.",
"lei": "OXTKY6Q8X53C9ILVV871",
"value": "35722130"
},
{
"name": "TD Securities (USA) LLC",
"lei": "SUVUFHICNZMP2WKHG940",
"value": "14321650"
}
]
},
"composition": [
{
"asset_class": "equity",
"holdings": 506,
"value": "1667040888389.89",
"percent_of_net_assets": "99.749246383931"
},
{
"asset_class": "cash",
"holdings": 2,
"value": "5833051440.22",
"percent_of_net_assets": "0.34902712305"
},
{
"asset_class": "derivative",
"holdings": 12,
"value": "-75145091.66",
"percent_of_net_assets": "-0.00449639014"
}
],
"holdings": [
{
"filing_id": "usa:0000036405:0000036405-26-000473",
"form": "NPORT-P",
"filed": "2026-08-28",
"as_of": "2026-06-30",
"issuer": "NVIDIA Corp",
"title": "NVIDIA CORP",
"lei": "549300S4KLFTLO7GSQ80",
"asset_class": "equity",
"asset_category": "equity_common",
"issuer_type": "corporate",
"restricted": false,
"fair_value_level": "1",
"securities_lending": {
"on_loan": false,
"cash_collateral": false,
"non_cash_collateral": false
},
"position": "long",
"balance": "627619094",
"balance_unit": "shares",
"value": "125580304518.46",
"percent_of_net_assets": "7.51423724736",
"country": "US",
"company_id": "usa:0001045810",
"company": "NVIDIA CORP",
"ticker": "NVDA"
},
{
"filing_id": "usa:0000036405:0000036405-26-000473",
"form": "NPORT-P",
"filed": "2026-08-28",
"as_of": "2026-06-30",
"issuer": "Apple Inc",
"title": "APPLE INC",
"lei": "HWUPKR0MPOU8FGXBT394",
"asset_class": "equity",
"asset_category": "equity_common",
"issuer_type": "corporate",
"restricted": false,
"fair_value_level": "1",
"securities_lending": {
"on_loan": false,
"cash_collateral": false,
"non_cash_collateral": false
},
"position": "long",
"balance": "380610709",
"balance_unit": "shares",
"value": "110133514756.24",
"percent_of_net_assets": "6.58996139512",
"country": "US",
"company_id": "usa:0000320193",
"company": "Apple Inc.",
"ticker": "AAPL"
}
],
"next_cursor": "eyJrIjoiMDk5OTk4ODk4NjY0…"
}企業を保有するファンドを一覧する
GET /v1/companies/{company_id}/funds
Form N-PORTで企業のポジションを報告したETFとファンドを、金額の大きい順に返します。各行は、1つのファンドの1つのポジションで、そのファンドの報告によるものです。
行は金額の大きい順です。各行は1つのファンドの1つのポジションで、ファンドのID、名称、ティッカー、純資産を含みます。すべてのファンドを読むには、next_でページを送ります。
MCP: ツール filings_。
パラメータ
| パラメータ | 場所 | 必須 | 種別 | 意味 |
|---|---|---|---|---|
company_ | パス | はい | 文字列 | 企業ID。例:usa:0000320193。usa:AAPLのようなティッカー別名も使えます。 |
period | クエリ | いいえ | 日付 | 暦の四半期末。例:2026-06-30。省略すると、各ファンドの最新の報告で、四半期は問いません。どのファンドも報告していない四半期は404 period_です。 |
cursor | クエリ | いいえ | 文字列 | 前のページの next_。ほかのパラメータは同じ値にします。 |
limit | クエリ | いいえ | 整数 | 1ページあたりの行数。デフォルトは100、最大500。 |
レスポンスフィールド
| フィールド | 種別 | 送信 | 意味 |
|---|---|---|---|
id | 文字列 | 常に | 企業ID。 |
period | 日付 | 任意 | 返された暦の四半期末。リクエストにperiodがない場合は、保有している最新の四半期です。 |
periods | list of date | 常に | ファンドの報告がある暦の四半期末。新しい順です。 |
built_ | 文字列 | 任意 | 応答の元になったファイルが作成された時刻(UTC)。 |
funds | オブジェクトの配列 | 常に | 企業を保有するファンド。金額の大きい順です。 |
funds[].filing_ | 文字列 | 常に | この行の元になったN-PORT開示書類のID。 |
funds[].form | 文字列 | 常に | 開示書類のフォーム。例:NPORT-P。 |
funds[].amendment | 常に true | 任意 | 開示書類が以前の開示書類を訂正するものである場合はtrue。 |
funds[].filed | 日付 | 常に | 提出した日。 |
funds[].as_ | 日付 | 常に | ファンドの報告の日付。filedより数週間古くなります。 |
funds[].issuer | 文字列 | 常に | 発行体の名称。ファンドが報告したとおりです。 |
funds[].title | 文字列 | 任意 | 発行銘柄の名称。ファンドが報告したとおりです。 |
funds[].lei | 文字列 | 任意 | 発行体の法人識別子(LEI)。ファンドが示さなかった場合は省略されます。 |
funds[].isin | 文字列 | 任意 | ISIN。ファンドが示した場合のみ。米国とカナダの証券、および一部のその他の証券のISINは送られません。 |
funds[].asset_ | one of equity, debt, cash, derivative, other | 常に | 保有銘柄のクラス:equity、debt、cash、derivative、other。 |
funds[].asset_ | 文字列 | 常に | 保有銘柄に対するファンド独自の分類:equity_、equity_、debt、asset_、asset_、asset_、asset_、loan、structured_、short_、repurchase_、derivative_、derivative_、derivative_、derivative_、derivative_、derivative_、commodity、real_、other。 |
funds[].issuer_ | 文字列 | 任意 | 発行者の種類:corporate、us_、us_、us_、municipal、non_、private_、registered_、other。 |
funds[].restricted | ブール値 | 任意 | 保有銘柄が制限付き証券の場合はtrue。 |
funds[].fair_ | one of 1, 2, 3 | 任意 | ファンドが保有銘柄に付けた公正価値レベル:1、2、3。 |
funds[].derivative_ | 文字列 | 任意 | デリバティブの場合、ファンドが報告した種類。例:fut。 |
funds[].debt | オブジェクト | 任意 | 債券の保有銘柄の条件。 |
funds[].debt.maturity_ | 日付 | 任意 | 満期日。 |
funds[].debt.coupon_ | one of fixed, floating, variable, none | 任意 | fixed、floating、variable、none。 |
funds[].debt.coupon_ | 文字列 | 任意 | クーポンレート(パーセント)。 |
funds[].debt.in_ | ブール値 | 任意 | 発行体がデフォルトしている場合はtrue。 |
funds[].debt.interest_ | ブール値 | 任意 | 利息の支払いが延滞している場合はtrue。 |
funds[].debt.paid_ | ブール値 | 任意 | 利息が現物で支払われる場合があるときはtrue。 |
funds[].debt.mandatory_ | ブール値 | 任意 | 債券が強制転換証券の場合はtrue。 |
funds[].debt.contingent_ | ブール値 | 任意 | 債券が偶発転換証券の場合はtrue。 |
funds[].securities_ | オブジェクト | 任意 | 保有銘柄の貸出、または貸出に対する現金担保の保有について、ファンドが報告している内容。 |
funds[].securities_ | ブール値 | 任意 | 保有銘柄が貸出中の場合はtrue。 |
funds[].securities_ | 文字列 | 任意 | 貸出中の保有銘柄の価値。 |
funds[].securities_ | ブール値 | 任意 | 保有銘柄が貸出の現金担保である場合はtrue。 |
funds[].securities_ | 文字列 | 任意 | その現金担保の価値。 |
funds[].securities_ | ブール値 | 任意 | 保有銘柄の一部が、貸出で受け取った現金以外の担保でもある場合はtrue。 |
funds[].position | one of long, short | 任意 | longまたはshort。 |
funds[].balance | 文字列 | 任意 | 保有している量:株数、元本額、または金額。balance_が示すとおりです。 |
funds[].balance_ | one of shares, principal, currency | 任意 | shares、principal、currency。 |
funds[].currency | 文字列 | 任意 | balanceが金額の場合の、その通貨。 |
funds[].exchange_ | 文字列 | 任意 | 保有銘柄が米ドル建てでない場合に、ファンドが使った米ドルへの為替レート。 |
funds[].value | 文字列 | 任意 | 保有銘柄の価値。value_が別の通貨を示さない限り米ドルです。開示書類に記載がない場合は省略されます。 |
funds[].value_ | 文字列 | 任意 | valueの通貨。米ドルの場合は省略されます。 |
funds[].percent_ | 文字列 | 任意 | 保有銘柄の価値が、ファンドの純資産に占める割合(パーセント)。ファンドが報告したとおりです。 |
funds[].country | 文字列 | 任意 | 報告が保有銘柄に付けている2文字の国コード。 |
funds[].fund_ | 文字列 | 常に | ファンドのID。usa:にシリーズIDを付けたもの、またはシリーズIDがない場合はusa:に登録者番号を付けたものです。 |
funds[].fund | 文字列 | 任意 | ファンドの名称。提出されたとおりです。シリーズ名のないファンドは、登録者の名称になります。 |
funds[].registrant | 文字列 | 任意 | 登録者の名称。ファンドについて提出するトラストまたは会社です。 |
funds[].tickers | list of string | 常に | ファンドの各シェアクラスのティッカー。まだティッカーのないファンドでは空です。 |
funds[].net_ | 文字列 | 任意 | 報告日時点のファンドの純資産。value_が別の通貨を示さない限り米ドルです。 |
next_ | 文字列 | 常に | cursorとして渡すと次のページを読み取れます。常に返され、最後のページではnullです。 |
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/companies/usa:0000320193/funds?period=2026-06-30&limit=2"{
"id": "usa:0000320193",
"period": "2026-06-30",
"periods": [
"2026-09-30",
"2026-06-30",
"2026-03-31",
"2025-12-31"
],
"built_at": "2026-11-16T17:49:09Z",
"funds": [
{
"filing_id": "usa:0000036405:0000036405-26-000480",
"form": "NPORT-P",
"filed": "2026-08-28",
"as_of": "2026-06-30",
"issuer": "Apple Inc",
"title": "APPLE INC",
"lei": "HWUPKR0MPOU8FGXBT394",
"asset_class": "equity",
"asset_category": "equity_common",
"issuer_type": "corporate",
"restricted": false,
"fair_value_level": "1",
"securities_lending": {
"on_loan": false,
"cash_collateral": false,
"non_cash_collateral": false
},
"position": "long",
"balance": "466272244",
"balance_unit": "shares",
"value": "134920536523.84",
"percent_of_net_assets": "5.871626660176",
"country": "US",
"fund_id": "usa:S000002848",
"fund": "VANGUARD TOTAL STOCK MARKET INDEX FUND",
"registrant": "VANGUARD INDEX FUNDS",
"tickers": [
"VITSX",
"VSMPX",
"VSTSX",
"VTI",
"VTSAX",
"VTSMX"
],
"net_assets": "2297839156547.89"
},
{
"filing_id": "usa:0000036405:0000036405-26-000473",
"form": "NPORT-P",
"filed": "2026-08-28",
"as_of": "2026-06-30",
"issuer": "Apple Inc",
"title": "APPLE INC",
"lei": "HWUPKR0MPOU8FGXBT394",
"asset_class": "equity",
"asset_category": "equity_common",
"issuer_type": "corporate",
"restricted": false,
"fair_value_level": "1",
"securities_lending": {
"on_loan": false,
"cash_collateral": false,
"non_cash_collateral": false
},
"position": "long",
"balance": "380610709",
"balance_unit": "shares",
"value": "110133514756.24",
"percent_of_net_assets": "6.58996139512",
"country": "US",
"fund_id": "usa:S000002839",
"fund": "VANGUARD 500 INDEX FUND",
"registrant": "VANGUARD INDEX FUNDS",
"tickers": [
"VFFSX",
"VFIAX",
"VFINX",
"VOO"
],
"net_assets": "1671231561960.14"
}
],
"next_cursor": "eyJrIjoiMDk5OTk4ODk4NjY0…"
}エラー
エラーは共通の problem 形式で返され、次のコードを含みます: request_。参照: APIエラーとクレジット で形式とクレジットヘッダーを確認できます。失敗したリクエストには課金されません。
| コード | ステータス | 意味 |
|---|---|---|
invalid_ | 400 | パラメータが欠けている、未知である、重複している、または範囲外です。 |
invalid_ | 400 | このカーソルは、このリクエストが返したものではないか、別のリクエストのものです。 |
fund_ | 404 | シリーズID、ティッカー、銘柄ID、登録者番号のいずれにも一致するファンドがありません。シリーズIDのないファンドは、まだティッカーでは見つかりません。 |
company_ | 404 | そのIDに一致する企業はありません。 |
period_ | 404 | 指定した四半期のファンドの保有銘柄データがないか、その四半期のファンドの報告が、指定したas_ofの日付時点のものではありません。 |
not_ | 404 | その市場、国、企業にはまだ対応していません。 |
insufficient_ | 402 | クレジット残高が、リクエストの費用に足りません。 |
company_ | 503 | この経路の元になる提出書類を、現在は読み取れません。しばらくしてからもう一度お試しください。 |
このページは役に立ちましたか?