مرجع API للحاملين المؤسسيين
المؤسسات التي تحتفظ بأسهم شركة وما تحتفظ به كل مؤسسة، من Form 13F
نظرة عامة
نموذج Form 13F هو التقرير الربع سنوي عن مراكز الأسهم والخيارات الأمريكية التي يحتفظ بها مديرو الاستثمار المؤسسيون الذين يديرون 100 مليون دولار على الأقل. وتبيّن هذه المسارات المؤسسات التي تحتفظ بأسهم شركة وما تحتفظ به مؤسسة واحدة، ربع تقرير واحد في كل مرة. يحتاج كل طلب إلى مفتاح Bearer، ويستخدم REST وMCP رصيدًا واحدًا.
أربعة مسارات. الأول يسرد المؤسسات التي تحتفظ بأسهم شركة. والثاني يسرد ما تحتفظ به مؤسسة واحدة. والثالث يجد مؤسسة بالاسم. والرابع يسرد إفصاحات 13F لمؤسسة واحدة، مع الأرقام الموجودة في صفحة غلاف كل منها. تُحدَّد الشركة بمعرّفها في Filings API، مثل usa:0000320193. وتُحدَّد المؤسسة برقم CIK الخاص بها، ومعرّفها investor_ هو usa: ورقم CIK مكمَّلًا بأصفار إلى عشرة أرقام.
الربع هو نهاية ربع التقرير، مثل 2026-06-30. وإذا حُذف قُدِّم أحدث ربع. كل صف مركز واحد، ويذكر الربع والإفصاح الذي جاء منه. القيم بالدولار الأمريكي، أيًّا كانت الوحدة التي استخدمها الإفصاح.
يبدأ السجل التاريخي بربع التقرير المنتهي في 30 سبتمبر 2021. ويسرد periods الأرباع المحفوظة. والربع المذكور قبل ذلك لم يُقرأ إلا جزئيًا، لذلك يكون عدد حامليه جزئيًا وليس قائمة كاملة بالحاملين.
الولايات المتحدة هي البلد الوحيد المغطى. والشركة من بلد آخر تُرجع 404 not_.
عنوان URL الأساسي: https:/. كل مسار أدناه أداة MCP قائمة بذاتها، بالمعاملات نفسها.
الحاملون لأكثر من 5% في صفحة كبار الحاملين، والمطلعون في صفحة تداولات المطلعين.
معرّفات الشركات هي التي واجهة الإفصاحات (Filings API) يُرجعها بحث الشركات.
ما يحصل عليه كل حساب
| ما | كل حساب |
|---|---|
| مؤسسات الشركة | مشمول |
| حيازات المؤسسة | مشمول |
| البحث بالاسم وقائمة الإفصاحات | مشمول |
راجع التسعير لمعرفة تكلفة الاستدعاء. يُحاسَب الطلب بسعر واجهته ما لم يذكر المسار خلاف ذلك.
- يُحاسَب بسعر Companies، 10 دولارات لكل 1,000 استدعاء. كل إجابة ناجحة استدعاء واحد، مهما كان عدد الصفوف. الصفحة الفارغة والبحث الذي لا نتائج له مجانيان، وكذلك الأخطاء. والصفحة التي فيها صفوف و
next_تُحاسَب، والصفحة التالية إن كانت فارغة فمجانية.cursor - الأرقام سلاسل عشرية. يُحذف الحقل الذي لا قيمة له، وتكون القائمة موجودة دائمًا، ولا يُرسل علم مثل
new_إلا عندما يكون true.position - قد تنتهي الصفحة بـ
next_. أعد إرساله بوصفهcursor cursorمع المعاملات الأخرى نفسها. ومؤشر المتابعة من طلب آخر يُرجع 400invalid_.cursor - بدون
period، يقدّم مسار institutions أحدث ربع، ويسرد أيضًا المؤسسة التي يعود أحدث تقرير لها إلى ربع أقدم، مع ذكر ذلك الربع فيperiod. أرسلperiodلقراءة ربع واحد فقط. reported_هوprice valueمقسومًا علىshares، كما يذكرهما الإفصاح. يُرسل للإفصاحات المقدَّمة اعتبارًا من 3 يناير 2023، حين بدأت الإفصاحات تذكر القيم بالدولار، ويُحذف لمبالغ أصل الدين وللمركز الذي لا أسهم فيه. وكانت الإفصاحات الأقدم تذكر القيم بالآلاف، وترسلها Narwhal بالدولار.shares_هوtype SHللأسهم وPRNلمبلغ أصل الدين. ويُرسلput_لمركز الخيارات.call - يضم
other_أرقام المديرين الآخرين المشمولين الذين يشاركون في المركز. وأسماؤهم فيmanagers other_في مسار الإفصاحات.included_ managers - يقارن
shares_وchange new_بالربع السابق للمؤسسة، ويرسلهما مسار الحيازات.position table_هو ما أعلنه مقدّم الإفصاح في صفحة غلافه. وهو خاطئ في نحو إفصاحين من كل 100، فعُدّ الصفوف إن احتجت إلى الرقم الصحيح.entry_ total
نقاط النهاية
كل مسار هو طلب GET ويحتاج إلى مفتاحك في: Authorization: Bearer الترويسة. تعرض الأمثلة شكل الاستجابة، وليست بيانات مباشرة.
اعرض المؤسسات التي تحتفظ بأسهم شركة
GET /v1/companies/{company_id}/institutions
المؤسسات التي أبلغت عن مركز في شركة على Form 13F، الأكبر قيمة أولًا. كل صف هو مركز واحد لمؤسسة واحدة، لربع تقرير واحد.
الصفوف الأكبر قيمة أولًا. تنقّل بين الصفحات بـ next_ لقراءة كل مؤسسة.
MCP: الأداة filings_.
المعلمات
| معلمة | الموضع | مطلوب | النوع | المعنى |
|---|---|---|---|---|
company_ | مسار | نعم | سلسلة نصية | معرّف الشركة، مثل usa:0000320193. يُقبل رمز تداول بديل مثل usa:AAPL. |
period | استعلام | لا | التاريخ | نهاية ربع التقرير، مثل 2026-06-30. وإذا حُذف فأحدث ربع. والربع الذي لا نحتفظ ببيانات عنه يُرجع 404 period_. |
cursor | استعلام | لا | سلسلة نصية | قيمة next_ من الصفحة السابقة، مع المعاملات الأخرى نفسها. |
limit | استعلام | لا | عدد صحيح | عدد الصفوف في الصفحة. الافتراضي 100 وبحد أقصى 500. |
حقول الاستجابة
| حقل | النوع | يُرسل | المعنى |
|---|---|---|---|
id | سلسلة نصية | دائمًا | معرّف الشركة. |
period | التاريخ | اختياري | نهاية ربع التقرير الذي قُدِّم. تُحذف عندما يُطلب من مسار الحيازات نطاق من الأرباع. |
periods | list of date | دائمًا | نهايات أرباع التقرير المحفوظة، من الأحدث. |
built_ | سلسلة نصية | اختياري | وقت بناء الملف الذي تقوم عليه الإجابة (UTC). |
holders | قائمة كائنات | دائمًا | المؤسسات التي تحتفظ بأسهم الشركة، الأكبر قيمة أولًا. |
holders[].investor_ | سلسلة نصية | دائمًا | معرّف المؤسسة: usa: ورقم CIK مكمَّلًا بأصفار إلى عشرة أرقام. |
holders[].investor | سلسلة نصية | اختياري | اسم المؤسسة، كما تقدّمه في إفصاحها. |
holders[].filing_ | سلسلة نصية | دائمًا | معرّف إفصاح 13F الذي جاء منه الصف. |
holders[].form | سلسلة نصية | دائمًا | نموذج الإفصاح، مثل 13F-HR. |
holders[].report | always "combination" | اختياري | combination عندما يكون الإفصاح تقريرًا مجمّعًا: يتضمن مراكز مديرين آخرين. |
holders[].amendment | one of restatement, new_holdings, unstated | اختياري | ما يفعله التعديل بالإفصاح الذي يغيّره: restatement أو new_ أو unstated. |
holders[].filed | التاريخ | دائمًا | يوم تقديم الإفصاح. |
holders[].issuer | سلسلة نصية | دائمًا | اسم المُصدِر، كما يطبعه الإفصاح. |
holders[].class | سلسلة نصية | اختياري | عنوان فئة الورقة المالية، مثل COM. |
holders[].value | سلسلة نصية | دائمًا | قيمة المركز بالدولار الأمريكي. |
holders[].shares | سلسلة نصية | دائمًا | الأسهم، أو مبلغ أصل الدين عندما يكون shares_ هو PRN. |
holders[].shares_ | one of SH, PRN | اختياري | SH للأسهم، وPRN لمبلغ أصل الدين. |
holders[].put_ | one of Put, Call | اختياري | Put أو Call في مركز الخيارات. وتُحذف في المراكز الأخرى. |
holders[].discretion | سلسلة نصية | اختياري | سلطة الاستثمار كما قُدِّمت: SOLE أو DFND (مشتركة، محددة) أو OTR (مشتركة، أخرى). |
holders[].voting | كائن | دائمًا | سلطة التصويت، بعدد الأسهم. |
holders[].voting.sole | سلسلة نصية | دائمًا | الأسهم ذات سلطة التصويت المنفردة. |
holders[].voting.shared | سلسلة نصية | دائمًا | الأسهم ذات سلطة التصويت المشتركة. |
holders[].voting.none | سلسلة نصية | دائمًا | الأسهم التي لا سلطة تصويت لها. |
holders[].period | التاريخ | دائمًا | نهاية ربع التقرير لهذا المركز. |
holders[].percent_ | سلسلة نصية | اختياري | قيمة المركز كنسبة مئوية من table_ الخاص بالإفصاح. |
holders[].reported_ | سلسلة نصية | اختياري | سعر السهم محسوبًا من value وshares. انظر الحدود أعلاه. |
holders[].other_ | list of string | دائمًا | أرقام المديرين الآخرين المشمولين الذين يشاركون في المركز. |
holders[].percent_ | سلسلة نصية | اختياري | المركز كنسبة مئوية من الأسهم القائمة للشركة. مراكز الأسهم العادية فقط. |
holders[].outstanding_ | التاريخ | اختياري | تاريخ عدد الأسهم الذي تقوم عليه percent_. |
holders[].confidential_ | دائمًا true | اختياري | تكون true عندما حذف مقدّم الإفصاح مراكز طلب من SEC معاملتها بسرية. |
next_ | سلسلة نصية | دائمًا | مرّره بوصفه cursor لقراءة الصفحة التالية. يُرسل دائمًا؛ وقيمته null في الصفحة الأخيرة. |
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/companies/usa:0000320193/institutions?period=2026-09-30&limit=2"{
"id": "usa:0000320193",
"period": "2026-09-30",
"periods": [
"2026-09-30",
"2026-06-30",
"2026-03-31",
"2025-12-31"
],
"built_at": "2026-11-16T03:09:01Z",
"holders": [
{
"investor_id": "usa:0002012383",
"investor": "BlackRock, Inc.",
"filing_id": "usa:0002012383:0002012383-26-003985",
"form": "13F-HR",
"report": "combination",
"filed": "2026-11-13",
"issuer": "APPLE INC",
"class": "COM",
"value": "385329896040",
"shares": "1157077341",
"shares_type": "SH",
"discretion": "SOLE",
"voting": {
"sole": "1037578760",
"shared": "0",
"none": "119498580"
},
"period": "2026-09-30",
"percent_of_portfolio": "5.6736",
"reported_price": "333.02",
"other_managers": [
"2",
"3",
"4"
]
},
{
"investor_id": "usa:0002100119",
"investor": "VANGUARD CAPITAL MANAGEMENT LLC",
"filing_id": "usa:0002100119:0002100119-26-001711",
"form": "13F-HR",
"filed": "2026-11-13",
"issuer": "APPLE INC",
"class": "COM",
"value": "318109956628",
"shares": "955227784",
"shares_type": "SH",
"discretion": "DFND",
"voting": {
"sole": "0",
"shared": "0",
"none": "955227784"
},
"period": "2026-09-30",
"percent_of_portfolio": "6.6794",
"reported_price": "333.02",
"other_managers": []
}
],
"next_cursor": "eyJrIjoidUdkUmJZRS1vV0Mw…"
}اعرض ما تحتفظ به مؤسسة
GET /v1/investors/{cik}/holdings
ما أبلغت عنه مؤسسة واحدة على Form 13F، الأكبر قيمة أولًا، لربع واحد أو لنطاق من الأرباع. cik هو رقم CIK الخاص بالمؤسسة.
تقرأ report_ وreport_ وreport_ وreport_ عدة أرباع في استدعاء واحد، من الأحدث، وداخل كل ربع الأكبر قيمة أولًا. ولا يُرسل period عندئذٍ. وطلب period مع نطاق معًا يُرجع 400 invalid_.
MCP: الأداة filings_.
المعلمات
| معلمة | الموضع | مطلوب | النوع | المعنى |
|---|---|---|---|---|
cik | مسار | نعم | سلسلة نصية | رقم CIK الخاص بالمؤسسة، من رقم إلى عشرة أرقام، أو investor_ الخاص بها (usa: ومن رقم إلى عشرة أرقام). الأصفار البادئة اختيارية. |
period | استعلام | لا | التاريخ | نهاية ربع تقرير واحد. وإذا حُذف فأحدث ربع. ولا يُستخدم مع معاملات النطاق. |
report_ | استعلام | لا | التاريخ | الأرباع المنتهية في هذا اليوم أو بعده فقط (YYYY-MM-DD). |
report_ | استعلام | لا | التاريخ | الأرباع المنتهية بعد هذا اليوم فقط. |
report_ | استعلام | لا | التاريخ | الأرباع المنتهية في هذا اليوم أو قبله فقط. |
report_ | استعلام | لا | التاريخ | الأرباع المنتهية قبل هذا اليوم فقط. |
cursor | استعلام | لا | سلسلة نصية | قيمة next_ من الصفحة السابقة، مع المعاملات الأخرى نفسها. |
limit | استعلام | لا | عدد صحيح | عدد الصفوف في الصفحة. الافتراضي 100 وبحد أقصى 500. |
حقول الاستجابة
| حقل | النوع | يُرسل | المعنى |
|---|---|---|---|
id | سلسلة نصية | دائمًا | معرّف المؤسسة: usa: ورقم CIK مكمَّلًا بأصفار إلى عشرة أرقام. |
investor | سلسلة نصية | اختياري | اسم المؤسسة، كما تقدّمه في إفصاحها. |
period | التاريخ | اختياري | نهاية ربع التقرير الذي قُدِّم. تُحذف عندما يُطلب من مسار الحيازات نطاق من الأرباع. |
periods | list of date | دائمًا | نهايات أرباع التقرير المحفوظة، من الأحدث. |
built_ | سلسلة نصية | اختياري | وقت بناء الملف الذي تقوم عليه الإجابة (UTC). |
holdings | قائمة كائنات | دائمًا | المراكز، الأكبر قيمة أولًا. ونطاق الأرباع يسرد أحدث ربع أولًا. |
holdings[].company_ | سلسلة نصية | اختياري | معرّف المُصدِر في قائمة شركاتنا. يُحذف عندما لا يُطابَق المُصدِر مع شركة. |
holdings[].company | سلسلة نصية | اختياري | اسم المُصدِر في قائمة شركاتنا. |
holdings[].ticker | سلسلة نصية | اختياري | رمز المُصدِر في قائمة شركاتنا. |
holdings[].filing_ | سلسلة نصية | دائمًا | معرّف إفصاح 13F الذي جاء منه الصف. |
holdings[].form | سلسلة نصية | دائمًا | نموذج الإفصاح، مثل 13F-HR. |
holdings[].report | always "combination" | اختياري | combination عندما يكون الإفصاح تقريرًا مجمّعًا: يتضمن مراكز مديرين آخرين. |
holdings[].amendment | one of restatement, new_holdings, unstated | اختياري | ما يفعله التعديل بالإفصاح الذي يغيّره: restatement أو new_ أو unstated. |
holdings[].filed | التاريخ | دائمًا | يوم تقديم الإفصاح. |
holdings[].issuer | سلسلة نصية | دائمًا | اسم المُصدِر، كما يطبعه الإفصاح. |
holdings[].class | سلسلة نصية | اختياري | عنوان فئة الورقة المالية، مثل COM. |
holdings[].value | سلسلة نصية | دائمًا | قيمة المركز بالدولار الأمريكي. |
holdings[].shares | سلسلة نصية | دائمًا | الأسهم، أو مبلغ أصل الدين عندما يكون shares_ هو PRN. |
holdings[].shares_ | one of SH, PRN | اختياري | SH للأسهم، وPRN لمبلغ أصل الدين. |
holdings[].put_ | one of Put, Call | اختياري | Put أو Call في مركز الخيارات. وتُحذف في المراكز الأخرى. |
holdings[].discretion | سلسلة نصية | اختياري | سلطة الاستثمار كما قُدِّمت: SOLE أو DFND (مشتركة، محددة) أو OTR (مشتركة، أخرى). |
holdings[].voting | كائن | دائمًا | سلطة التصويت، بعدد الأسهم. |
holdings[].voting.sole | سلسلة نصية | دائمًا | الأسهم ذات سلطة التصويت المنفردة. |
holdings[].voting.shared | سلسلة نصية | دائمًا | الأسهم ذات سلطة التصويت المشتركة. |
holdings[].voting.none | سلسلة نصية | دائمًا | الأسهم التي لا سلطة تصويت لها. |
holdings[].period | التاريخ | دائمًا | نهاية ربع التقرير لهذا المركز. |
holdings[].percent_ | سلسلة نصية | اختياري | قيمة المركز كنسبة مئوية من table_ الخاص بالإفصاح. |
holdings[].reported_ | سلسلة نصية | اختياري | سعر السهم محسوبًا من value وshares. انظر الحدود أعلاه. |
holdings[].other_ | list of string | دائمًا | أرقام المديرين الآخرين المشمولين الذين يشاركون في المركز. |
holdings[].shares_ | سلسلة نصية | اختياري | التغيّر في shares منذ الربع السابق للمؤسسة. يكون سالبًا عندما باعت. |
holdings[].new_ | دائمًا true | اختياري | تكون true عندما لم تكن المؤسسة تحتفظ بشيء منه في الربع السابق. |
holdings[].confidential_ | دائمًا true | اختياري | تكون true عندما حذف مقدّم الإفصاح مراكز طلب من SEC معاملتها بسرية. |
next_ | سلسلة نصية | دائمًا | مرّره بوصفه cursor لقراءة الصفحة التالية. يُرسل دائمًا؛ وقيمته null في الصفحة الأخيرة. |
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/investors/1067983/holdings?limit=2"{
"id": "usa:0001067983",
"investor": "Berkshire Hathaway Inc",
"period": "2026-06-30",
"periods": [
"2026-06-30",
"2026-03-31",
"2025-12-31",
"2025-09-30"
],
"built_at": "2026-11-14T14:10:32Z",
"holdings": [
{
"company_id": "usa:0000320193",
"company": "Apple Inc.",
"ticker": "AAPL",
"filing_id": "usa:0001067983:0001193125-26-352200",
"form": "13F-HR",
"filed": "2026-08-14",
"issuer": "APPLE INC",
"class": "COM",
"value": "65950296923",
"shares": "227917808",
"shares_type": "SH",
"discretion": "DFND",
"voting": {
"sole": "227917808",
"shared": "0",
"none": "0"
},
"period": "2026-06-30",
"percent_of_portfolio": "22.0383",
"reported_price": "289.36",
"other_managers": [
"1",
"2",
"4"
],
"shares_change": "0"
},
{
"company_id": "usa:0000004962",
"company": "AMERICAN EXPRESS CO",
"ticker": "AXP",
"filing_id": "usa:0001067983:0001193125-26-352200",
"form": "13F-HR",
"filed": "2026-08-14",
"issuer": "AMERICAN EXPRESS CO",
"class": "COM",
"value": "51282319275",
"shares": "151610700",
"shares_type": "SH",
"discretion": "DFND",
"voting": {
"sole": "151610700",
"shared": "0",
"none": "0"
},
"period": "2026-06-30",
"percent_of_portfolio": "17.1367",
"reported_price": "338.25",
"other_managers": [
"4",
"11",
"13"
],
"shares_change": "0"
}
],
"next_cursor": "eyJrIjoiT3BDSFhISGJ0Y25T…"
}ابحث عن المؤسسات بالاسم
GET /v1/investors
اعثر على مؤسسة تقدّم Form 13F بجزء من اسمها. يُرجع investor_ الذي يُقبل بوصفه cik في المسارات الأخرى.
مرّر investor_، أو أرقامه فقط، بوصفه cik في المسارات الأخرى.
MCP: الأداة filings_.
المعلمات
| معلمة | الموضع | مطلوب | النوع | المعنى |
|---|---|---|---|---|
name | استعلام | نعم | سلسلة نصية | جزء من اسم المؤسسة، بأي حالة أحرف، من 2 إلى 100 حرف. |
cursor | استعلام | لا | سلسلة نصية | قيمة next_ من الصفحة السابقة، مع المعاملات الأخرى نفسها. |
limit | استعلام | لا | عدد صحيح | عدد الصفوف في الصفحة. الافتراضي 100 وبحد أقصى 500. |
حقول الاستجابة
| حقل | النوع | يُرسل | المعنى |
|---|---|---|---|
investors | قائمة كائنات | دائمًا | المؤسسات التي يتضمن اسمها النص. |
investors[].investor_ | سلسلة نصية | دائمًا | معرّف المؤسسة: usa: ورقم CIK مكمَّلًا بأصفار إلى عشرة أرقام. |
investors[].name | سلسلة نصية | دائمًا | اسم المؤسسة، كما تقدّمه في إفصاحها. |
investors[].latest_ | التاريخ | دائمًا | نهاية ربع التقرير لأحدث إفصاح للمؤسسة. |
next_ | سلسلة نصية | دائمًا | مرّره بوصفه cursor لقراءة الصفحة التالية. يُرسل دائمًا؛ وقيمته null في الصفحة الأخيرة. |
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/investors?name=berkshire&limit=2"{
"investors": [
{
"investor_id": "usa:0000949012",
"name": "BERKSHIRE ASSET MANAGEMENT LLC/PA",
"latest_period": "2026-09-30"
},
{
"investor_id": "usa:0001133742",
"name": "BERKSHIRE CAPITAL HOLDINGS INC",
"latest_period": "2026-09-30"
}
],
"next_cursor": "eyJrIjoiajJwemRIcXJfZnNn…"
}اعرض إفصاحات 13F لمؤسسة
GET /v1/investors/{cik}/filings
صفحة غلاف كل إفصاح 13F قدّمته مؤسسة، من أحدث ربع تقرير: النموذج ونوع التقرير وتاريخ الإفصاح وعدد الإدخالات وإجمالي القيمة والمديرين الآخرين المشمولين.
استخدم form للإبقاء على نموذج واحد، مثل 13F-HR، ومعاملات النطاق للإبقاء على بعض الأرباع.
MCP: الأداة filings_.
المعلمات
| معلمة | الموضع | مطلوب | النوع | المعنى |
|---|---|---|---|---|
cik | مسار | نعم | سلسلة نصية | رقم CIK الخاص بالمؤسسة، من رقم إلى عشرة أرقام، أو investor_ الخاص بها (usa: ومن رقم إلى عشرة أرقام). الأصفار البادئة اختيارية. |
report_ | استعلام | لا | التاريخ | الأرباع المنتهية في هذا اليوم أو بعده فقط (YYYY-MM-DD). |
report_ | استعلام | لا | التاريخ | الأرباع المنتهية بعد هذا اليوم فقط. |
report_ | استعلام | لا | التاريخ | الأرباع المنتهية في هذا اليوم أو قبله فقط. |
report_ | استعلام | لا | التاريخ | الأرباع المنتهية قبل هذا اليوم فقط. |
form | استعلام | لا | سلسلة نصية | الإفصاحات على هذا النموذج فقط: 13F-HR أو 13F-HR/ أو 13F-NT أو 13F-NT/ أو 13F-CTR. |
cursor | استعلام | لا | سلسلة نصية | قيمة next_ من الصفحة السابقة، مع المعاملات الأخرى نفسها. |
limit | استعلام | لا | عدد صحيح | عدد الصفوف في الصفحة. الافتراضي 100 وبحد أقصى 500. |
حقول الاستجابة
| حقل | النوع | يُرسل | المعنى |
|---|---|---|---|
id | سلسلة نصية | دائمًا | معرّف المؤسسة: usa: ورقم CIK مكمَّلًا بأصفار إلى عشرة أرقام. |
investor | سلسلة نصية | اختياري | اسم المؤسسة، كما تقدّمه في إفصاحها. |
filings | قائمة كائنات | دائمًا | إفصاحات 13F، من أحدث ربع تقرير. |
filings[].filing_ | سلسلة نصية | دائمًا | معرّف إفصاح 13F الذي جاء منه الصف. |
filings[].form | سلسلة نصية | دائمًا | نموذج الإفصاح، مثل 13F-HR. |
filings[].period | التاريخ | دائمًا | نهاية ربع التقرير الذي يغطيه الإفصاح. |
filings[].filed | التاريخ | دائمًا | يوم تقديم الإفصاح. |
filings[].report_ | سلسلة نصية | اختياري | نوع التقرير المطبوع على صفحة الغلاف، مثل 13F HOLDINGS REPORT. |
filings[].amendment | one of restatement, new_holdings, unstated | اختياري | ما يفعله التعديل بالإفصاح الذي يغيّره: restatement أو new_ أو unstated. |
filings[].amendment_ | سلسلة نصية | اختياري | رقم التعديل المطبوع على صفحة الغلاف. |
filings[].file_ | سلسلة نصية | اختياري | رقم ملف SEC المطبوع على صفحة الغلاف. |
filings[].crd | سلسلة نصية | اختياري | رقم CRD المطبوع على صفحة الغلاف. |
filings[].table_ | عدد صحيح | اختياري | عدد الإدخالات التي أعلنها مقدّم الإفصاح في جدوله. |
filings[].table_ | سلسلة نصية | اختياري | إجمالي القيمة الذي أعلنه مقدّم الإفصاح لجدوله، بالدولار الأمريكي. |
filings[].other_ | عدد صحيح | اختياري | عدد المديرين الآخرين المشمولين الذين أعلنهم مقدّم الإفصاح. |
filings[].other_ | قائمة كائنات | دائمًا | المديرون الآخرون الذين يشمل الإفصاح مراكزهم. |
filings[].other_ | عدد صحيح | دائمًا | رقم المدير. يشير إليه other_ في المركز. |
filings[].other_ | سلسلة نصية | اختياري | معرّف المدير، عندما يقدّم 13F خاصًا به. |
filings[].other_ | سلسلة نصية | اختياري | اسم المدير. |
filings[].other_ | سلسلة نصية | اختياري | رقم ملف SEC الخاص بالمدير. |
filings[].other_ | سلسلة نصية | اختياري | رقم CRD الخاص بالمدير. |
filings[].confidential_ | دائمًا true | اختياري | تكون true عندما حذف مقدّم الإفصاح مراكز طلب من SEC معاملتها بسرية. |
filings[].notice | دائمًا true | اختياري | تكون true في تقرير إشعار، لا يسرد مراكز خاصة به. |
next_ | سلسلة نصية | دائمًا | مرّره بوصفه cursor لقراءة الصفحة التالية. يُرسل دائمًا؛ وقيمته null في الصفحة الأخيرة. |
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/investors/1067983/filings?limit=1"{
"id": "usa:0001067983",
"investor": "Berkshire Hathaway Inc",
"filings": [
{
"filing_id": "usa:0001067983:0001193125-26-352200",
"form": "13F-HR",
"period": "2026-06-30",
"filed": "2026-08-14",
"report_type": "13F HOLDINGS REPORT",
"file_number": "028-04545",
"table_entry_total": 89,
"table_value_total": "299253556246",
"other_included_managers_count": 14,
"other_included_managers": [
{
"sequence": 1,
"name": "Berkshire Hathaway Homestate Insurance Co.",
"file_number": "28-2226"
},
{
"sequence": 2,
"name": "Berkshire Hathaway Life Insurance Co of Nebraska",
"file_number": "28-5678"
}
]
}
],
"next_cursor": "eyJrIjoiYzZtVkdUQVZ1TFJB…"
}الأخطاء
تستخدم الأخطاء بنية المشكلة المشتركة مع: request_. راجع أخطاء API والرصيد لمعرفة الشكل وترويسات الرصيد. لا تُحاسَب الطلبات الفاشلة.
| الرمز | الحالة | المعنى |
|---|---|---|
invalid_ | 400 | معامل مفقود أو غير معروف أو مكرر أو خارج نطاقه. |
invalid_ | 400 | مؤشر الصفحة هذا لم يُعده هذا الطلب، أو أنه من طلب مختلف. |
company_ | 404 | لا شركة تطابق المعرّف. |
investor_ | 404 | لا يطابق أي مقدّم 13F رقم CIK هذا. |
period_ | 404 | لا نحتفظ ببيانات 13F للربع المطلوب. |
not_ | 404 | السوق أو البلد أو الشركة غير مغطى بعد. |
insufficient_ | 402 | رصيدك أقل من تكلفة الطلب. |
company_ | 503 | تعذّرت قراءة الإفصاحات وراء هذا المسار الآن. حاول مرة أخرى بعد قليل. |
هل كانت هذه الصفحة مفيدة؟