جميع واجهات API

واجهة SEC Filings API

ابحث عن بيانات إيداعات SEC الوصفية وروابط المستندات الأصلية.

الطلب الأول

البدء السريع

استبدل YOUR_COMPANY_ID بمعرّف يعيده البحث عن الشركات. واجهة API للبحث عن الشركات

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/YOUR_COMPANY_ID/filings?forms=10-K,10-Q&filed_from=2020-01-01&filed_to=2027-01-01&limit=50" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
استجابة نموذجية استجابة توضيحية · ليست طلبًا مباشرًا
{
  "company": {
    "id": "cmp_a1b2c3d4e5f678901234567890abcdef",
    "name": "Apple Inc.",
    "cik": "0000320193"
  },
  "filings": [
    {
      "accession_number": "0000320193-24-000123",
      "form": "10-K",
      "filed_on": "2024-11-01",
      "accepted_at": "2024-11-01T10:01:36Z",
      "report_period": "2024-09-28",
      "is_amendment": false,
      "items": [],
      "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.html",
      "primary_document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm"
    }
  ],
  "next_cursor": null,
  "as_of": "2026-08-29T12:00:00Z"
}

نقاط النهاية

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

MCP · companies_list_filings

مرجع API

المصادر والمنهجية

بيانات SEC الوصفية الرسمية

المصدر هو هيئة الأوراق المالية والبورصات الأميركية. يستخدم Narwhal ارتباطات الشركات وبيانات وصفية للإرسالات وفهارس إيداعات EDGAR.

اقرأ المنهجية

هوية ثابتة

يبقى معرّف الشركة الواحد ثابتًا عند تغير الأسماء أو الرموز.

البيانات الوصفية للإيداع

تبقى النماذج والتواريخ والتعديلات وروابط SEC صريحة.

الأسئلة الشائعة

ما الذي تتضمنه الاستجابة؟

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

ما نطاق التغطية المتاح؟

يعيد الإصدار الأول البيانات الوصفية وروابط وثائق SEC الأساسية فقط. ولا يتضمن أجسام الإيداعات أو المرفقات أو حقائق XBRL أو معاملات المطلعين أو البيانات المالية أو حيازات 13F.

هل يتضمن نص الإيداع أو حقائق XBRL؟

لا. يغطي هذا العقد هوية الشركة وبيانات الإيداع الوصفية فقط.

أجرِ أول طلب لك

احصل على مفتاح API مجاني