جميع واجهات API

واجهة إيداعات SEC API

يقبل البحث اسم الشركة أو رمزها أو CIK. وتعيد الاستجابة معرّف الشركة الثابت المستخدم في مساري الهوية والإيداعات، ويتوفر ذلك باستخدام مفتاح Narwhal API.

الطلب الأول

البدء السريع →

ابحث عن مُصدر SEC مشمول بالاسم أو Ticker أو CIK ذي العشرة أرقام.

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies?query=AAPL&limit=20" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

استجابة نموذجية استجابة توضيحية · ليست طلبًا مباشرًا

{
  "query": "AAPL",
  "companies": [
    {
      "id": "cmp_a1b2c3d4e5f678901234567890abcdef",
      "name": "Apple Inc.",
      "cik": "0000320193",
      "listings": [
        {
          "ticker": "AAPL",
          "exchange": "Nasdaq"
        }
      ]
    }
  ],
  "next_cursor": null,
  "as_of": "2026-08-29T12:00:00Z"
}

نقاط النهاية

GETالبحث عن الشركات/v1/companies

ابحث عن مُصدر SEC مشمول بالاسم أو Ticker أو CIK ذي العشرة أرقام.

query: اسم الشركة أو Ticker أو CIK المكوّن من عشرة أرقام. المطابقة بالاسم وTicker غير حساسة لحالة الأحرف.
limit: الحد الأقصى للشركات المعادة. الافتراضي 20.
cursor: رمز المتابعة من الصفحة السابقة. وهو مرتبط بالاستعلام والمرشحات الأصلية.

MCP · companies_search

واجهة API للبحث عن الشركات →مرجع API →

GETاحصل على هوية الشركة/v1/companies/{company_id}

حوّل معرّف شركة Narwhal ثابتاً واحداً إلى هويتها لدى SEC وإدراجاتها ورمز الصناعة وأسمائها السابقة.

company_id: هوية الشركة الثابتة التي يعيدها البحث. ويظل رمز التداول وCIK اسمين بديلين، لا هوية دائمة للمسار.

MCP · companies_get

واجهة API لهوية الشركة →مرجع API →

GETاعرض إيداعات الشركة/v1/companies/{company_id}/filings

اعرض البيانات الوصفية لإيداعات SEC حسب الشركة، بما في ذلك 10-K و10-Q و8-K وForm 4 و13F-HR.

company_id: هوية الشركة الثابتة التي يعيدها البحث. ويظل رمز التداول وCIK اسمين بديلين، لا هوية دائمة للمسار.
forms: رموز النماذج الدقيقة الحساسة لحالة الأحرف. يطابق النموذج الأساسي أيضًا تعديله /A ما لم تُستبعد التعديلات.
filed_from: حد أدنى شامل لتاريخ الإيداع.
filed_to: حد أعلى حصري لتاريخ الإيداع. يجب أن يكون لاحقًا لـ filed_from.
include_amendments: أدرج التعديلات عند طلب نموذج أساسي. القيمة الافتراضية صحيحة.
limit: الحد الأقصى للإيداعات المعادة. الافتراضي 50.
cursor: رمز المتابعة من الصفحة السابقة. وهو مرتبط بالاستعلام والمرشحات الأصلية.