基金持仓 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_。
基础 URL: 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_ | 路径参数 | 是 | 字符串 | 基金:系列 id,例如 S000002839;股票代码,例如 VOO 或 VFIAX;标的 id,例如 ARCX:VOO;或者对没有系列 id 的基金,用注册人的十位编号。系列 id 或注册人编号前可以加 usa:。 |
period | 查询参数 | 否 | 日期 | 日历季度的期末,例如 2026-06-30。报告归入包含其 as_ 日期的季度。省略则取基金的最新报告。基金没有报告的季度返回 404 period_。 |
as_ | 查询参数 | 否 | 日期 | 报告持仓所截至的日期,例如 2026-06-30。不带 period 时,它也用来选定季度。只有当基金该季度的报告截至该日时才会返回,否则返回 404 period_。 |
asset_ | 查询参数 | 否 | one of equity, debt, cash, derivative, other | 只保留一类持仓:equity、debt、cash、derivative 或 other。基金的合计和构成仍然描述整份报告。 |
cursor | 查询参数 | 否 | 字符串 | 上一页返回的 next_,其他参数保持不变。 |
limit | 查询参数 | 否 | 整数 | 每页行数。默认 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_ | 路径参数 | 是 | 字符串 | 公司 id,例如 usa:0000320193。也接受 usa:AAPL 这样的股票代码别名。 |
period | 查询参数 | 否 | 日期 | 日历季度的期末,例如 2026-06-30。省略则取每只基金的最新报告,不论属于哪个季度。没有任何基金报告的季度返回 404 period_。 |
cursor | 查询参数 | 否 | 字符串 | 上一页返回的 next_,其他参数保持不变。 |
limit | 查询参数 | 否 | 整数 | 每页行数。默认 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…"
}错误
错误使用通用的 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 | 该接口背后的申报文件目前无法读取。请稍后重试。 |
此页面对你有帮助吗?