基金持倉 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_ 日期的季度。省略則取最新報告。金額以美元計,除非 value_ 或 currency 另有說明。
每筆持倉都有一個 as_,即基金報告的日期。它比申報文件的 filed 日期早幾週,所以持倉不會是今天的投資組合。
只涵蓋美國。其他國家的公司或基金會得到 404 not_。
基礎網址: https:/。 下列每條路由都是各自獨立的 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傳回,其他參數保持不變。來自另一個請求的游標會得到 400invalid_。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。一次一份報告。
資料列依價值由大到小排列。用 next_ 翻頁即可讀取每筆持倉。fund、composition 和資料列之上的數字在每一頁都相同。
as_ 依日期選擇報告。只有當基金該季度的報告截至該日時才會回傳,否則會得到 404 period_。
MCP:工具 filings_。
參數
| 參數 | 位置 | 必填 | 類型 | 含義 |
|---|---|---|---|---|
fund_ | path | 是 | 字串 | 基金:系列 ID,例如 S000002839;股票代號,例如 VOO 或 VFIAX;標的 ID,例如 ARCX:VOO;或者對沒有系列 ID 的基金,用註冊人的十位編號。系列 ID 或註冊人編號前可以加 usa:。 |
period | query | 否 | 日期 | 日曆季度的期末,例如 2026-06-30。報告歸入包含其 as_ 日期的季度。省略則取基金的最新報告。基金沒有報告的季度會得到 404 period_。 |
as_ | query | 否 | 日期 | 報告持倉所截至的日期,例如 2026-06-30。未帶 period 時,它也用來選定季度。只有當基金該季度的報告截至該日時才會回傳,否則會得到 404 period_。 |
asset_ | query | 否 | one of equity, debt, cash, derivative, other | 只保留一類持倉:equity、debt、cash、derivative 或 other。基金的合計與組成仍然描述整份報告。 |
cursor | query | 否 | 字串 | 上一頁的 next_,其他參數須與上一頁相同。 |
limit | query | 否 | 整數 | 每頁資料列數。預設為 100,最多 500。 |
回應欄位
| 欄位 | 類型 | 傳送 | 含義 |
|---|---|---|---|
id | 字串 | 固定回傳 | 基金的 ID:usa: 加上其系列 ID;沒有系列 ID 時,是 usa: 加上其註冊人編號。 |
name | 字串 | 選填 | 基金的名稱,與其申報時一致。沒有系列名稱的基金使用其註冊人的名稱。 |
registrant_ | 字串 | 選填 | 註冊人的 ID:usa: 加上其十位 CIK。一個註冊人可以為多檔基金申報。 |
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_ | 字串 | 選填 | 一年內到期的借款。 |
fund.borrowings_ | 字串 | 選填 | 一年後到期的借款。 |
fund.delayed_ | 字串 | 選填 | 以延遲交割方式買入的投資的應付款。 |
fund.standby_ | 字串 | 選填 | 備用承諾的應付款。 |
fund.liquidation_ | 字串 | 選填 | 基金特別股的清算優先權。 |
fund.cash_ | 字串 | 選填 | 基金在持倉清單之外回報的現金。 |
fund.returns | 物件陣列 | 固定回傳 | 報告所涵蓋的三個月中,每個月每個份額類別的總報酬,以百分比計。 |
fund.returns[].class_ | 字串 | 固定回傳 | 份額類別的 ID。 |
fund.returns[].month_ | 字串 | 選填 | 三個月中第一個月的總報酬,以百分比計。 |
fund.returns[].month_ | 字串 | 選填 | 第二個月的總報酬,以百分比計。 |
fund.returns[].month_ | 字串 | 選填 | 第三個月的總報酬,以百分比計。 |
fund.interest_ | 物件陣列 | 固定回傳 | 對有回報此項的基金:利率變動 1 個基點和 100 個基點時,投資組合價值的變化,依幣別劃分。 |
fund.interest_ | 字串 | 固定回傳 | 數字的幣別。 |
fund.interest_ | 對象 | 選填 | 利率變動 1 個基點時價值的變化,期限為 3 個月以及 1、5、10 和 30 年:three_、one_、five_、ten_ 和 thirty_。 |
fund.interest_ | 對象 | 選填 | 利率變動 100 個基點時價值的變化,使用同樣的五個期限。 |
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 | 字串 | 選填 | 報告為該持倉給出的兩位國家代碼。 |
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 與基金,依價值由大到小排列。每一列是一檔基金的一個持倉,來自該基金的報告。
資料列依價值由大到小排列。每一列是一檔基金的一個持倉,並帶有基金的 ID、名稱、股票代號和淨資產。用 next_ 翻頁即可讀取每檔基金。
MCP:工具 filings_。
參數
| 參數 | 位置 | 必填 | 類型 | 含義 |
|---|---|---|---|---|
company_ | path | 是 | 字串 | 公司 ID,例如 usa:0000320193。也接受股票代號別名,例如 usa:AAPL。 |
period | query | 否 | 日期 | 日曆季度的期末,例如 2026-06-30。省略則取每檔基金的最新報告,不論屬於哪個季度。沒有任何基金回報的季度會得到 404 period_。 |
cursor | query | 否 | 字串 | 上一頁的 next_,其他參數須與上一頁相同。 |
limit | query | 否 | 整數 | 每頁資料列數。預設為 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 | 字串 | 選填 | 報告為該持倉給出的兩位國家代碼。 |
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…"
}錯誤
錯誤使用共用的問題格式,並包含 request_。查看 API 錯誤 處理:錯誤碼、額度與重試 了解格式與額度標頭。失敗的請求不計費。
| 代碼 | 狀態 | 含義 |
|---|---|---|
invalid_ | 400 | 參數缺漏、未知、重複,或超出範圍。 |
invalid_ | 400 | 此游標不是這個請求所回傳的,或來自不同的請求。 |
fund_ | 404 | 沒有基金與該系列 ID、股票代號、標的 ID 或註冊人編號相符。沒有系列 ID 的基金目前還不能用股票代號找到。 |
company_ | 404 | 沒有公司符合此 ID。 |
period_ | 404 | 所問季度沒有基金持倉資料,或者基金該季度的報告並非截至所問的 as_of 日期。 |
not_ | 404 | 尚未支援此市場、國家或公司。 |
insufficient_ | 402 | 您的額度餘額不足以支付此請求的費用。 |
company_ | 503 | 這個路由背後的申報文件目前無法讀取。請稍後再試。 |
此頁面對你有幫助嗎?