瀏覽全部文件

基金持倉 API 參考

ETF 或基金持有什麼,以及哪些基金持有某家公司,來自 Form N-PORT

概覽

Form N-PORT 是美國註冊基金(ETF 或共同基金)向 SEC 提交的持倉報告。這些路由顯示一檔基金持有的全部內容,以及哪些基金持有某家公司,一次一份報告。每個請求都需要 Bearer 金鑰,REST 與 MCP 共用同一份額度餘額。

共有兩個路由。第一個列出一檔基金的持倉,依價值由大到小排列,並附上基金的合計與依資產類別劃分的組成。第二個列出回報了某家公司持倉的基金。基金以其系列 ID 指定,例如 S000002839,也可以用 VOO 或 VFIAX 這樣的股票代號,或用 ARCX:VOO 這樣的標的 ID。公司以其 Filings API 的 ID 指定,例如 usa:0000320193。

報告按季度提交。季度是日曆季度的期末,例如 2026-06-30,報告歸入包含其 as_of 日期的季度。省略則取最新報告。金額以美元計,除非 value_currency 或 currency 另有說明。

每筆持倉都有一個 as_of,即基金報告的日期。它比申報文件的 filed 日期早幾週,所以持倉不會是今天的投資組合。

只涵蓋美國。其他國家的公司或基金會得到 404 not_covered。

基礎網址: https://api.narwhalapi.com。 下列每條路由都是各自獨立的 MCP 工具,參數相同。

持有某家公司的機構請見 機構持有人頁面。 基金的價格與歷史請見 基金頁面。

公司 ID 即為 申報文件 API 公司搜尋所回傳的 ID。

每個帳戶都能取得的內容

費用所有帳戶
基金的持倉已包含
持有某家公司的基金已包含

查看 定價 說明每次呼叫的費用。除非路由另有說明,請求依其所屬 API 的價格計費。

  • 依 Companies 價格計費,每次呼叫 $0.01(每 1,000 次 $10)。每次成功的回應計為一次呼叫,與資料列數無關。錯誤免費,沒有資料的回應也免費,例如沒有任何基金持有的公司。即使 asset_class 沒有留下任何持倉,基金頁面也會計費,因為每個基金頁面都帶有基金的合計與組成。
  • 不涵蓋貨幣市場基金。
  • 有些持倉沒有識別碼。持倉可能缺少 lei、isin 和 company_id。這多半是債務(市政債券、資產支持證券與貸款)和衍生性商品。這些持倉以基金所回報的名稱提供,放在 issuer 和 title 中。
  • periods 列出基金已保存的季度。
  • 沒有系列 ID 的基金,例如某些信託,要用其註冊人編號(十位數字,例如 0000884394)查詢。目前還不能用股票代號找到。
  • 數字為十進位字串。沒有值的欄位會省略,清單一律存在,amendment 這類旗標僅在為 true 時回傳。
  • 一頁可能以 next_cursor 結尾。把它作為 cursor 傳回,其他參數保持不變。來自另一個請求的游標會得到 400 invalid_cursor。
  • 未帶 period 時,holdings 路由回傳基金的最新報告。company 路由回傳每檔基金的最新報告,所以其資料列可能來自不同季度,每列的 as_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

回傳一檔 ETF 或基金在 Form N-PORT 上回報的每筆持倉,依價值由大到小排列,並附上基金的合計與依資產類別劃分的組成。fund_id 是系列 ID、股票代號或標的 ID。一次一份報告。

資料列依價值由大到小排列。用 next_cursor 翻頁即可讀取每筆持倉。fund、composition 和資料列之上的數字在每一頁都相同。

as_of 依日期選擇報告。只有當基金該季度的報告截至該日時才會回傳,否則會得到 404 period_not_published。

MCP:工具 filings_list_fund_holdings。

參數

參數位置必填類型含義
fund_idpath是字串基金:系列 ID,例如 S000002839;股票代號,例如 VOO 或 VFIAX;標的 ID,例如 ARCX:VOO;或者對沒有系列 ID 的基金,用註冊人的十位編號。系列 ID 或註冊人編號前可以加 usa:。
periodquery否日期日曆季度的期末,例如 2026-06-30。報告歸入包含其 as_of 日期的季度。省略則取基金的最新報告。基金沒有報告的季度會得到 404 period_not_published。
as_ofquery否日期報告持倉所截至的日期,例如 2026-06-30。未帶 period 時,它也用來選定季度。只有當基金該季度的報告截至該日時才會回傳,否則會得到 404 period_not_published。
asset_classquery否one of equity, debt, cash, derivative, other只保留一類持倉:equity、debt、cash、derivative 或 other。基金的合計與組成仍然描述整份報告。
cursorquery否字串上一頁的 next_cursor,其他參數須與上一頁相同。
limitquery否整數每頁資料列數。預設為 100,最多 500。

回應欄位

欄位類型傳送含義
id字串固定回傳基金的 ID:usa: 加上其系列 ID;沒有系列 ID 時,是 usa: 加上其註冊人編號。
name字串選填基金的名稱,與其申報時一致。沒有系列名稱的基金使用其註冊人的名稱。
registrant_id字串選填註冊人的 ID:usa: 加上其十位 CIK。一個註冊人可以為多檔基金申報。
registrant字串選填註冊人的名稱,即為該基金申報的信託或公司。
tickerslist of string固定回傳基金各份額類別的股票代號。尚無股票代號的基金為空。
listingslist of string固定回傳基金的股票代號裡,屬於我們已收錄標的的標的 ID,例如 ARCX:VOO。沒有則為空。
period日期選填所回傳報告的日曆季度期末。
as_of日期選填基金報告所截至的日期。
periodslist of date固定回傳基金有報告的日曆季度期末,由新到舊。
net_assets字串選填基金在報告日的淨資產,以 currency 計。
currency字串選填基金數字的幣別。美元則省略。
built_at字串選填回應所依據的檔案的建置時間(UTC)。
total_holdings整數選填整份報告列出的持倉數量,不論 asset_class 和 limit 留下什麼。
truncated布林值選填當報告過大而無法整份提供、只保存了其最大的持倉時為 true。total_holdings 和 composition 仍然統計整份報告。
returned整數固定回傳本頁回傳的持倉數量。
fund對象選填所回傳報告中基金層級的數字,以 currency 計。
fund.total_assets字串選填基金的總資產。
fund.total_liabilities字串選填基金的總負債。
fund.net_assets字串選填基金的淨資產。
fund.borrowings_within_year字串選填一年內到期的借款。
fund.borrowings_after_year字串選填一年後到期的借款。
fund.delayed_delivery_payables字串選填以延遲交割方式買入的投資的應付款。
fund.standby_commitment_payables字串選填備用承諾的應付款。
fund.liquidation_preference字串選填基金特別股的清算優先權。
fund.cash_not_in_holdings字串選填基金在持倉清單之外回報的現金。
fund.returns物件陣列固定回傳報告所涵蓋的三個月中,每個月每個份額類別的總報酬,以百分比計。
fund.returns[].class_id字串固定回傳份額類別的 ID。
fund.returns[].month_1字串選填三個月中第一個月的總報酬,以百分比計。
fund.returns[].month_2字串選填第二個月的總報酬,以百分比計。
fund.returns[].month_3字串選填第三個月的總報酬,以百分比計。
fund.interest_rate_risk物件陣列固定回傳對有回報此項的基金:利率變動 1 個基點和 100 個基點時,投資組合價值的變化,依幣別劃分。
fund.interest_rate_risk[].currency字串固定回傳數字的幣別。
fund.interest_rate_risk[].dv01對象選填利率變動 1 個基點時價值的變化,期限為 3 個月以及 1、5、10 和 30 年:three_month、one_year、five_year、ten_year 和 thirty_year。
fund.interest_rate_risk[].dv100對象選填利率變動 100 個基點時價值的變化,使用同樣的五個期限。
fund.credit_spread_risk_investment_grade對象選填投資等級持倉的信用利差風險,與基金回報的一致,期限為 3 個月以及 1、5、10 和 30 年。
fund.credit_spread_risk_investment_grade.three_month字串選填3 個月的數值。
fund.credit_spread_risk_investment_grade.one_year字串選填1 年的數值。
fund.credit_spread_risk_investment_grade.five_year字串選填5 年的數值。
fund.credit_spread_risk_investment_grade.ten_year字串選填10 年的數值。
fund.credit_spread_risk_investment_grade.thirty_year字串選填30 年的數值。
fund.credit_spread_risk_non_investment_grade對象選填非投資等級持倉的信用利差風險,與基金回報的一致,期限為 3 個月以及 1、5、10 和 30 年。
fund.credit_spread_risk_non_investment_grade.three_month字串選填3 個月的數值。
fund.credit_spread_risk_non_investment_grade.one_year字串選填1 年的數值。
fund.credit_spread_risk_non_investment_grade.five_year字串選填5 年的數值。
fund.credit_spread_risk_non_investment_grade.ten_year字串選填10 年的數值。
fund.credit_spread_risk_non_investment_grade.thirty_year字串選填30 年的數值。
fund.securities_lending_borrowers物件陣列固定回傳報告中點名的基金證券借入方,以及借給每一方的價值。
fund.securities_lending_borrowers[].name字串固定回傳借入方的名稱。
fund.securities_lending_borrowers[].lei字串選填借入方的法人實體識別碼(LEI)。
fund.securities_lending_borrowers[].value字串選填借給該借入方的證券價值。
composition物件陣列固定回傳整份報告依資產類別劃分:持倉數量、其價值,以及占淨資產百分比之和。它不受 asset_class 限制。
composition[].asset_classone of equity, debt, cash, derivative, other固定回傳類別:equity、debt、cash、derivative 或 other。
composition[].holdings整數固定回傳報告列出的該類別持倉數量。
composition[].value字串選填該類別的價值,以 currency 計。
composition[].percent_of_net_assets字串選填該類別持倉占淨資產百分比之和。
holdings物件陣列固定回傳持倉,依價值由大到小排列。
holdings[].filing_id字串固定回傳該列所來自的 N-PORT 申報文件的 ID。
holdings[].form字串固定回傳申報文件的表格,例如 NPORT-P。
holdings[].amendment一律為 true選填申報文件修訂更早的一份申報文件時為 true。
holdings[].filed日期固定回傳申報文件提交的日期。
holdings[].as_of日期固定回傳基金報告的日期。它比 filed 早幾週。
holdings[].issuer字串固定回傳發行人的名稱,與基金回報的一致。
holdings[].title字串選填所發行證券的名稱,與基金回報的一致。
holdings[].lei字串選填發行人的法人實體識別碼(LEI)。基金未提供時省略。
holdings[].isin字串選填ISIN,基金提供時才有。美國與加拿大證券以及部分其他證券的 ISIN 從不回傳。
holdings[].asset_classone of equity, debt, cash, derivative, other固定回傳持倉的類別:equity、debt、cash、derivative 或 other。
holdings[].asset_category字串固定回傳基金自己對該持倉的分類:equity_common、equity_preferred、debt、asset_backed_mortgage、asset_backed_other、asset_backed_collateralized_debt、asset_backed_commercial_paper、loan、structured_note、short_term_investment_vehicle、repurchase_agreement、derivative_commodity、derivative_credit、derivative_equity、derivative_foreign_exchange、derivative_interest_rate、derivative_other、commodity、real_estate 或 other。
holdings[].issuer_type字串選填由誰發行:corporate、us_treasury、us_government_agency、us_government_sponsored_entity、municipal、non_us_sovereign、private_fund、registered_fund 或 other。
holdings[].restricted布林值選填持倉為受限證券時為 true。
holdings[].fair_value_levelone of 1, 2, 3選填基金給該持倉的公允價值層級:1、2 或 3。
holdings[].derivative_type字串選填對衍生性商品,是基金回報的類型,例如 fut。
holdings[].debt對象選填債務持倉的條款。
holdings[].debt.maturity_date日期選填到期日。
holdings[].debt.coupon_kindone of fixed, floating, variable, none選填fixed、floating、variable 或 none。
holdings[].debt.coupon_rate字串選填票息率,以百分比計。
holdings[].debt.in_default布林值選填發行人違約時為 true。
holdings[].debt.interest_in_arrears布林值選填利息支付被拖欠時為 true。
holdings[].debt.paid_in_kind布林值選填利息可以以實物支付時為 true。
holdings[].debt.mandatory_convertible布林值選填該債務為強制可轉換債券時為 true。
holdings[].debt.contingent_convertible布林值選填該債務為或有可轉換債券時為 true。
holdings[].securities_lending對象選填基金回報的有關該持倉出借,或為一筆出借持有現金擔保品的情況。
holdings[].securities_lending.on_loan布林值選填持倉已借出時為 true。
holdings[].securities_lending.loan_value字串選填已借出持倉的價值。
holdings[].securities_lending.cash_collateral布林值選填持倉是一筆出借的現金擔保品時為 true。
holdings[].securities_lending.cash_collateral_value字串選填該現金擔保品的價值。
holdings[].securities_lending.non_cash_collateral布林值選填持倉的一部分同時也是出借時收到的非現金擔保品時為 true。
holdings[].positionone of long, short選填long 或 short。
holdings[].balance字串選填所持數量:股數、本金或一筆金額,由 balance_unit 說明。
holdings[].balance_unitone of shares, principal, currency選填shares、principal 或 currency。
holdings[].currency字串選填當 balance 是一筆金額時,它的幣別。
holdings[].exchange_rate字串選填持倉不是以美元計價時,基金所用的兌美元匯率。
holdings[].value字串選填持倉的價值,以美元計,除非 value_currency 另有說明。申報文件未提供時省略。
holdings[].value_currency字串選填value 的幣別。美元則省略。
holdings[].percent_of_net_assets字串選填持倉價值占基金淨資產的百分比,與基金回報的一致。
holdings[].country字串選填報告為該持倉給出的兩位國家代碼。
holdings[].company_id字串選填發行人在我們公司清單中的 ID。持倉未對應到公司時省略。
holdings[].company字串選填發行人在我們公司清單中的名稱。
holdings[].ticker字串選填發行人在我們公司清單中的股票代號。
next_cursor字串固定回傳作為 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 與基金,依價值由大到小排列。每一列是一檔基金的一個持倉,來自該基金的報告。

資料列依價值由大到小排列。每一列是一檔基金的一個持倉,並帶有基金的 ID、名稱、股票代號和淨資產。用 next_cursor 翻頁即可讀取每檔基金。

MCP:工具 filings_list_company_funds。

參數

參數位置必填類型含義
company_idpath是字串公司 ID,例如 usa:0000320193。也接受股票代號別名,例如 usa:AAPL。
periodquery否日期日曆季度的期末,例如 2026-06-30。省略則取每檔基金的最新報告,不論屬於哪個季度。沒有任何基金回報的季度會得到 404 period_not_published。
cursorquery否字串上一頁的 next_cursor,其他參數須與上一頁相同。
limitquery否整數每頁資料列數。預設為 100,最多 500。

回應欄位

欄位類型傳送含義
id字串固定回傳公司 ID。
period日期選填所回傳的日曆季度期末。請求中未帶 period 時,是已保存的最新季度。
periodslist of date固定回傳有基金報告的日曆季度期末,由新到舊。
built_at字串選填回應所依據的檔案的建置時間(UTC)。
funds物件陣列固定回傳持有該公司的基金,依價值由大到小排列。
funds[].filing_id字串固定回傳該列所來自的 N-PORT 申報文件的 ID。
funds[].form字串固定回傳申報文件的表格,例如 NPORT-P。
funds[].amendment一律為 true選填申報文件修訂更早的一份申報文件時為 true。
funds[].filed日期固定回傳申報文件提交的日期。
funds[].as_of日期固定回傳基金報告的日期。它比 filed 早幾週。
funds[].issuer字串固定回傳發行人的名稱,與基金回報的一致。
funds[].title字串選填所發行證券的名稱,與基金回報的一致。
funds[].lei字串選填發行人的法人實體識別碼(LEI)。基金未提供時省略。
funds[].isin字串選填ISIN,基金提供時才有。美國與加拿大證券以及部分其他證券的 ISIN 從不回傳。
funds[].asset_classone of equity, debt, cash, derivative, other固定回傳持倉的類別:equity、debt、cash、derivative 或 other。
funds[].asset_category字串固定回傳基金自己對該持倉的分類:equity_common、equity_preferred、debt、asset_backed_mortgage、asset_backed_other、asset_backed_collateralized_debt、asset_backed_commercial_paper、loan、structured_note、short_term_investment_vehicle、repurchase_agreement、derivative_commodity、derivative_credit、derivative_equity、derivative_foreign_exchange、derivative_interest_rate、derivative_other、commodity、real_estate 或 other。
funds[].issuer_type字串選填由誰發行:corporate、us_treasury、us_government_agency、us_government_sponsored_entity、municipal、non_us_sovereign、private_fund、registered_fund 或 other。
funds[].restricted布林值選填持倉為受限證券時為 true。
funds[].fair_value_levelone of 1, 2, 3選填基金給該持倉的公允價值層級:1、2 或 3。
funds[].derivative_type字串選填對衍生性商品,是基金回報的類型,例如 fut。
funds[].debt對象選填債務持倉的條款。
funds[].debt.maturity_date日期選填到期日。
funds[].debt.coupon_kindone of fixed, floating, variable, none選填fixed、floating、variable 或 none。
funds[].debt.coupon_rate字串選填票息率,以百分比計。
funds[].debt.in_default布林值選填發行人違約時為 true。
funds[].debt.interest_in_arrears布林值選填利息支付被拖欠時為 true。
funds[].debt.paid_in_kind布林值選填利息可以以實物支付時為 true。
funds[].debt.mandatory_convertible布林值選填該債務為強制可轉換債券時為 true。
funds[].debt.contingent_convertible布林值選填該債務為或有可轉換債券時為 true。
funds[].securities_lending對象選填基金回報的有關該持倉出借,或為一筆出借持有現金擔保品的情況。
funds[].securities_lending.on_loan布林值選填持倉已借出時為 true。
funds[].securities_lending.loan_value字串選填已借出持倉的價值。
funds[].securities_lending.cash_collateral布林值選填持倉是一筆出借的現金擔保品時為 true。
funds[].securities_lending.cash_collateral_value字串選填該現金擔保品的價值。
funds[].securities_lending.non_cash_collateral布林值選填持倉的一部分同時也是出借時收到的非現金擔保品時為 true。
funds[].positionone of long, short選填long 或 short。
funds[].balance字串選填所持數量:股數、本金或一筆金額,由 balance_unit 說明。
funds[].balance_unitone of shares, principal, currency選填shares、principal 或 currency。
funds[].currency字串選填當 balance 是一筆金額時,它的幣別。
funds[].exchange_rate字串選填持倉不是以美元計價時,基金所用的兌美元匯率。
funds[].value字串選填持倉的價值,以美元計,除非 value_currency 另有說明。申報文件未提供時省略。
funds[].value_currency字串選填value 的幣別。美元則省略。
funds[].percent_of_net_assets字串選填持倉價值占基金淨資產的百分比,與基金回報的一致。
funds[].country字串選填報告為該持倉給出的兩位國家代碼。
funds[].fund_id字串固定回傳基金的 ID:usa: 加上其系列 ID;沒有系列 ID 時,是 usa: 加上其註冊人編號。
funds[].fund字串選填基金的名稱,與其申報時一致。沒有系列名稱的基金使用其註冊人的名稱。
funds[].registrant字串選填註冊人的名稱,即為該基金申報的信託或公司。
funds[].tickerslist of string固定回傳基金各份額類別的股票代號。尚無股票代號的基金為空。
funds[].net_assets字串選填基金在報告日的淨資產,以美元計,除非 value_currency 另有說明。
next_cursor字串固定回傳作為 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…"
}

錯誤

錯誤使用共用的問題格式,並包含 request_id。查看 API 錯誤 處理:錯誤碼、額度與重試 了解格式與額度標頭。失敗的請求不計費。

代碼狀態含義
invalid_query400參數缺漏、未知、重複,或超出範圍。
invalid_cursor400此游標不是這個請求所回傳的,或來自不同的請求。
fund_not_found404沒有基金與該系列 ID、股票代號、標的 ID 或註冊人編號相符。沒有系列 ID 的基金目前還不能用股票代號找到。
company_not_found404沒有公司符合此 ID。
period_not_published404所問季度沒有基金持倉資料,或者基金該季度的報告並非截至所問的 as_of 日期。
not_covered404尚未支援此市場、國家或公司。
insufficient_credits402您的額度餘額不足以支付此請求的費用。
company_data_unavailable503這個路由背後的申報文件目前無法讀取。請稍後再試。

此頁面對你有幫助嗎?