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

مرجع API للحاملين المؤسسيين

المؤسسات التي تحتفظ بأسهم شركة وما تحتفظ به كل مؤسسة، من Form 13F

نظرة عامة

نموذج Form 13F هو التقرير الربع سنوي عن مراكز الأسهم والخيارات الأمريكية التي يحتفظ بها مديرو الاستثمار المؤسسيون الذين يديرون 100 مليون دولار على الأقل. وتبيّن هذه المسارات المؤسسات التي تحتفظ بأسهم شركة وما تحتفظ به مؤسسة واحدة، ربع تقرير واحد في كل مرة. يحتاج كل طلب إلى مفتاح Bearer، ويستخدم REST وMCP رصيدًا واحدًا.

أربعة مسارات. الأول يسرد المؤسسات التي تحتفظ بأسهم شركة. والثاني يسرد ما تحتفظ به مؤسسة واحدة. والثالث يجد مؤسسة بالاسم. والرابع يسرد إفصاحات 13F لمؤسسة واحدة، مع الأرقام الموجودة في صفحة غلاف كل منها. تُحدَّد الشركة بمعرّفها في Filings API، مثل usa:0000320193. وتُحدَّد المؤسسة برقم CIK الخاص بها، ومعرّفها investor_id هو usa: ورقم CIK مكمَّلًا بأصفار إلى عشرة أرقام.

الربع هو نهاية ربع التقرير، مثل 2026-06-30. وإذا حُذف قُدِّم أحدث ربع. كل صف مركز واحد، ويذكر الربع والإفصاح الذي جاء منه. القيم بالدولار الأمريكي، أيًّا كانت الوحدة التي استخدمها الإفصاح.

يبدأ السجل التاريخي بربع التقرير المنتهي في 30 سبتمبر 2021. ويسرد periods الأرباع المحفوظة. والربع المذكور قبل ذلك لم يُقرأ إلا جزئيًا، لذلك يكون عدد حامليه جزئيًا وليس قائمة كاملة بالحاملين.

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

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

الحاملون لأكثر من 5% في صفحة كبار الحاملين، والمطلعون في صفحة تداولات المطلعين.

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

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

ماكل حساب
مؤسسات الشركةمشمول
حيازات المؤسسةمشمول
البحث بالاسم وقائمة الإفصاحاتمشمول

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

  • يُحاسَب بسعر Companies، 10 دولارات لكل 1,000 استدعاء. كل إجابة ناجحة استدعاء واحد، مهما كان عدد الصفوف. الصفحة الفارغة والبحث الذي لا نتائج له مجانيان، وكذلك الأخطاء. والصفحة التي فيها صفوف وnext_cursor تُحاسَب، والصفحة التالية إن كانت فارغة فمجانية.
  • الأرقام سلاسل عشرية. يُحذف الحقل الذي لا قيمة له، وتكون القائمة موجودة دائمًا، ولا يُرسل علم مثل new_position إلا عندما يكون true.
  • قد تنتهي الصفحة بـ next_cursor. أعد إرساله بوصفه cursor مع المعاملات الأخرى نفسها. ومؤشر المتابعة من طلب آخر يُرجع 400 invalid_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_entry_total هو ما أعلنه مقدّم الإفصاح في صفحة غلافه. وهو خاطئ في نحو إفصاحين من كل 100، فعُدّ الصفوف إن احتجت إلى الرقم الصحيح.

نقاط النهاية

كل مسار هو طلب GET ويحتاج إلى مفتاحك في: Authorization: Bearer الترويسة. تعرض الأمثلة شكل الاستجابة، وليست بيانات مباشرة.

اعرض المؤسسات التي تحتفظ بأسهم شركة

GET /v1/companies/{company_id}/institutions

المؤسسات التي أبلغت عن مركز في شركة على Form 13F، الأكبر قيمة أولًا. كل صف هو مركز واحد لمؤسسة واحدة، لربع تقرير واحد.

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

MCP: الأداة filings_list_institutional_holders.

المعلمات

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

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

حقلالنوعيُرسلالمعنى
idسلسلة نصيةدائمًامعرّف الشركة.
periodالتاريخاختيارينهاية ربع التقرير الذي قُدِّم. تُحذف عندما يُطلب من مسار الحيازات نطاق من الأرباع.
periodslist of dateدائمًانهايات أرباع التقرير المحفوظة، من الأحدث.
built_atسلسلة نصيةاختياريوقت بناء الملف الذي تقوم عليه الإجابة (UTC).
holdersقائمة كائناتدائمًاالمؤسسات التي تحتفظ بأسهم الشركة، الأكبر قيمة أولًا.
holders[].investor_idسلسلة نصيةدائمًامعرّف المؤسسة: usa: ورقم CIK مكمَّلًا بأصفار إلى عشرة أرقام.
holders[].investorسلسلة نصيةاختيارياسم المؤسسة، كما تقدّمه في إفصاحها.
holders[].filing_idسلسلة نصيةدائمًامعرّف إفصاح 13F الذي جاء منه الصف.
holders[].formسلسلة نصيةدائمًانموذج الإفصاح، مثل 13F-HR.
holders[].reportalways "combination"اختياريcombination عندما يكون الإفصاح تقريرًا مجمّعًا: يتضمن مراكز مديرين آخرين.
holders[].amendmentone of restatement, new_holdings, unstatedاختياريما يفعله التعديل بالإفصاح الذي يغيّره: restatement أو new_holdings أو unstated.
holders[].filedالتاريخدائمًايوم تقديم الإفصاح.
holders[].issuerسلسلة نصيةدائمًااسم المُصدِر، كما يطبعه الإفصاح.
holders[].classسلسلة نصيةاختياريعنوان فئة الورقة المالية، مثل COM.
holders[].valueسلسلة نصيةدائمًاقيمة المركز بالدولار الأمريكي.
holders[].sharesسلسلة نصيةدائمًاالأسهم، أو مبلغ أصل الدين عندما يكون shares_type هو PRN.
holders[].shares_typeone of SH, PRNاختياريSH للأسهم، وPRN لمبلغ أصل الدين.
holders[].put_callone 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_of_portfolioسلسلة نصيةاختياريقيمة المركز كنسبة مئوية من table_value_total الخاص بالإفصاح.
holders[].reported_priceسلسلة نصيةاختياريسعر السهم محسوبًا من value وshares. انظر الحدود أعلاه.
holders[].other_managerslist of stringدائمًاأرقام المديرين الآخرين المشمولين الذين يشاركون في المركز.
holders[].percent_of_outstandingسلسلة نصيةاختياريالمركز كنسبة مئوية من الأسهم القائمة للشركة. مراكز الأسهم العادية فقط.
holders[].outstanding_as_ofالتاريخاختياريتاريخ عدد الأسهم الذي تقوم عليه percent_of_outstanding.
holders[].confidential_omittedدائمًا trueاختياريتكون true عندما حذف مقدّم الإفصاح مراكز طلب من SEC معاملتها بسرية.
next_cursorسلسلة نصيةدائمًامرّره بوصفه 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_period_gte وreport_period_gt وreport_period_lte وreport_period_lt عدة أرباع في استدعاء واحد، من الأحدث، وداخل كل ربع الأكبر قيمة أولًا. ولا يُرسل period عندئذٍ. وطلب period مع نطاق معًا يُرجع 400 invalid_query.

MCP: الأداة filings_list_investor_holdings.

المعلمات

معلمةالموضعمطلوبالنوعالمعنى
cikمسارنعمسلسلة نصيةرقم CIK الخاص بالمؤسسة، من رقم إلى عشرة أرقام، أو investor_id الخاص بها (usa: ومن رقم إلى عشرة أرقام). الأصفار البادئة اختيارية.
periodاستعلاملاالتاريخنهاية ربع تقرير واحد. وإذا حُذف فأحدث ربع. ولا يُستخدم مع معاملات النطاق.
report_period_gteاستعلاملاالتاريخالأرباع المنتهية في هذا اليوم أو بعده فقط (YYYY-MM-DD).
report_period_gtاستعلاملاالتاريخالأرباع المنتهية بعد هذا اليوم فقط.
report_period_lteاستعلاملاالتاريخالأرباع المنتهية في هذا اليوم أو قبله فقط.
report_period_ltاستعلاملاالتاريخالأرباع المنتهية قبل هذا اليوم فقط.
cursorاستعلاملاسلسلة نصيةقيمة next_cursor من الصفحة السابقة، مع المعاملات الأخرى نفسها.
limitاستعلاملاعدد صحيحعدد الصفوف في الصفحة. الافتراضي 100 وبحد أقصى 500.

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

حقلالنوعيُرسلالمعنى
idسلسلة نصيةدائمًامعرّف المؤسسة: usa: ورقم CIK مكمَّلًا بأصفار إلى عشرة أرقام.
investorسلسلة نصيةاختيارياسم المؤسسة، كما تقدّمه في إفصاحها.
periodالتاريخاختيارينهاية ربع التقرير الذي قُدِّم. تُحذف عندما يُطلب من مسار الحيازات نطاق من الأرباع.
periodslist of dateدائمًانهايات أرباع التقرير المحفوظة، من الأحدث.
built_atسلسلة نصيةاختياريوقت بناء الملف الذي تقوم عليه الإجابة (UTC).
holdingsقائمة كائناتدائمًاالمراكز، الأكبر قيمة أولًا. ونطاق الأرباع يسرد أحدث ربع أولًا.
holdings[].company_idسلسلة نصيةاختياريمعرّف المُصدِر في قائمة شركاتنا. يُحذف عندما لا يُطابَق المُصدِر مع شركة.
holdings[].companyسلسلة نصيةاختيارياسم المُصدِر في قائمة شركاتنا.
holdings[].tickerسلسلة نصيةاختياريرمز المُصدِر في قائمة شركاتنا.
holdings[].filing_idسلسلة نصيةدائمًامعرّف إفصاح 13F الذي جاء منه الصف.
holdings[].formسلسلة نصيةدائمًانموذج الإفصاح، مثل 13F-HR.
holdings[].reportalways "combination"اختياريcombination عندما يكون الإفصاح تقريرًا مجمّعًا: يتضمن مراكز مديرين آخرين.
holdings[].amendmentone of restatement, new_holdings, unstatedاختياريما يفعله التعديل بالإفصاح الذي يغيّره: restatement أو new_holdings أو unstated.
holdings[].filedالتاريخدائمًايوم تقديم الإفصاح.
holdings[].issuerسلسلة نصيةدائمًااسم المُصدِر، كما يطبعه الإفصاح.
holdings[].classسلسلة نصيةاختياريعنوان فئة الورقة المالية، مثل COM.
holdings[].valueسلسلة نصيةدائمًاقيمة المركز بالدولار الأمريكي.
holdings[].sharesسلسلة نصيةدائمًاالأسهم، أو مبلغ أصل الدين عندما يكون shares_type هو PRN.
holdings[].shares_typeone of SH, PRNاختياريSH للأسهم، وPRN لمبلغ أصل الدين.
holdings[].put_callone 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_of_portfolioسلسلة نصيةاختياريقيمة المركز كنسبة مئوية من table_value_total الخاص بالإفصاح.
holdings[].reported_priceسلسلة نصيةاختياريسعر السهم محسوبًا من value وshares. انظر الحدود أعلاه.
holdings[].other_managerslist of stringدائمًاأرقام المديرين الآخرين المشمولين الذين يشاركون في المركز.
holdings[].shares_changeسلسلة نصيةاختياريالتغيّر في shares منذ الربع السابق للمؤسسة. يكون سالبًا عندما باعت.
holdings[].new_positionدائمًا trueاختياريتكون true عندما لم تكن المؤسسة تحتفظ بشيء منه في الربع السابق.
holdings[].confidential_omittedدائمًا trueاختياريتكون true عندما حذف مقدّم الإفصاح مراكز طلب من SEC معاملتها بسرية.
next_cursorسلسلة نصيةدائمًامرّره بوصفه 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_id الذي يُقبل بوصفه cik في المسارات الأخرى.

مرّر investor_id، أو أرقامه فقط، بوصفه cik في المسارات الأخرى.

MCP: الأداة filings_search_investors.

المعلمات

معلمةالموضعمطلوبالنوعالمعنى
nameاستعلامنعمسلسلة نصيةجزء من اسم المؤسسة، بأي حالة أحرف، من 2 إلى 100 حرف.
cursorاستعلاملاسلسلة نصيةقيمة next_cursor من الصفحة السابقة، مع المعاملات الأخرى نفسها.
limitاستعلاملاعدد صحيحعدد الصفوف في الصفحة. الافتراضي 100 وبحد أقصى 500.

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

حقلالنوعيُرسلالمعنى
investorsقائمة كائناتدائمًاالمؤسسات التي يتضمن اسمها النص.
investors[].investor_idسلسلة نصيةدائمًامعرّف المؤسسة: usa: ورقم CIK مكمَّلًا بأصفار إلى عشرة أرقام.
investors[].nameسلسلة نصيةدائمًااسم المؤسسة، كما تقدّمه في إفصاحها.
investors[].latest_periodالتاريخدائمًانهاية ربع التقرير لأحدث إفصاح للمؤسسة.
next_cursorسلسلة نصيةدائمًامرّره بوصفه 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_list_investor_filings.

المعلمات

معلمةالموضعمطلوبالنوعالمعنى
cikمسارنعمسلسلة نصيةرقم CIK الخاص بالمؤسسة، من رقم إلى عشرة أرقام، أو investor_id الخاص بها (usa: ومن رقم إلى عشرة أرقام). الأصفار البادئة اختيارية.
report_period_gteاستعلاملاالتاريخالأرباع المنتهية في هذا اليوم أو بعده فقط (YYYY-MM-DD).
report_period_gtاستعلاملاالتاريخالأرباع المنتهية بعد هذا اليوم فقط.
report_period_lteاستعلاملاالتاريخالأرباع المنتهية في هذا اليوم أو قبله فقط.
report_period_ltاستعلاملاالتاريخالأرباع المنتهية قبل هذا اليوم فقط.
formاستعلاملاسلسلة نصيةالإفصاحات على هذا النموذج فقط: 13F-HR أو 13F-HR/A أو 13F-NT أو 13F-NT/A أو 13F-CTR.
cursorاستعلاملاسلسلة نصيةقيمة next_cursor من الصفحة السابقة، مع المعاملات الأخرى نفسها.
limitاستعلاملاعدد صحيحعدد الصفوف في الصفحة. الافتراضي 100 وبحد أقصى 500.

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

حقلالنوعيُرسلالمعنى
idسلسلة نصيةدائمًامعرّف المؤسسة: usa: ورقم CIK مكمَّلًا بأصفار إلى عشرة أرقام.
investorسلسلة نصيةاختيارياسم المؤسسة، كما تقدّمه في إفصاحها.
filingsقائمة كائناتدائمًاإفصاحات 13F، من أحدث ربع تقرير.
filings[].filing_idسلسلة نصيةدائمًامعرّف إفصاح 13F الذي جاء منه الصف.
filings[].formسلسلة نصيةدائمًانموذج الإفصاح، مثل 13F-HR.
filings[].periodالتاريخدائمًانهاية ربع التقرير الذي يغطيه الإفصاح.
filings[].filedالتاريخدائمًايوم تقديم الإفصاح.
filings[].report_typeسلسلة نصيةاختيارينوع التقرير المطبوع على صفحة الغلاف، مثل 13F HOLDINGS REPORT.
filings[].amendmentone of restatement, new_holdings, unstatedاختياريما يفعله التعديل بالإفصاح الذي يغيّره: restatement أو new_holdings أو unstated.
filings[].amendment_noسلسلة نصيةاختياريرقم التعديل المطبوع على صفحة الغلاف.
filings[].file_numberسلسلة نصيةاختياريرقم ملف SEC المطبوع على صفحة الغلاف.
filings[].crdسلسلة نصيةاختياريرقم CRD المطبوع على صفحة الغلاف.
filings[].table_entry_totalعدد صحيحاختياريعدد الإدخالات التي أعلنها مقدّم الإفصاح في جدوله.
filings[].table_value_totalسلسلة نصيةاختياريإجمالي القيمة الذي أعلنه مقدّم الإفصاح لجدوله، بالدولار الأمريكي.
filings[].other_included_managers_countعدد صحيحاختياريعدد المديرين الآخرين المشمولين الذين أعلنهم مقدّم الإفصاح.
filings[].other_included_managersقائمة كائناتدائمًاالمديرون الآخرون الذين يشمل الإفصاح مراكزهم.
filings[].other_included_managers[].sequenceعدد صحيحدائمًارقم المدير. يشير إليه other_managers في المركز.
filings[].other_included_managers[].investor_idسلسلة نصيةاختياريمعرّف المدير، عندما يقدّم 13F خاصًا به.
filings[].other_included_managers[].nameسلسلة نصيةاختيارياسم المدير.
filings[].other_included_managers[].file_numberسلسلة نصيةاختياريرقم ملف SEC الخاص بالمدير.
filings[].other_included_managers[].crdسلسلة نصيةاختياريرقم CRD الخاص بالمدير.
filings[].confidential_omittedدائمًا trueاختياريتكون true عندما حذف مقدّم الإفصاح مراكز طلب من SEC معاملتها بسرية.
filings[].noticeدائمًا trueاختياريتكون true في تقرير إشعار، لا يسرد مراكز خاصة به.
next_cursorسلسلة نصيةدائمًامرّره بوصفه 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_id. راجع أخطاء API والرصيد لمعرفة الشكل وترويسات الرصيد. لا تُحاسَب الطلبات الفاشلة.

الرمزالحالةالمعنى
invalid_query400معامل مفقود أو غير معروف أو مكرر أو خارج نطاقه.
invalid_cursor400مؤشر الصفحة هذا لم يُعده هذا الطلب، أو أنه من طلب مختلف.
company_not_found404لا شركة تطابق المعرّف.
investor_not_found404لا يطابق أي مقدّم 13F رقم CIK هذا.
period_not_published404لا نحتفظ ببيانات 13F للربع المطلوب.
not_covered404السوق أو البلد أو الشركة غير مغطى بعد.
insufficient_credits402رصيدك أقل من تكلفة الطلب.
company_data_unavailable503تعذّرت قراءة الإفصاحات وراء هذا المسار الآن. حاول مرة أخرى بعد قليل.

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