مرجع 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_ الخاص به. وإذا حُذف قُدِّم أحدث تقرير. القيم بالدولار الأمريكي ما لم يذكر value_ أو currency عملة أخرى.
لكل حيازة قيمة as_، وهي تاريخ تقرير الصندوق. وهو أقدم بأسابيع من تاريخ filed للإفصاح، لذلك لا تكون الحيازة محفظة اليوم أبدًا.
الولايات المتحدة هي البلد الوحيد المغطى. والشركة أو الصندوق من بلد آخر يُرجع 404 not_.
عنوان URL الأساسي: https:/. كل مسار أدناه أداة MCP قائمة بذاتها، بالمعاملات نفسها.
المؤسسات التي تحتفظ بأسهم شركة في صفحة الحاملين المؤسسيين. أسعار الصناديق وتاريخها في صفحة الصناديق.
معرّفات الشركات هي التي واجهة الإفصاحات (Filings API) يُرجعها بحث الشركات.
ما يحصل عليه كل حساب
| ما | كل حساب |
|---|---|
| حيازات صندوق | مشمول |
| الصناديق التي تحتفظ بأسهم شركة | مشمول |
راجع التسعير لمعرفة تكلفة الاستدعاء. يُحاسَب الطلب بسعر واجهته ما لم يذكر المسار خلاف ذلك.
- يُحاسَب بسعر Companies، 0.01 دولار للاستدعاء الواحد (10 دولارات لكل 1,000). كل إجابة ناجحة استدعاء واحد، مهما كان عدد الصفوف. الأخطاء مجانية، وكذلك الإجابة التي لا بيانات فيها، مثل شركة لا يحتفظ بها أي صندوق. وتُحاسَب صفحة الصندوق حتى لو لم يُبقِ
asset_أي حيازة، لأن كل صفحة صندوق تحمل إجماليات الصندوق وتركيبه.class - صناديق أسواق النقد غير مغطاة.
- بعض الحيازات بلا معرّف. قد تفتقر الحيازة إلى
leiوisinوcompany_. وأغلبها ديون (سندات البلديات وأوراق مالية مدعومة بأصول وقروض) ومشتقات. تُقدَّم هذه الحيازات بالاسم الذي أبلغ عنه الصندوق، فيid issuerوtitle. - يسرد
periodsالأرباع المحفوظة للصندوق. - الصندوق الذي لا معرّف سلسلة له، مثل بعض الصناديق الاستئمانية، يُطلب برقم جهته المسجِّلة (عشرة أرقام، مثل
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_ هو معرّف سلسلة أو رمز تداول أو معرّف إدراج. تقرير واحد في كل مرة.
الصفوف الأكبر قيمة أولًا. تنقّل بين الصفحات بـ next_ لقراءة كل حيازة. وتكون fund وcomposition والأرقام التي فوق الصفوف نفسها في كل صفحة.
يختار as_ تقريرًا بتاريخه. ولا يُقدَّم إلا إذا كان تقرير الصندوق عن ذلك الربع بتاريخ ذلك اليوم، وإلا فيُرجع 404 period_.
MCP: الأداة filings_.
المعلمات
| معلمة | الموضع | مطلوب | النوع | المعنى |
|---|---|---|---|---|
fund_ | مسار | نعم | سلسلة نصية | الصندوق: معرّف سلسلة مثل S000002839، أو رمز تداول مثل VOO أو VFIAX، أو معرّف إدراج مثل ARCX:VOO، أو الرقم المكوّن من عشرة أرقام للجهة المسجِّلة إن لم يكن للصندوق معرّف سلسلة. ويجوز وضع 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 | سلسلة نصية | دائمًا | معرّف الصندوق: usa: ومعرّف سلسلته، أو usa: ورقم جهته المسجِّلة إن لم يكن له معرّف سلسلة. |
name | سلسلة نصية | اختياري | اسم الصندوق كما يقدّمه في إفصاحه. والصندوق الذي لا اسم سلسلة له يأخذ اسم الجهة المسجِّلة. |
registrant_ | سلسلة نصية | اختياري | معرّف الجهة المسجِّلة: usa: ورقم CIK المكوّن من عشرة أرقام. ويمكن للجهة المسجِّلة الواحدة أن تقدّم إفصاحات لصناديق كثيرة. |
registrant | سلسلة نصية | اختياري | اسم الجهة المسجِّلة، أي الصندوق الاستئماني أو الشركة التي تقدّم الإفصاحات عن الصندوق. |
tickers | list of string | دائمًا | رموز التداول لفئات أسهم الصندوق. فارغة للصندوق الذي لا رمز تداول له بعد. |
listings | list of string | دائمًا | معرّفات الإدراج لرموز تداول الصندوق التي هي إدراجات لدينا، مثل 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_ | سلسلة نصية | دائمًا | معرّف فئة الأسهم. |
fund.returns[].month_ | سلسلة نصية | اختياري | العائد الإجمالي للشهر الأول من الأشهر الثلاثة، بالنسبة المئوية. |
fund.returns[].month_ | سلسلة نصية | اختياري | العائد الإجمالي للشهر الثاني، بالنسبة المئوية. |
fund.returns[].month_ | سلسلة نصية | اختياري | العائد الإجمالي للشهر الثالث، بالنسبة المئوية. |
fund.interest_ | قائمة كائنات | دائمًا | للصندوق الذي يبلّغ عنه: التغير في قيمة المحفظة عند تحرك أسعار الفائدة بمقدار نقطة أساس واحدة و100 نقطة أساس، حسب العملة. |
fund.interest_ | سلسلة نصية | دائمًا | عملة الأرقام. |
fund.interest_ | كائن | اختياري | التغير في القيمة عند تحرك بمقدار نقطة أساس واحدة، عند 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_ | سلسلة نصية | اختياري | الرقم عند سنة واحدة. |
fund.credit_ | سلسلة نصية | اختياري | الرقم عند 5 سنوات. |
fund.credit_ | سلسلة نصية | اختياري | الرقم عند 10 سنوات. |
fund.credit_ | سلسلة نصية | اختياري | الرقم عند 30 سنة. |
fund.credit_ | كائن | اختياري | مخاطر فروق الائتمان للحيازات غير ذات الدرجة الاستثمارية، كما يبلّغ بها الصندوق، عند 3 أشهر و1 و5 و10 و30 سنة. |
fund.credit_ | سلسلة نصية | اختياري | الرقم عند 3 أشهر. |
fund.credit_ | سلسلة نصية | اختياري | الرقم عند سنة واحدة. |
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 الذي جاء منه الصف. |
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_ | سلسلة نصية | اختياري | معرّف الجهة المُصدِرة في قائمة الشركات لدينا. يُحذف عندما لا تُطابَق الحيازة بشركة. |
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
صناديق ETF والصناديق التي أبلغت عن مركز في شركة على Form N-PORT، الأكبر قيمة أولًا. كل صف هو مركز واحد لصندوق واحد، من تقرير ذلك الصندوق.
الصفوف الأكبر قيمة أولًا. كل صف هو مركز واحد لصندوق واحد، ويحمل معرّف الصندوق واسمه ورموز تداوله وصافي أصوله. تنقّل بين الصفحات بـ next_ لقراءة كل صندوق.
MCP: الأداة filings_.
المعلمات
| معلمة | الموضع | مطلوب | النوع | المعنى |
|---|---|---|---|---|
company_ | مسار | نعم | سلسلة نصية | معرّف الشركة، مثل usa:0000320193. يُقبل رمز تداول بديل مثل usa:AAPL. |
period | استعلام | لا | التاريخ | نهاية ربع تقويمي، مثل 2026-06-30. وإذا حُذف فأحدث تقرير لكل صندوق، أيًّا كان ربعه. والربع الذي لم يبلّغ عنه أي صندوق يُرجع 404 period_. |
cursor | استعلام | لا | سلسلة نصية | قيمة next_ من الصفحة السابقة، مع المعاملات الأخرى نفسها. |
limit | استعلام | لا | عدد صحيح | عدد الصفوف في الصفحة. الافتراضي 100 وبحد أقصى 500. |
حقول الاستجابة
| حقل | النوع | يُرسل | المعنى |
|---|---|---|---|
id | سلسلة نصية | دائمًا | معرّف الشركة. |
period | التاريخ | اختياري | نهاية الربع التقويمي الذي قُدِّم. وإذا لم يكن في الطلب period فأحدث ربع محفوظ. |
periods | list of date | دائمًا | نهايات الأرباع التقويمية التي فيها تقارير صناديق، من الأحدث. |
built_ | سلسلة نصية | اختياري | وقت بناء الملف الذي تقوم عليه الإجابة (UTC). |
funds | قائمة كائنات | دائمًا | الصناديق التي تحتفظ بأسهم الشركة، الأكبر قيمة أولًا. |
funds[].filing_ | سلسلة نصية | دائمًا | معرّف إفصاح N-PORT الذي جاء منه الصف. |
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_ | سلسلة نصية | دائمًا | معرّف الصندوق: usa: ومعرّف سلسلته، أو 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 | لا يوجد صندوق يطابق معرّف السلسلة أو رمز التداول أو معرّف الإدراج أو رقم الجهة المسجِّلة. والصندوق الذي لا معرّف سلسلة له لا يُعثر عليه برمز التداول بعد. |
company_ | 404 | لا شركة تطابق المعرّف. |
period_ | 404 | لا توجد بيانات حيازات صناديق للربع المطلوب، أو أن تقرير الصندوق عن ذلك الربع ليس بتاريخ as_of المطلوب. |
not_ | 404 | السوق أو البلد أو الشركة غير مغطى بعد. |
insufficient_ | 402 | رصيدك أقل من تكلفة الطلب. |
company_ | 503 | تعذّرت قراءة الإفصاحات وراء هذا المسار الآن. حاول مرة أخرى بعد قليل. |
هل كانت هذه الصفحة مفيدة؟