تصفّح التوثيق كاملًا

مرجع API لحيازات الصناديق

ما يحتفظ به صندوق ETF أو صندوق، والصناديق التي تحتفظ بأسهم شركة، من Form N-PORT

نظرة عامة

Form N-PORT هو التقرير الذي يقدّمه الصندوق الأمريكي المسجَّل، سواء كان ETF أو صندوقًا مشتركًا، إلى SEC عن حيازاته. تعرض هذه المسارات كل ما يحتفظ به صندوق واحد والصناديق التي تحتفظ بأسهم شركة، تقريرًا واحدًا في كل مرة. يحتاج كل طلب إلى مفتاح Bearer، ويستخدم REST وMCP رصيدًا واحدًا.

هناك مساران. الأول يسرد حيازات صندوق واحد، الأكبر قيمة أولًا، مع إجماليات الصندوق وتركيبه حسب فئة الأصول. والثاني يسرد الصناديق التي أبلغت عن مركز في شركة. يُحدَّد الصندوق بمعرّف سلسلته، مثل S000002839، أو برمز تداول مثل VOO أو VFIAX، أو بمعرّف إدراج مثل ARCX:VOO. وتُحدَّد الشركة بمعرّفها في Filings API، مثل usa:0000320193.

التقارير ربع سنوية. الربع هو نهاية ربع تقويمي، مثل 2026-06-30، ويقع التقرير في الربع الذي يضم تاريخ as_of الخاص به. وإذا حُذف قُدِّم أحدث تقرير. القيم بالدولار الأمريكي ما لم يذكر value_currency أو currency عملة أخرى.

لكل حيازة قيمة as_of، وهي تاريخ تقرير الصندوق. وهو أقدم بأسابيع من تاريخ filed للإفصاح، لذلك لا تكون الحيازة محفظة اليوم أبدًا.

الولايات المتحدة هي البلد الوحيد المغطى. والشركة أو الصندوق من بلد آخر يُرجع 404 not_covered.

عنوان URL الأساسي: https://api.narwhalapi.com. كل مسار أدناه أداة MCP قائمة بذاتها، بالمعاملات نفسها.

المؤسسات التي تحتفظ بأسهم شركة في صفحة الحاملين المؤسسيين. أسعار الصناديق وتاريخها في صفحة الصناديق.

معرّفات الشركات هي التي واجهة الإفصاحات (Filings API) يُرجعها بحث الشركات.

ما يحصل عليه كل حساب

ماكل حساب
حيازات صندوقمشمول
الصناديق التي تحتفظ بأسهم شركةمشمول

راجع التسعير لمعرفة تكلفة الاستدعاء. يُحاسَب الطلب بسعر واجهته ما لم يذكر المسار خلاف ذلك.

  • يُحاسَب بسعر Companies، 0.01 دولار للاستدعاء الواحد (10 دولارات لكل 1,000). كل إجابة ناجحة استدعاء واحد، مهما كان عدد الصفوف. الأخطاء مجانية، وكذلك الإجابة التي لا بيانات فيها، مثل شركة لا يحتفظ بها أي صندوق. وتُحاسَب صفحة الصندوق حتى لو لم يُبقِ asset_class أي حيازة، لأن كل صفحة صندوق تحمل إجماليات الصندوق وتركيبه.
  • صناديق أسواق النقد غير مغطاة.
  • بعض الحيازات بلا معرّف. قد تفتقر الحيازة إلى lei وisin وcompany_id. وأغلبها ديون (سندات البلديات وأوراق مالية مدعومة بأصول وقروض) ومشتقات. تُقدَّم هذه الحيازات بالاسم الذي أبلغ عنه الصندوق، في issuer وtitle.
  • يسرد periods الأرباع المحفوظة للصندوق.
  • الصندوق الذي لا معرّف سلسلة له، مثل بعض الصناديق الاستئمانية، يُطلب برقم جهته المسجِّلة (عشرة أرقام، مثل 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 هو معرّف سلسلة أو رمز تداول أو معرّف إدراج. تقرير واحد في كل مرة.

الصفوف الأكبر قيمة أولًا. تنقّل بين الصفحات بـ next_cursor لقراءة كل حيازة. وتكون fund وcomposition والأرقام التي فوق الصفوف نفسها في كل صفحة.

يختار as_of تقريرًا بتاريخه. ولا يُقدَّم إلا إذا كان تقرير الصندوق عن ذلك الربع بتاريخ ذلك اليوم، وإلا فيُرجع 404 period_not_published.

MCP: الأداة filings_list_fund_holdings.

المعلمات

معلمةالموضعمطلوبالنوعالمعنى
fund_idمسارنعمسلسلة نصيةالصندوق: معرّف سلسلة مثل S000002839، أو رمز تداول مثل VOO أو VFIAX، أو معرّف إدراج مثل ARCX:VOO، أو الرقم المكوّن من عشرة أرقام للجهة المسجِّلة إن لم يكن للصندوق معرّف سلسلة. ويجوز وضع usa: قبل معرّف السلسلة أو رقم الجهة المسجِّلة.
periodاستعلاملاالتاريخنهاية ربع تقويمي، مثل 2026-06-30. ويقع التقرير في الربع الذي يضم تاريخ as_of الخاص به. وإذا حُذف فأحدث تقرير للصندوق. والربع الذي لا تقرير للصندوق عنه يُرجع 404 period_not_published.
as_ofاستعلاملاالتاريخالتاريخ الذي تعود إليه حيازات التقرير، مثل 2026-06-30. وبدون period يختار أيضًا الربع. ولا يُقدَّم إلا إذا كان تقرير الصندوق عن ذلك الربع بتاريخ ذلك اليوم، وإلا فيُرجع 404 period_not_published.
asset_classاستعلاملاone of equity, debt, cash, derivative, otherأبقِ فئة واحدة من الحيازات: equity أو debt أو cash أو derivative أو other. وتظل إجماليات الصندوق وتركيبه تصف التقرير كله.
cursorاستعلاملاسلسلة نصيةقيمة next_cursor من الصفحة السابقة، مع المعاملات الأخرى نفسها.
limitاستعلاملاعدد صحيحعدد الصفوف في الصفحة. الافتراضي 100 وبحد أقصى 500.

حقول الاستجابة

حقلالنوعيُرسلالمعنى
idسلسلة نصيةدائمًامعرّف الصندوق: usa: ومعرّف سلسلته، أو usa: ورقم جهته المسجِّلة إن لم يكن له معرّف سلسلة.
nameسلسلة نصيةاختيارياسم الصندوق كما يقدّمه في إفصاحه. والصندوق الذي لا اسم سلسلة له يأخذ اسم الجهة المسجِّلة.
registrant_idسلسلة نصيةاختياريمعرّف الجهة المسجِّلة: usa: ورقم CIK المكوّن من عشرة أرقام. ويمكن للجهة المسجِّلة الواحدة أن تقدّم إفصاحات لصناديق كثيرة.
registrantسلسلة نصيةاختيارياسم الجهة المسجِّلة، أي الصندوق الاستئماني أو الشركة التي تقدّم الإفصاحات عن الصندوق.
tickerslist of stringدائمًارموز التداول لفئات أسهم الصندوق. فارغة للصندوق الذي لا رمز تداول له بعد.
listingslist of stringدائمًامعرّفات الإدراج لرموز تداول الصندوق التي هي إدراجات لدينا، مثل 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سلسلة نصيةدائمًامعرّف فئة الأسهم.
fund.returns[].month_1سلسلة نصيةاختياريالعائد الإجمالي للشهر الأول من الأشهر الثلاثة، بالنسبة المئوية.
fund.returns[].month_2سلسلة نصيةاختياريالعائد الإجمالي للشهر الثاني، بالنسبة المئوية.
fund.returns[].month_3سلسلة نصيةاختياريالعائد الإجمالي للشهر الثالث، بالنسبة المئوية.
fund.interest_rate_riskقائمة كائناتدائمًاللصندوق الذي يبلّغ عنه: التغير في قيمة المحفظة عند تحرك أسعار الفائدة بمقدار نقطة أساس واحدة و100 نقطة أساس، حسب العملة.
fund.interest_rate_risk[].currencyسلسلة نصيةدائمًاعملة الأرقام.
fund.interest_rate_risk[].dv01كائناختياريالتغير في القيمة عند تحرك بمقدار نقطة أساس واحدة، عند 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سلسلة نصيةاختياريالرقم عند سنة واحدة.
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سلسلة نصيةاختياريالرقم عند سنة واحدة.
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 الذي جاء منه الصف.
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سلسلة نصيةاختياريمعرّف الجهة المُصدِرة في قائمة الشركات لدينا. يُحذف عندما لا تُطابَق الحيازة بشركة.
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

صناديق ETF والصناديق التي أبلغت عن مركز في شركة على Form N-PORT، الأكبر قيمة أولًا. كل صف هو مركز واحد لصندوق واحد، من تقرير ذلك الصندوق.

الصفوف الأكبر قيمة أولًا. كل صف هو مركز واحد لصندوق واحد، ويحمل معرّف الصندوق واسمه ورموز تداوله وصافي أصوله. تنقّل بين الصفحات بـ next_cursor لقراءة كل صندوق.

MCP: الأداة filings_list_company_funds.

المعلمات

معلمةالموضعمطلوبالنوعالمعنى
company_idمسارنعمسلسلة نصيةمعرّف الشركة، مثل usa:0000320193. يُقبل رمز تداول بديل مثل usa:AAPL.
periodاستعلاملاالتاريخنهاية ربع تقويمي، مثل 2026-06-30. وإذا حُذف فأحدث تقرير لكل صندوق، أيًّا كان ربعه. والربع الذي لم يبلّغ عنه أي صندوق يُرجع 404 period_not_published.
cursorاستعلاملاسلسلة نصيةقيمة next_cursor من الصفحة السابقة، مع المعاملات الأخرى نفسها.
limitاستعلاملاعدد صحيحعدد الصفوف في الصفحة. الافتراضي 100 وبحد أقصى 500.

حقول الاستجابة

حقلالنوعيُرسلالمعنى
idسلسلة نصيةدائمًامعرّف الشركة.
periodالتاريخاختيارينهاية الربع التقويمي الذي قُدِّم. وإذا لم يكن في الطلب period فأحدث ربع محفوظ.
periodslist of dateدائمًانهايات الأرباع التقويمية التي فيها تقارير صناديق، من الأحدث.
built_atسلسلة نصيةاختياريوقت بناء الملف الذي تقوم عليه الإجابة (UTC).
fundsقائمة كائناتدائمًاالصناديق التي تحتفظ بأسهم الشركة، الأكبر قيمة أولًا.
funds[].filing_idسلسلة نصيةدائمًامعرّف إفصاح N-PORT الذي جاء منه الصف.
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سلسلة نصيةدائمًامعرّف الصندوق: usa: ومعرّف سلسلته، أو 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لا يوجد صندوق يطابق معرّف السلسلة أو رمز التداول أو معرّف الإدراج أو رقم الجهة المسجِّلة. والصندوق الذي لا معرّف سلسلة له لا يُعثر عليه برمز التداول بعد.
company_not_found404لا شركة تطابق المعرّف.
period_not_published404لا توجد بيانات حيازات صناديق للربع المطلوب، أو أن تقرير الصندوق عن ذلك الربع ليس بتاريخ as_of المطلوب.
not_covered404السوق أو البلد أو الشركة غير مغطى بعد.
insufficient_credits402رصيدك أقل من تكلفة الطلب.
company_data_unavailable503تعذّرت قراءة الإفصاحات وراء هذا المسار الآن. حاول مرة أخرى بعد قليل.

هل كانت هذه الصفحة مفيدة؟