مرجع API تداولات المطلعين

تداولات مطلعي الشركات وحيازاتهم من Form 3 وForm 4 وForm 5 لدى SEC

نظرة عامة

تأتي تداولات المطلعين من نماذج الملكية لدى SEC: Form 3 (الحيازات الأولية) وForm 4 (التغييرات) وForm 5 (التحديث السنوي)، وتعديلاتها. وتشمل مسؤولي الشركات الأمريكية المدرجة ومديريها ومالكي 10% منها. يحتاج كل طلب إلى مفتاح Bearer، ويستخدم REST وMCP رصيدًا واحدًا.

ثمانية مسارات تغطي تداولات شركة واحدة وحيازاتها وبيانات حيازاتها ومطلعيها، وتداولات مطلع واحد عبر الشركات، وتغذية بتداولات كل الشركات، ومجاميع الشراء والبيع اليومية، وقائمة رموز المعاملات. تُحدَّد الشركة بمعرّفها في Filings API، مثل usa:0000320193. ويُحدَّد المطلع بـ CIK الخاص به.

يبدأ السجل بإفصاحات أكتوبر 2021. تُقرأ الإفصاحات الجديدة من SEC كل دقيقتين.

الولايات المتحدة هي الدولة الوحيدة المغطاة. الدولة الأخرى تعطي 404 not_covered.

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

الحاملون لأكثر من 5% في صفحة كبار الحاملين.

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

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

ما	كل حساب
تداولات المطلعين، سبعة مسارات	مشمول
قائمة رموز المعاملات	مشمول، مجاني

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

يُحاسَب بسعر Companies. كل إجابة ناجحة استدعاء واحد، مهما كان عدد الصفوف، وتُحاسَب الصفحة الفارغة أيضًا. لا تُحاسَب الأخطاء. قائمة رموز المعاملات مجانية.
الأرقام سلاسل عشرية. يُحذف الحقل الذي لا قيمة له، وتكون القائمة موجودة دائمًا، ولا يُرسل علم مثل officer إلا عندما يكون true.
سعر التداول للسهم الواحد ويُحذف عندما لا يذكر الإفصاح سعرًا. تُحسب transaction_value وshares_owned_before فقط عندما يذكر الإفصاح الأرقام التي تُشتق منها.
خانة Rule 10b5-1 علامة واحدة للنموذج كله. تكون plan_10b5_1 true لكل تداول على هذا النموذج، بما في ذلك التداولات التي لم ينفذها المُبلِّغ بموجب الخطة.
التعديل الذي طابق أصلًا واحدًا فقط يذكره في amends. وعندما يذكر أصلًا لم نتمكن من العثور عليه تكون amends_unmatched true ويبقى الصفان في القائمة.
الحاملون الذين يُبلغون عبر كيانات أخرى فقط، مثل شركة أم، يُدرجون بلا إجمالي أسهم. تكون ownership_pct فارغة حيث لا يوجد عدد أسهم.
الشركة الموجودة في التغذية وغير الموجودة في قائمة شركاتنا تُجيب 404 في مسارات الشركات.
CIK مطلع لا نملك عنه شيئًا يُجيب بصفحة فارغة في مسار المطلع، وتُحاسَب.

نقاط النهاية

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

قائمة تداولات المطلعين في شركة

GET /v1/companies/{company_id}/insider-trades

كل معاملة في أسهم الشركة أبلغ عنها مسؤولوها ومديروها ومالكو 10% منها في Form 4 وForm 5، الأحدث إفصاحًا أولًا. تُدرج المعاملات على المشتقات (الخيارات والوارنتات والأدوات القابلة للتحويل) وتحمل derivative.

تأتي التداولات من Form 4 وForm 5. form_type بقيمة 3 أو 3/A يعطي قائمة فارغة.

الترتيب الافتراضي حسب تاريخ الإفصاح، الأحدث أولًا. أرسل sort=transaction_date.asc للقراءة بترتيب التداول.

MCP: الأداة filings_list_insider_trades.

المعلمات

معلمة	الموضع	مطلوب	النوع	المعنى
`company_id`	مسار	نعم	سلسلة نصية	معرّف الشركة، مثل `usa:0000320193`. يُقبل رمز تداول بديل مثل `usa:AAPL`.
`filed_from`	استعلام	لا	التاريخ	أول يوم إفصاح، شاملًا (YYYY-MM-DD).
`filed_to`	استعلام	لا	التاريخ	آخر يوم إفصاح، شاملًا.
`filing_date`	استعلام	لا	التاريخ	الإفصاحات المقدمة في هذا اليوم فقط.
`filing_date_gt`	استعلام	لا	التاريخ	الإفصاحات المقدمة بعد هذا اليوم فقط.
`filing_date_lt`	استعلام	لا	التاريخ	الإفصاحات المقدمة قبل هذا اليوم فقط.
`transaction_date`	استعلام	لا	التاريخ	التداولات المنفذة في هذا اليوم فقط.
`transaction_date_gt`	استعلام	لا	التاريخ	التداولات المنفذة بعد هذا اليوم فقط.
`transaction_date_gte`	استعلام	لا	التاريخ	التداولات المنفذة في هذا اليوم أو بعده فقط.
`transaction_date_lt`	استعلام	لا	التاريخ	التداولات المنفذة قبل هذا اليوم فقط.
`transaction_date_lte`	استعلام	لا	التاريخ	التداولات المنفذة في هذا اليوم أو قبله فقط.
`owner_cik`	استعلام	لا	سلسلة نصية	إفصاحات المالك صاحب CIK هذا فقط. الأصفار البادئة اختيارية.
`name`	استعلام	لا	سلسلة نصية	المالكون الذين يحتوي اسمهم على هذا النص فقط. غير حساس لحالة الأحرف، من 2 إلى 100 حرف.
`transaction_code`	استعلام	لا	سلسلة نصية	التداولات ذات رمز معاملة SEC هذا من حرف واحد فقط، مثل `P` أو `S`.
`form_type`	استعلام	لا	one of 3, 3/A, 4, 4/A, 5, 5/A	التداولات على هذا النموذج فقط. تأتي التداولات من Form 4 وForm 5.
`sort`	استعلام	لا	one of filing_date.desc, filing_date.asc, transaction_date.desc, transaction_date.asc	ترتيب القائمة. الافتراضي `filing_date.desc`.
`cursor`	استعلام	لا	سلسلة نصية	قيمة `next_cursor` من الصفحة السابقة، مع المعاملات الأخرى نفسها.
`limit`	استعلام	لا	عدد صحيح	عدد الصفوف في الصفحة. الافتراضي 50 وبحد أقصى 200.

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

حقل	النوع	يُرسل	المعنى
`id`	سلسلة نصية	دائمًا	معرّف الشركة. في تداولات مطلع واحد يكون `usa:` ثم CIK المطلع.
`filed_from`	التاريخ	اختياري	أقدم يوم إفصاح يستطيع هذا الحساب قراءته. يُحذف عندما لا يكون أي يوم أقدم محجوبًا.
`trades`	قائمة كائنات	دائمًا	التداولات، بالترتيب المطلوب.
`trades[].derivative`	دائمًا true	اختياري	تكون القيمة true عندما يكون الصف ورقة مالية مشتقة مثل خيار أو وارنت أو أداة قابلة للتحويل.
`trades[].security`	سلسلة نصية	اختياري	عنوان الورقة المالية كما ورد في الإفصاح، مثل Common Stock.
`trades[].ownership`	one of D, I	اختياري	`D` للملكية المباشرة و`I` للملكية غير المباشرة.
`trades[].nature`	سلسلة نصية	اختياري	كيفية الاحتفاظ بالملكية غير المباشرة، كما ورد في الإفصاح.
`trades[].underlying`	سلسلة نصية	اختياري	للمشتقة، الورقة المالية التي تتحول إليها.
`trades[].underlying_shares`	سلسلة نصية	اختياري	للمشتقة، عدد الأسهم الأساسية.
`trades[].exercise_price`	سلسلة نصية	اختياري	للمشتقة، سعر التنفيذ أو التحويل.
`trades[].exercise_date`	التاريخ	اختياري	للمشتقة، أول تاريخ يمكن ممارستها فيه.
`trades[].expiration_date`	التاريخ	اختياري	للمشتقة، تاريخ انتهائها.
`trades[].filing_id`	سلسلة نصية	دائمًا	معرّف الإفصاح الذي جاء منه الصف.
`trades[].form`	one of 3, 3/A, 4, 4/A, 5, 5/A	دائمًا	النموذج الذي أُبلغ عن الصف فيه: `3` أو `4` أو `5`، مع `/A` للتعديل.
`trades[].filed`	التاريخ	دائمًا	يوم تقديم الإفصاح.
`trades[].period`	التاريخ	اختياري	تاريخ الحدث الذي استوجب الإفصاح.
`trades[].owners`	قائمة كائنات	دائمًا	المالكون المُبلِّغون في الإفصاح. يُدرج الإفصاح المشترك عدة مالكين.
`trades[].owners[].cik`	سلسلة نصية	اختياري	رقم CIK لدى SEC للمالك.
`trades[].owners[].id`	سلسلة نصية	اختياري	معرّف المالك مع سجله، مثل `usa:0001780525`.
`trades[].owners[].name`	سلسلة نصية	دائمًا	اسم المالك كما ورد في الإفصاح.
`trades[].owners[].title`	سلسلة نصية	اختياري	لقب المسؤول أو علاقة أخرى، كما ورد في الإفصاح.
`trades[].owners[].director`	دائمًا true	اختياري	تكون القيمة true عندما يكون المالك عضو مجلس إدارة.
`trades[].owners[].officer`	دائمًا true	اختياري	تكون القيمة true عندما يكون المالك مسؤولًا تنفيذيًا.
`trades[].owners[].ten_percent`	دائمًا true	اختياري	تكون القيمة true عندما يملك المالك أكثر من 10% من الأسهم.
`trades[].owners[].other`	دائمًا true	اختياري	تكون القيمة true عندما تكون للمالك علاقة أخرى بالشركة.
`trades[].plan_10b5_1`	دائمًا true	اختياري	تكون القيمة true عندما يحدد النموذج خانة Rule 10b5-1.
`trades[].transaction_date`	التاريخ	اختياري	تاريخ التداول.
`trades[].code`	سلسلة نصية	اختياري	رمز معاملة SEC، مثل `P` شراء و`S` بيع و`A` منحة و`M` ممارسة خيار و`F` اقتطاع ضريبي و`G` هبة.
`trades[].acquired_disposed`	one of A, D	اختياري	`A` عندما اكتسب المالك أسهمًا و`D` عندما تصرّف فيها.
`trades[].shares`	سلسلة نصية	اختياري	عدد الأسهم في التداول.
`trades[].price`	سلسلة نصية	اختياري	سعر السهم. يُحذف عندما لا يذكر الإفصاح سعرًا.
`trades[].currency`	سلسلة نصية	اختياري	عملة الأسعار والقيم. الحذف يعني الدولار الأمريكي.
`trades[].owned_after`	سلسلة نصية	اختياري	الأسهم المملوكة بعد التداول.
`trades[].equity_swap`	دائمًا true	اختياري	تكون القيمة true عندما علّم المُبلِّغ التداول بوصفه مقايضة أسهم أو أداة مشابهة.
`trades[].amends`	سلسلة نصية	اختياري	الإفصاح الذي يحل هذا الإفصاح محله، عندما يكون تعديلًا طابق أصلًا واحدًا فقط.
`trades[].amends_unmatched`	دائمًا true	اختياري	تكون القيمة true عندما يذكر التعديل أصلًا لم نتمكن من العثور عليه.
`trades[].transaction_value`	سلسلة نصية	اختياري	`shares` مضروبًا في `price`. يُحذف ما لم يذكر الإفصاح الاثنين.
`trades[].shares_owned_before`	سلسلة نصية	اختياري	الأسهم المملوكة قبل التداول. تُعطى فقط عندما تتسلسل الأرصدة في صفوف الإفصاح لذلك المركز، كل رصيد من الذي قبله.
`trades[].deemed_execution_date`	التاريخ	اختياري	تاريخ اعتبار التداول منفذًا، عندما يذكره الإفصاح.
`trades[].timeliness`	one of E, L	اختياري	`E` عندما علّم المُبلِّغ التقرير بأنه مبكر و`L` عندما علّمه بأنه متأخر.
`trades[].not_subject_to_section_16`	دائمًا true	اختياري	تكون القيمة true عندما علّم المُبلِّغ التداول بأنه غير خاضع لـ Section 16.
`trades[].remarks`	سلسلة نصية	اختياري	ملاحظات كتبها المُبلِّغ على النموذج.
`trades[].footnotes`	list of string	دائمًا	حواشي الصف. فارغة عندما لا توجد حواشٍ.
`trades[].company_id`	سلسلة نصية	اختياري	معرّف الشركة التي جرى تداول أسهمها. يُرسل في القوائم التي لا تخص شركة واحدة.
`trades[].issuer`	سلسلة نصية	اختياري	اسم الشركة التي جرى تداول أسهمها.
`trades[].ticker`	سلسلة نصية	اختياري	رمز تداول الشركة.
`next_cursor`	سلسلة نصية	دائمًا	مرّره بوصفه cursor لقراءة الصفحة التالية. يُرسل دائمًا؛ وقيمته null في الصفحة الأخيرة.

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/companies/usa:0000320193/insider-trades?transaction_code=S&limit=1"

{
  "id": "usa:0000320193",
  "trades": [
    {
      "security": "Common Stock",
      "ownership": "D",
      "filing_id": "usa:0000320193:0001140361-26-042149",
      "form": "4",
      "filed": "2026-11-05",
      "period": "2026-11-03",
      "owners": [
        {
          "cik": "0001780525",
          "name": "Newstead Jennifer",
          "title": "SVP, GC and Government Affairs",
          "officer": true
        }
      ],
      "plan_10b5_1": true,
      "transaction_date": "2026-11-03",
      "code": "S",
      "acquired_disposed": "D",
      "shares": "2399",
      "price": "325.75",
      "owned_after": "29997",
      "transaction_value": "781474.25",
      "shares_owned_before": "32396",
      "footnotes": [
        "This transaction was made pursuant to a Rule 10b5-1 trading plan adopted by the reporting person on May 5, 2026."
      ]
    }
  ],
  "next_cursor": "eyJrIjoiNzk3Mzg4OTQ5OTk4…"
}

قائمة حيازات المطلعين في شركة

GET /v1/companies/{company_id}/insider-ownership

أحدث حيازة مُبلَّغ عنها لكل مطلع في كل ورقة مالية: الرصيد بعد أحدث تداول، أو أحدث Form 3 أو حيازة سنوية، أيهما قُدّم أخيرًا.

صف لكل مالك وورقة مالية: أحدث رصيد. shares هو الكمية المملوكة، أو value عندما يذكر الإفصاح دولارات بدلها. as_of هو تاريخ ذلك التداول أو تاريخ إفصاح تلك الحيازة.

MCP: الأداة filings_list_insider_ownership.

المعلمات

معلمة	الموضع	مطلوب	النوع	المعنى
`company_id`	مسار	نعم	سلسلة نصية	معرّف الشركة، مثل `usa:0000320193`. يُقبل رمز تداول بديل مثل `usa:AAPL`.
`filed_from`	استعلام	لا	التاريخ	أول يوم إفصاح، شاملًا (YYYY-MM-DD).
`filed_to`	استعلام	لا	التاريخ	آخر يوم إفصاح، شاملًا.
`filing_date`	استعلام	لا	التاريخ	الإفصاحات المقدمة في هذا اليوم فقط.
`filing_date_gt`	استعلام	لا	التاريخ	الإفصاحات المقدمة بعد هذا اليوم فقط.
`filing_date_lt`	استعلام	لا	التاريخ	الإفصاحات المقدمة قبل هذا اليوم فقط.
`owner_cik`	استعلام	لا	سلسلة نصية	إفصاحات المالك صاحب CIK هذا فقط. الأصفار البادئة اختيارية.
`name`	استعلام	لا	سلسلة نصية	المالكون الذين يحتوي اسمهم على هذا النص فقط. غير حساس لحالة الأحرف، من 2 إلى 100 حرف.
`form_type`	استعلام	لا	one of 3, 3/A, 4, 4/A, 5, 5/A	الإفصاحات على هذا النموذج فقط.
`cursor`	استعلام	لا	سلسلة نصية	قيمة `next_cursor` من الصفحة السابقة، مع المعاملات الأخرى نفسها.
`limit`	استعلام	لا	عدد صحيح	عدد الصفوف في الصفحة. الافتراضي 100 وبحد أقصى 500.

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

حقل	النوع	يُرسل	المعنى
`id`	سلسلة نصية	دائمًا	معرّف الشركة. في تداولات مطلع واحد يكون `usa:` ثم CIK المطلع.
`filed_from`	التاريخ	اختياري	أقدم يوم إفصاح يستطيع هذا الحساب قراءته. يُحذف عندما لا يكون أي يوم أقدم محجوبًا.
`positions`	قائمة كائنات	دائمًا	أحدث حيازة لكل مالك في كل ورقة مالية.
`positions[].derivative`	دائمًا true	اختياري	تكون القيمة true عندما يكون الصف ورقة مالية مشتقة مثل خيار أو وارنت أو أداة قابلة للتحويل.
`positions[].security`	سلسلة نصية	اختياري	عنوان الورقة المالية كما ورد في الإفصاح، مثل Common Stock.
`positions[].ownership`	one of D, I	اختياري	`D` للملكية المباشرة و`I` للملكية غير المباشرة.
`positions[].nature`	سلسلة نصية	اختياري	كيفية الاحتفاظ بالملكية غير المباشرة، كما ورد في الإفصاح.
`positions[].underlying`	سلسلة نصية	اختياري	للمشتقة، الورقة المالية التي تتحول إليها.
`positions[].underlying_shares`	سلسلة نصية	اختياري	للمشتقة، عدد الأسهم الأساسية.
`positions[].exercise_price`	سلسلة نصية	اختياري	للمشتقة، سعر التنفيذ أو التحويل.
`positions[].exercise_date`	التاريخ	اختياري	للمشتقة، أول تاريخ يمكن ممارستها فيه.
`positions[].expiration_date`	التاريخ	اختياري	للمشتقة، تاريخ انتهائها.
`positions[].filing_id`	سلسلة نصية	دائمًا	معرّف الإفصاح الذي جاء منه الصف.
`positions[].form`	one of 3, 3/A, 4, 4/A, 5, 5/A	دائمًا	النموذج الذي أُبلغ عن الصف فيه: `3` أو `4` أو `5`، مع `/A` للتعديل.
`positions[].filed`	التاريخ	دائمًا	يوم تقديم الإفصاح.
`positions[].owners`	قائمة كائنات	دائمًا	المالكون المُبلِّغون في الإفصاح. يُدرج الإفصاح المشترك عدة مالكين.
`positions[].owners[].cik`	سلسلة نصية	اختياري	رقم CIK لدى SEC للمالك.
`positions[].owners[].id`	سلسلة نصية	اختياري	معرّف المالك مع سجله، مثل `usa:0001780525`.
`positions[].owners[].name`	سلسلة نصية	دائمًا	اسم المالك كما ورد في الإفصاح.
`positions[].owners[].title`	سلسلة نصية	اختياري	لقب المسؤول أو علاقة أخرى، كما ورد في الإفصاح.
`positions[].owners[].director`	دائمًا true	اختياري	تكون القيمة true عندما يكون المالك عضو مجلس إدارة.
`positions[].owners[].officer`	دائمًا true	اختياري	تكون القيمة true عندما يكون المالك مسؤولًا تنفيذيًا.
`positions[].owners[].ten_percent`	دائمًا true	اختياري	تكون القيمة true عندما يملك المالك أكثر من 10% من الأسهم.
`positions[].owners[].other`	دائمًا true	اختياري	تكون القيمة true عندما تكون للمالك علاقة أخرى بالشركة.
`positions[].as_of`	التاريخ	دائمًا	تاريخ التداول أو تاريخ إفصاح الحيازة التي تعطي هذا الرصيد.
`positions[].shares`	سلسلة نصية	اختياري	الكمية المملوكة، بالأسهم.
`positions[].value`	سلسلة نصية	اختياري	القيمة المملوكة بالدولار، عندما يذكر الإفصاح قيمة بدل الأسهم.
`positions[].currency`	سلسلة نصية	اختياري	عملة الأسعار والقيم. الحذف يعني الدولار الأمريكي.
`next_cursor`	سلسلة نصية	دائمًا	مرّره بوصفه cursor لقراءة الصفحة التالية. يُرسل دائمًا؛ وقيمته null في الصفحة الأخيرة.

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/companies/usa:0000320193/insider-ownership?limit=1"

{
  "id": "usa:0000320193",
  "positions": [
    {
      "security": "Common Stock",
      "ownership": "D",
      "filing_id": "usa:0000320193:0001140361-26-042149",
      "form": "4",
      "filed": "2026-11-05",
      "owners": [
        {
          "cik": "0001780525",
          "name": "Newstead Jennifer",
          "title": "SVP, GC and Government Affairs",
          "officer": true
        }
      ],
      "as_of": "2026-11-03",
      "shares": "29997"
    }
  ],
  "next_cursor": "eyJrIjoiNzk3Mzg4OTQ5OTk4…"
}

قائمة بيانات حيازات شركة

GET /v1/companies/{company_id}/insider-ownership/statements

كل بيان حيازات على Form 3 وForm 5، وتعديلاتهما، كما قُدّم، الأحدث أولًا. وليس أحدث رصيد فقط.

البيانات هي Form 3 وForm 5، وتعديلاتهما، كما قُدّمت. يقبل form_type القيم 3 و3/A و5 و5/A، وأي نموذج آخر يعطي 400 invalid_query.

MCP: الأداة filings_list_insider_statements.

المعلمات

معلمة	الموضع	مطلوب	النوع	المعنى
`company_id`	مسار	نعم	سلسلة نصية	معرّف الشركة، مثل `usa:0000320193`. يُقبل رمز تداول بديل مثل `usa:AAPL`.
`filed_from`	استعلام	لا	التاريخ	أول يوم إفصاح، شاملًا (YYYY-MM-DD).
`filed_to`	استعلام	لا	التاريخ	آخر يوم إفصاح، شاملًا.
`filing_date`	استعلام	لا	التاريخ	الإفصاحات المقدمة في هذا اليوم فقط.
`filing_date_gt`	استعلام	لا	التاريخ	الإفصاحات المقدمة بعد هذا اليوم فقط.
`filing_date_lt`	استعلام	لا	التاريخ	الإفصاحات المقدمة قبل هذا اليوم فقط.
`owner_cik`	استعلام	لا	سلسلة نصية	إفصاحات المالك صاحب CIK هذا فقط. الأصفار البادئة اختيارية.
`name`	استعلام	لا	سلسلة نصية	المالكون الذين يحتوي اسمهم على هذا النص فقط. غير حساس لحالة الأحرف، من 2 إلى 100 حرف.
`form_type`	استعلام	لا	one of 3, 3/A, 4, 4/A, 5, 5/A	البيانات على هذا النموذج فقط: `3` أو `3/A` أو `5` أو `5/A`.
`cursor`	استعلام	لا	سلسلة نصية	قيمة `next_cursor` من الصفحة السابقة، مع المعاملات الأخرى نفسها.
`limit`	استعلام	لا	عدد صحيح	عدد الصفوف في الصفحة. الافتراضي 100 وبحد أقصى 500.

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

حقل	النوع	يُرسل	المعنى
`id`	سلسلة نصية	دائمًا	معرّف الشركة. في تداولات مطلع واحد يكون `usa:` ثم CIK المطلع.
`statements`	قائمة كائنات	دائمًا	البيانات، الأحدث أولًا.
`statements[].derivative`	دائمًا true	اختياري	تكون القيمة true عندما يكون الصف ورقة مالية مشتقة مثل خيار أو وارنت أو أداة قابلة للتحويل.
`statements[].security`	سلسلة نصية	اختياري	عنوان الورقة المالية كما ورد في الإفصاح، مثل Common Stock.
`statements[].ownership`	one of D, I	اختياري	`D` للملكية المباشرة و`I` للملكية غير المباشرة.
`statements[].nature`	سلسلة نصية	اختياري	كيفية الاحتفاظ بالملكية غير المباشرة، كما ورد في الإفصاح.
`statements[].underlying`	سلسلة نصية	اختياري	للمشتقة، الورقة المالية التي تتحول إليها.
`statements[].underlying_shares`	سلسلة نصية	اختياري	للمشتقة، عدد الأسهم الأساسية.
`statements[].exercise_price`	سلسلة نصية	اختياري	للمشتقة، سعر التنفيذ أو التحويل.
`statements[].exercise_date`	التاريخ	اختياري	للمشتقة، أول تاريخ يمكن ممارستها فيه.
`statements[].expiration_date`	التاريخ	اختياري	للمشتقة، تاريخ انتهائها.
`statements[].filing_id`	سلسلة نصية	دائمًا	معرّف الإفصاح الذي جاء منه الصف.
`statements[].form`	one of 3, 3/A, 4, 4/A, 5, 5/A	دائمًا	النموذج الذي أُبلغ عن الصف فيه: `3` أو `4` أو `5`، مع `/A` للتعديل.
`statements[].filed`	التاريخ	دائمًا	يوم تقديم الإفصاح.
`statements[].owners`	قائمة كائنات	دائمًا	المالكون المُبلِّغون في الإفصاح. يُدرج الإفصاح المشترك عدة مالكين.
`statements[].owners[].cik`	سلسلة نصية	اختياري	رقم CIK لدى SEC للمالك.
`statements[].owners[].id`	سلسلة نصية	اختياري	معرّف المالك مع سجله، مثل `usa:0001780525`.
`statements[].owners[].name`	سلسلة نصية	دائمًا	اسم المالك كما ورد في الإفصاح.
`statements[].owners[].title`	سلسلة نصية	اختياري	لقب المسؤول أو علاقة أخرى، كما ورد في الإفصاح.
`statements[].owners[].director`	دائمًا true	اختياري	تكون القيمة true عندما يكون المالك عضو مجلس إدارة.
`statements[].owners[].officer`	دائمًا true	اختياري	تكون القيمة true عندما يكون المالك مسؤولًا تنفيذيًا.
`statements[].owners[].ten_percent`	دائمًا true	اختياري	تكون القيمة true عندما يملك المالك أكثر من 10% من الأسهم.
`statements[].owners[].other`	دائمًا true	اختياري	تكون القيمة true عندما تكون للمالك علاقة أخرى بالشركة.
`statements[].as_of`	التاريخ	دائمًا	تاريخ التداول أو تاريخ إفصاح الحيازة التي تعطي هذا الرصيد.
`statements[].shares`	سلسلة نصية	اختياري	الكمية المملوكة، بالأسهم.
`statements[].value`	سلسلة نصية	اختياري	القيمة المملوكة بالدولار، عندما يذكر الإفصاح قيمة بدل الأسهم.
`statements[].currency`	سلسلة نصية	اختياري	عملة الأسعار والقيم. الحذف يعني الدولار الأمريكي.
`next_cursor`	سلسلة نصية	دائمًا	مرّره بوصفه cursor لقراءة الصفحة التالية. يُرسل دائمًا؛ وقيمته null في الصفحة الأخيرة.

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/companies/usa:0000320193/insider-ownership/statements?limit=1"

{
  "id": "usa:0000320193",
  "statements": [
    {
      "security": "Common Stock",
      "ownership": "D",
      "filing_id": "usa:0000320193:0001140361-26-035359",
      "form": "3",
      "filed": "2026-09-01",
      "owners": [
        {
          "cik": "0002148403",
          "name": "Ternus John",
          "title": "CEO",
          "director": true,
          "officer": true
        }
      ],
      "as_of": "2026-09-01",
      "shares": "34155"
    }
  ],
  "next_cursor": "eyJrIjoiNzk3MzkwOTg5OTk4…"
}

قائمة مطلعي شركة

GET /v1/companies/{company_id}/insiders

كل شخص أبلغ عن الشركة في Form 3 أو Form 4 أو Form 5، مع أدواره وعدد مرات إفصاحه وما يملكه الآن.

تجمع shares_owned_direct وshares_owned_indirect أحدث رصيد لكل مركز في الأسهم العادية. تُستبعد المشتقات. المركز الذي يبلغ عنه عدة مالكين معًا يُحسب لكل منهم.

MCP: الأداة filings_list_company_insiders.

المعلمات

معلمة	الموضع	مطلوب	النوع	المعنى
`company_id`	مسار	نعم	سلسلة نصية	معرّف الشركة، مثل `usa:0000320193`. يُقبل رمز تداول بديل مثل `usa:AAPL`.
`name`	استعلام	لا	سلسلة نصية	المالكون الذين يحتوي اسمهم على هذا النص فقط. غير حساس لحالة الأحرف، من 2 إلى 100 حرف.
`cursor`	استعلام	لا	سلسلة نصية	قيمة `next_cursor` من الصفحة السابقة، مع المعاملات الأخرى نفسها.
`limit`	استعلام	لا	عدد صحيح	عدد الصفوف في الصفحة. الافتراضي 100 وبحد أقصى 500.

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

حقل	النوع	يُرسل	المعنى
`id`	سلسلة نصية	دائمًا	معرّف الشركة. في تداولات مطلع واحد يكون `usa:` ثم CIK المطلع.
`insiders`	قائمة كائنات	دائمًا	مطلعو الشركة.
`insiders[].owner_cik`	سلسلة نصية	اختياري	رقم CIK لدى SEC للمطلع.
`insiders[].owner_id`	سلسلة نصية	اختياري	معرّف المطلع مع سجله.
`insiders[].name`	سلسلة نصية	دائمًا	اسم المالك كما ورد في الإفصاح.
`insiders[].title`	سلسلة نصية	اختياري	لقب المسؤول أو علاقة أخرى، كما ورد في الإفصاح.
`insiders[].director`	دائمًا true	اختياري	تكون القيمة true عندما يكون المالك عضو مجلس إدارة.
`insiders[].officer`	دائمًا true	اختياري	تكون القيمة true عندما يكون المالك مسؤولًا تنفيذيًا.
`insiders[].ten_percent`	دائمًا true	اختياري	تكون القيمة true عندما يملك المالك أكثر من 10% من الأسهم.
`insiders[].other`	دائمًا true	اختياري	تكون القيمة true عندما تكون للمالك علاقة أخرى بالشركة.
`insiders[].first_filing_date`	التاريخ	دائمًا	يوم أول إفصاح للمطلع عن هذه الشركة.
`insiders[].last_filing_date`	التاريخ	دائمًا	يوم أحدث إفصاح للمطلع عن هذه الشركة.
`insiders[].filing_count`	عدد صحيح	دائمًا	عدد الإفصاحات التي قدّمها المطلع عن هذه الشركة.
`insiders[].position_count`	عدد صحيح	دائمًا	عدد المراكز التي أبلغ عنها المطلع.
`insiders[].shares_owned`	سلسلة نصية	اختياري	مجموع أحدث رصيد لكل مركز في الأسهم العادية. يُحذف عندما لم يبلغ المطلع عن رصيد أسهم قط.
`insiders[].shares_owned_direct`	سلسلة نصية	اختياري	الجزء من `shares_owned` المملوك مباشرة.
`insiders[].shares_owned_indirect`	سلسلة نصية	اختياري	الجزء من `shares_owned` المملوك بصورة غير مباشرة.
`insiders[].ownership_pct`	سلسلة نصية	اختياري	`shares_owned` كنسبة مئوية من أحدث أسهم قائمة أُبلغ عنها للشركة. يُحذف عندما لا تُعرف، أو عندما تتجاوز النتيجة 100، أو عندما يكون للشركة أكثر من فئة واحدة من الأسهم.
`insiders[].outstanding_as_of`	التاريخ	اختياري	تاريخ رقم الأسهم القائمة الذي تقوم عليه `ownership_pct`.
`next_cursor`	سلسلة نصية	دائمًا	مرّره بوصفه cursor لقراءة الصفحة التالية. يُرسل دائمًا؛ وقيمته null في الصفحة الأخيرة.

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/companies/usa:0000320193/insiders?limit=1"

{
  "id": "usa:0000320193",
  "insiders": [
    {
      "owner_cik": "0001780525",
      "name": "Newstead Jennifer",
      "title": "SVP, GC and Government Affairs",
      "officer": true,
      "first_filing_date": "2026-03-06",
      "last_filing_date": "2026-11-05",
      "filing_count": 17,
      "position_count": 1,
      "shares_owned": "29997",
      "shares_owned_direct": "29997",
      "ownership_pct": "0.0002",
      "outstanding_as_of": "2026-10-23"
    }
  ],
  "next_cursor": "eyJrIjoiNzk3My04OC05NHww…"
}

قائمة تداولات مطلع واحد

GET /v1/insiders/{cik}/trades

كل تداول قدّمه مطلع واحد عبر الشركات، الأحدث إفصاحًا أولًا. cik هو CIK المطلع نفسه.

id في الجواب هو usa: ثم CIK المطلع. الصفوف هي نفسها في مسار الشركة، مع إضافة company_id وissuer وticker.

MCP: الأداة filings_list_insider_person_trades.

المعلمات

معلمة	الموضع	مطلوب	النوع	المعنى
`cik`	مسار	نعم	سلسلة نصية	CIK المطلع نفسه، من رقم إلى عشرة أرقام.
`filed_from`	استعلام	لا	التاريخ	أول يوم إفصاح، شاملًا (YYYY-MM-DD).
`filed_to`	استعلام	لا	التاريخ	آخر يوم إفصاح، شاملًا.
`filing_date`	استعلام	لا	التاريخ	الإفصاحات المقدمة في هذا اليوم فقط.
`filing_date_gt`	استعلام	لا	التاريخ	الإفصاحات المقدمة بعد هذا اليوم فقط.
`filing_date_lt`	استعلام	لا	التاريخ	الإفصاحات المقدمة قبل هذا اليوم فقط.
`transaction_date`	استعلام	لا	التاريخ	التداولات المنفذة في هذا اليوم فقط.
`transaction_date_gt`	استعلام	لا	التاريخ	التداولات المنفذة بعد هذا اليوم فقط.
`transaction_date_gte`	استعلام	لا	التاريخ	التداولات المنفذة في هذا اليوم أو بعده فقط.
`transaction_date_lt`	استعلام	لا	التاريخ	التداولات المنفذة قبل هذا اليوم فقط.
`transaction_date_lte`	استعلام	لا	التاريخ	التداولات المنفذة في هذا اليوم أو قبله فقط.
`owner_cik`	استعلام	لا	سلسلة نصية	إفصاحات المالك صاحب CIK هذا فقط. الأصفار البادئة اختيارية.
`name`	استعلام	لا	سلسلة نصية	المالكون الذين يحتوي اسمهم على هذا النص فقط. غير حساس لحالة الأحرف، من 2 إلى 100 حرف.
`transaction_code`	استعلام	لا	سلسلة نصية	التداولات ذات رمز معاملة SEC هذا من حرف واحد فقط، مثل `P` أو `S`.
`form_type`	استعلام	لا	one of 3, 3/A, 4, 4/A, 5, 5/A	التداولات على هذا النموذج فقط. تأتي التداولات من Form 4 وForm 5.
`sort`	استعلام	لا	one of filing_date.desc, filing_date.asc, transaction_date.desc, transaction_date.asc	ترتيب القائمة. الافتراضي `filing_date.desc`.
`cursor`	استعلام	لا	سلسلة نصية	قيمة `next_cursor` من الصفحة السابقة، مع المعاملات الأخرى نفسها.
`limit`	استعلام	لا	عدد صحيح	عدد الصفوف في الصفحة. الافتراضي 50 وبحد أقصى 200.

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

حقل	النوع	يُرسل	المعنى
`id`	سلسلة نصية	اختياري	معرّف الشركة. في تداولات مطلع واحد يكون `usa:` ثم CIK المطلع.
`filed_from`	التاريخ	اختياري	أقدم يوم إفصاح يستطيع هذا الحساب قراءته. يُحذف عندما لا يكون أي يوم أقدم محجوبًا.
`trades`	قائمة كائنات	دائمًا	التداولات، بالترتيب المطلوب.
`trades[].derivative`	دائمًا true	اختياري	تكون القيمة true عندما يكون الصف ورقة مالية مشتقة مثل خيار أو وارنت أو أداة قابلة للتحويل.
`trades[].security`	سلسلة نصية	اختياري	عنوان الورقة المالية كما ورد في الإفصاح، مثل Common Stock.
`trades[].ownership`	one of D, I	اختياري	`D` للملكية المباشرة و`I` للملكية غير المباشرة.
`trades[].nature`	سلسلة نصية	اختياري	كيفية الاحتفاظ بالملكية غير المباشرة، كما ورد في الإفصاح.
`trades[].underlying`	سلسلة نصية	اختياري	للمشتقة، الورقة المالية التي تتحول إليها.
`trades[].underlying_shares`	سلسلة نصية	اختياري	للمشتقة، عدد الأسهم الأساسية.
`trades[].exercise_price`	سلسلة نصية	اختياري	للمشتقة، سعر التنفيذ أو التحويل.
`trades[].exercise_date`	التاريخ	اختياري	للمشتقة، أول تاريخ يمكن ممارستها فيه.
`trades[].expiration_date`	التاريخ	اختياري	للمشتقة، تاريخ انتهائها.
`trades[].filing_id`	سلسلة نصية	دائمًا	معرّف الإفصاح الذي جاء منه الصف.
`trades[].form`	one of 3, 3/A, 4, 4/A, 5, 5/A	دائمًا	النموذج الذي أُبلغ عن الصف فيه: `3` أو `4` أو `5`، مع `/A` للتعديل.
`trades[].filed`	التاريخ	دائمًا	يوم تقديم الإفصاح.
`trades[].period`	التاريخ	اختياري	تاريخ الحدث الذي استوجب الإفصاح.
`trades[].owners`	قائمة كائنات	دائمًا	المالكون المُبلِّغون في الإفصاح. يُدرج الإفصاح المشترك عدة مالكين.
`trades[].owners[].cik`	سلسلة نصية	اختياري	رقم CIK لدى SEC للمالك.
`trades[].owners[].id`	سلسلة نصية	اختياري	معرّف المالك مع سجله، مثل `usa:0001780525`.
`trades[].owners[].name`	سلسلة نصية	دائمًا	اسم المالك كما ورد في الإفصاح.
`trades[].owners[].title`	سلسلة نصية	اختياري	لقب المسؤول أو علاقة أخرى، كما ورد في الإفصاح.
`trades[].owners[].director`	دائمًا true	اختياري	تكون القيمة true عندما يكون المالك عضو مجلس إدارة.
`trades[].owners[].officer`	دائمًا true	اختياري	تكون القيمة true عندما يكون المالك مسؤولًا تنفيذيًا.
`trades[].owners[].ten_percent`	دائمًا true	اختياري	تكون القيمة true عندما يملك المالك أكثر من 10% من الأسهم.
`trades[].owners[].other`	دائمًا true	اختياري	تكون القيمة true عندما تكون للمالك علاقة أخرى بالشركة.
`trades[].plan_10b5_1`	دائمًا true	اختياري	تكون القيمة true عندما يحدد النموذج خانة Rule 10b5-1.
`trades[].transaction_date`	التاريخ	اختياري	تاريخ التداول.
`trades[].code`	سلسلة نصية	اختياري	رمز معاملة SEC، مثل `P` شراء و`S` بيع و`A` منحة و`M` ممارسة خيار و`F` اقتطاع ضريبي و`G` هبة.
`trades[].acquired_disposed`	one of A, D	اختياري	`A` عندما اكتسب المالك أسهمًا و`D` عندما تصرّف فيها.
`trades[].shares`	سلسلة نصية	اختياري	عدد الأسهم في التداول.
`trades[].price`	سلسلة نصية	اختياري	سعر السهم. يُحذف عندما لا يذكر الإفصاح سعرًا.
`trades[].currency`	سلسلة نصية	اختياري	عملة الأسعار والقيم. الحذف يعني الدولار الأمريكي.
`trades[].owned_after`	سلسلة نصية	اختياري	الأسهم المملوكة بعد التداول.
`trades[].equity_swap`	دائمًا true	اختياري	تكون القيمة true عندما علّم المُبلِّغ التداول بوصفه مقايضة أسهم أو أداة مشابهة.
`trades[].amends`	سلسلة نصية	اختياري	الإفصاح الذي يحل هذا الإفصاح محله، عندما يكون تعديلًا طابق أصلًا واحدًا فقط.
`trades[].amends_unmatched`	دائمًا true	اختياري	تكون القيمة true عندما يذكر التعديل أصلًا لم نتمكن من العثور عليه.
`trades[].transaction_value`	سلسلة نصية	اختياري	`shares` مضروبًا في `price`. يُحذف ما لم يذكر الإفصاح الاثنين.
`trades[].shares_owned_before`	سلسلة نصية	اختياري	الأسهم المملوكة قبل التداول. تُعطى فقط عندما تتسلسل الأرصدة في صفوف الإفصاح لذلك المركز، كل رصيد من الذي قبله.
`trades[].deemed_execution_date`	التاريخ	اختياري	تاريخ اعتبار التداول منفذًا، عندما يذكره الإفصاح.
`trades[].timeliness`	one of E, L	اختياري	`E` عندما علّم المُبلِّغ التقرير بأنه مبكر و`L` عندما علّمه بأنه متأخر.
`trades[].not_subject_to_section_16`	دائمًا true	اختياري	تكون القيمة true عندما علّم المُبلِّغ التداول بأنه غير خاضع لـ Section 16.
`trades[].remarks`	سلسلة نصية	اختياري	ملاحظات كتبها المُبلِّغ على النموذج.
`trades[].footnotes`	list of string	دائمًا	حواشي الصف. فارغة عندما لا توجد حواشٍ.
`trades[].company_id`	سلسلة نصية	اختياري	معرّف الشركة التي جرى تداول أسهمها. يُرسل في القوائم التي لا تخص شركة واحدة.
`trades[].issuer`	سلسلة نصية	اختياري	اسم الشركة التي جرى تداول أسهمها.
`trades[].ticker`	سلسلة نصية	اختياري	رمز تداول الشركة.
`next_cursor`	سلسلة نصية	دائمًا	مرّره بوصفه cursor لقراءة الصفحة التالية. يُرسل دائمًا؛ وقيمته null في الصفحة الأخيرة.

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/insiders/0001780525/trades?limit=1"

{
  "id": "usa:0001780525",
  "trades": [
    {
      "security": "Common Stock",
      "ownership": "D",
      "filing_id": "usa:0000320193:0001140361-26-042149",
      "form": "4",
      "filed": "2026-11-05",
      "period": "2026-11-03",
      "owners": [
        {
          "cik": "0001780525",
          "name": "Newstead Jennifer",
          "title": "SVP, GC and Government Affairs",
          "officer": true
        }
      ],
      "plan_10b5_1": true,
      "transaction_date": "2026-11-03",
      "code": "S",
      "acquired_disposed": "D",
      "shares": "2399",
      "price": "325.75",
      "owned_after": "29997",
      "transaction_value": "781474.25",
      "shares_owned_before": "32396",
      "footnotes": [
        "This transaction was made pursuant to a Rule 10b5-1 trading plan adopted by the reporting person on May 5, 2026."
      ],
      "company_id": "usa:0000320193",
      "issuer": "Apple Inc.",
      "ticker": "AAPL"
    }
  ],
  "next_cursor": "eyJrIjoiNzk3Mzg4OTQ5OTk4…"
}

قائمة تداولات المطلعين عبر الشركات

GET /v1/insider-trades

تداولات المطلعين في كل الشركات، الأحدث إفصاحًا أولًا. من دون تاريخ تُرجع أحدث يوم إفصاح لدينا والأيام الستة قبله.

من دون تاريخ تُرجع التغذية أحدث يوم إفصاح لدينا والأيام الستة قبله. مع نافذة أرسل filed_from مع filed_to، أو filing_date. تغطي النافذة 31 يومًا على الأكثر.

تُرتب التغذية حسب تاريخ الإفصاح، الأحدث أولًا. للترتيب حسب تاريخ التداول اطلب شركة واحدة أو مطلعًا واحدًا.

MCP: الأداة filings_list_insider_feed.

المعلمات

معلمة	الموضع	مطلوب	النوع	المعنى
`filed_from`	استعلام	لا	التاريخ	أول يوم إفصاح، شاملًا (YYYY-MM-DD).
`filed_to`	استعلام	لا	التاريخ	آخر يوم إفصاح، شاملًا.
`filing_date`	استعلام	لا	التاريخ	الإفصاحات المقدمة في هذا اليوم فقط.
`filing_date_gt`	استعلام	لا	التاريخ	الإفصاحات المقدمة بعد هذا اليوم فقط.
`filing_date_lt`	استعلام	لا	التاريخ	الإفصاحات المقدمة قبل هذا اليوم فقط.
`transaction_date`	استعلام	لا	التاريخ	التداولات المنفذة في هذا اليوم فقط.
`transaction_date_gt`	استعلام	لا	التاريخ	التداولات المنفذة بعد هذا اليوم فقط.
`transaction_date_gte`	استعلام	لا	التاريخ	التداولات المنفذة في هذا اليوم أو بعده فقط.
`transaction_date_lt`	استعلام	لا	التاريخ	التداولات المنفذة قبل هذا اليوم فقط.
`transaction_date_lte`	استعلام	لا	التاريخ	التداولات المنفذة في هذا اليوم أو قبله فقط.
`owner_cik`	استعلام	لا	سلسلة نصية	إفصاحات المالك صاحب CIK هذا فقط. الأصفار البادئة اختيارية.
`name`	استعلام	لا	سلسلة نصية	المالكون الذين يحتوي اسمهم على هذا النص فقط. غير حساس لحالة الأحرف، من 2 إلى 100 حرف.
`transaction_code`	استعلام	لا	سلسلة نصية	التداولات ذات رمز معاملة SEC هذا من حرف واحد فقط، مثل `P` أو `S`.
`form_type`	استعلام	لا	one of 3, 3/A, 4, 4/A, 5, 5/A	التداولات على هذا النموذج فقط. تأتي التداولات من Form 4 وForm 5.
`sort`	استعلام	لا	one of filing_date.desc, filing_date.asc, transaction_date.desc, transaction_date.asc	ترتيب القائمة. الافتراضي `filing_date.desc`.
`cursor`	استعلام	لا	سلسلة نصية	قيمة `next_cursor` من الصفحة السابقة، مع المعاملات الأخرى نفسها.
`limit`	استعلام	لا	عدد صحيح	عدد الصفوف في الصفحة. الافتراضي 50 وبحد أقصى 200.
`country`	استعلام	لا	سلسلة نصية	رمز الدولة من ثلاثة أحرف للسجل. الحذف يعني USA. الدولة التي لا يغطيها المسار تُجيب 404 not_covered.

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

حقل	النوع	يُرسل	المعنى
`id`	سلسلة نصية	اختياري	معرّف الشركة. في تداولات مطلع واحد يكون `usa:` ثم CIK المطلع.
`filed_from`	التاريخ	اختياري	أقدم يوم إفصاح يستطيع هذا الحساب قراءته. يُحذف عندما لا يكون أي يوم أقدم محجوبًا.
`trades`	قائمة كائنات	دائمًا	التداولات، بالترتيب المطلوب.
`trades[].derivative`	دائمًا true	اختياري	تكون القيمة true عندما يكون الصف ورقة مالية مشتقة مثل خيار أو وارنت أو أداة قابلة للتحويل.
`trades[].security`	سلسلة نصية	اختياري	عنوان الورقة المالية كما ورد في الإفصاح، مثل Common Stock.
`trades[].ownership`	one of D, I	اختياري	`D` للملكية المباشرة و`I` للملكية غير المباشرة.
`trades[].nature`	سلسلة نصية	اختياري	كيفية الاحتفاظ بالملكية غير المباشرة، كما ورد في الإفصاح.
`trades[].underlying`	سلسلة نصية	اختياري	للمشتقة، الورقة المالية التي تتحول إليها.
`trades[].underlying_shares`	سلسلة نصية	اختياري	للمشتقة، عدد الأسهم الأساسية.
`trades[].exercise_price`	سلسلة نصية	اختياري	للمشتقة، سعر التنفيذ أو التحويل.
`trades[].exercise_date`	التاريخ	اختياري	للمشتقة، أول تاريخ يمكن ممارستها فيه.
`trades[].expiration_date`	التاريخ	اختياري	للمشتقة، تاريخ انتهائها.
`trades[].filing_id`	سلسلة نصية	دائمًا	معرّف الإفصاح الذي جاء منه الصف.
`trades[].form`	one of 3, 3/A, 4, 4/A, 5, 5/A	دائمًا	النموذج الذي أُبلغ عن الصف فيه: `3` أو `4` أو `5`، مع `/A` للتعديل.
`trades[].filed`	التاريخ	دائمًا	يوم تقديم الإفصاح.
`trades[].period`	التاريخ	اختياري	تاريخ الحدث الذي استوجب الإفصاح.
`trades[].owners`	قائمة كائنات	دائمًا	المالكون المُبلِّغون في الإفصاح. يُدرج الإفصاح المشترك عدة مالكين.
`trades[].owners[].cik`	سلسلة نصية	اختياري	رقم CIK لدى SEC للمالك.
`trades[].owners[].id`	سلسلة نصية	اختياري	معرّف المالك مع سجله، مثل `usa:0001780525`.
`trades[].owners[].name`	سلسلة نصية	دائمًا	اسم المالك كما ورد في الإفصاح.
`trades[].owners[].title`	سلسلة نصية	اختياري	لقب المسؤول أو علاقة أخرى، كما ورد في الإفصاح.
`trades[].owners[].director`	دائمًا true	اختياري	تكون القيمة true عندما يكون المالك عضو مجلس إدارة.
`trades[].owners[].officer`	دائمًا true	اختياري	تكون القيمة true عندما يكون المالك مسؤولًا تنفيذيًا.
`trades[].owners[].ten_percent`	دائمًا true	اختياري	تكون القيمة true عندما يملك المالك أكثر من 10% من الأسهم.
`trades[].owners[].other`	دائمًا true	اختياري	تكون القيمة true عندما تكون للمالك علاقة أخرى بالشركة.
`trades[].plan_10b5_1`	دائمًا true	اختياري	تكون القيمة true عندما يحدد النموذج خانة Rule 10b5-1.
`trades[].transaction_date`	التاريخ	اختياري	تاريخ التداول.
`trades[].code`	سلسلة نصية	اختياري	رمز معاملة SEC، مثل `P` شراء و`S` بيع و`A` منحة و`M` ممارسة خيار و`F` اقتطاع ضريبي و`G` هبة.
`trades[].acquired_disposed`	one of A, D	اختياري	`A` عندما اكتسب المالك أسهمًا و`D` عندما تصرّف فيها.
`trades[].shares`	سلسلة نصية	اختياري	عدد الأسهم في التداول.
`trades[].price`	سلسلة نصية	اختياري	سعر السهم. يُحذف عندما لا يذكر الإفصاح سعرًا.
`trades[].currency`	سلسلة نصية	اختياري	عملة الأسعار والقيم. الحذف يعني الدولار الأمريكي.
`trades[].owned_after`	سلسلة نصية	اختياري	الأسهم المملوكة بعد التداول.
`trades[].equity_swap`	دائمًا true	اختياري	تكون القيمة true عندما علّم المُبلِّغ التداول بوصفه مقايضة أسهم أو أداة مشابهة.
`trades[].amends`	سلسلة نصية	اختياري	الإفصاح الذي يحل هذا الإفصاح محله، عندما يكون تعديلًا طابق أصلًا واحدًا فقط.
`trades[].amends_unmatched`	دائمًا true	اختياري	تكون القيمة true عندما يذكر التعديل أصلًا لم نتمكن من العثور عليه.
`trades[].transaction_value`	سلسلة نصية	اختياري	`shares` مضروبًا في `price`. يُحذف ما لم يذكر الإفصاح الاثنين.
`trades[].shares_owned_before`	سلسلة نصية	اختياري	الأسهم المملوكة قبل التداول. تُعطى فقط عندما تتسلسل الأرصدة في صفوف الإفصاح لذلك المركز، كل رصيد من الذي قبله.
`trades[].deemed_execution_date`	التاريخ	اختياري	تاريخ اعتبار التداول منفذًا، عندما يذكره الإفصاح.
`trades[].timeliness`	one of E, L	اختياري	`E` عندما علّم المُبلِّغ التقرير بأنه مبكر و`L` عندما علّمه بأنه متأخر.
`trades[].not_subject_to_section_16`	دائمًا true	اختياري	تكون القيمة true عندما علّم المُبلِّغ التداول بأنه غير خاضع لـ Section 16.
`trades[].remarks`	سلسلة نصية	اختياري	ملاحظات كتبها المُبلِّغ على النموذج.
`trades[].footnotes`	list of string	دائمًا	حواشي الصف. فارغة عندما لا توجد حواشٍ.
`trades[].company_id`	سلسلة نصية	اختياري	معرّف الشركة التي جرى تداول أسهمها. يُرسل في القوائم التي لا تخص شركة واحدة.
`trades[].issuer`	سلسلة نصية	اختياري	اسم الشركة التي جرى تداول أسهمها.
`trades[].ticker`	سلسلة نصية	اختياري	رمز تداول الشركة.
`next_cursor`	سلسلة نصية	دائمًا	مرّره بوصفه cursor لقراءة الصفحة التالية. يُرسل دائمًا؛ وقيمته null في الصفحة الأخيرة.

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/insider-trades?transaction_code=P&limit=1"

{
  "trades": [
    {
      "security": "Ordinary Shares",
      "ownership": "D",
      "filing_id": "usa:0001651717:0002111999-26-000011",
      "form": "4",
      "filed": "2026-11-12",
      "period": "2026-11-09",
      "owners": [
        {
          "cik": "0002111999",
          "name": "BALDEW RUBEN",
          "title": "Chief Financial Officer",
          "director": true,
          "officer": true
        }
      ],
      "transaction_date": "2026-11-09",
      "code": "P",
      "acquired_disposed": "A",
      "shares": "8379",
      "price": "11.9538",
      "owned_after": "375551",
      "transaction_value": "100160.8902",
      "shares_owned_before": "367172",
      "footnotes": [
        "Includes 184,991 Restricted Share Units which will vest on June 17, 2027."
      ],
      "company_id": "usa:0001651717",
      "issuer": "Nomad Foods Ltd",
      "ticker": "NOMD"
    }
  ],
  "next_cursor": "eyJrIjoiNzk3Mzg4ODc5OTk3…"
}

قراءة الشراء والبيع اليوميين للمطلعين

GET /v1/insider-trades/activity

مجاميع يومية لعمليات الشراء (الرمز P) والبيع (الرمز S) في السوق المفتوحة للأسهم العادية، مجمعة حسب الشركة وتاريخ التداول.

تغطي المجاميع عمليات الشراء (الرمز P) والبيع (الرمز S) في السوق المفتوحة للأسهم العادية. تُستبعد المشتقات.

مع company_id يمكن طلب السجل كاملًا. وبدونه أرسل filed_from وfiled_to بفارق لا يزيد على 7 أيام، وتغطي المجاميع الإفصاحات المقدمة في تلك الأيام. النافذة الأطول تعطي 400 invalid_query.

purchaser_count وseller_count تحسبان الأشخاص مرة واحدة لكل إفصاح. يُحتسب المالك الأول المذكور فقط.

MCP: الأداة filings_get_insider_activity.

المعلمات

معلمة	الموضع	مطلوب	النوع	المعنى
`company_id`	استعلام	لا	سلسلة نصية	هذه الشركة فقط. ومعها يمكن طلب السجل كاملًا.
`country`	استعلام	لا	سلسلة نصية	رمز الدولة من ثلاثة أحرف للسجل. الحذف يعني USA. الدولة التي لا يغطيها المسار تُجيب 404 not_covered.
`filed_from`	استعلام	لا	التاريخ	أول يوم إفصاح، شاملًا (YYYY-MM-DD).
`filed_to`	استعلام	لا	التاريخ	آخر يوم إفصاح، شاملًا.
`transaction_date`	استعلام	لا	التاريخ	التداولات المنفذة في هذا اليوم فقط.
`transaction_date_gt`	استعلام	لا	التاريخ	التداولات المنفذة بعد هذا اليوم فقط.
`transaction_date_gte`	استعلام	لا	التاريخ	التداولات المنفذة في هذا اليوم أو بعده فقط.
`transaction_date_lt`	استعلام	لا	التاريخ	التداولات المنفذة قبل هذا اليوم فقط.
`transaction_date_lte`	استعلام	لا	التاريخ	التداولات المنفذة في هذا اليوم أو قبله فقط.
`sort`	استعلام	لا	one of transaction_date.desc, transaction_date.asc	ترتيب الأيام. الافتراضي `transaction_date.desc`.
`cursor`	استعلام	لا	سلسلة نصية	قيمة `next_cursor` من الصفحة السابقة، مع المعاملات الأخرى نفسها.
`limit`	استعلام	لا	عدد صحيح	عدد الأيام في الصفحة. الافتراضي 100 وبحد أقصى 1000.

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

حقل	النوع	يُرسل	المعنى
`days`	قائمة كائنات	دائمًا	صف لكل شركة ويوم.
`days[].company_id`	سلسلة نصية	دائمًا	معرّف الشركة.
`days[].currency`	سلسلة نصية	اختياري	عملة الأسعار والقيم. الحذف يعني الدولار الأمريكي.
`days[].issuer`	سلسلة نصية	اختياري	اسم الشركة التي جرى تداول أسهمها.
`days[].ticker`	سلسلة نصية	اختياري	رمز تداول الشركة.
`days[].transaction_date`	التاريخ	دائمًا	تاريخ التداول.
`days[].last_filing_date`	التاريخ	دائمًا	يوم أحدث إفصاح يضيف إلى مجاميع هذا اليوم.
`days[].purchase_count`	عدد صحيح	دائمًا	عدد عمليات الشراء في السوق المفتوحة.
`days[].purchase_shares`	سلسلة نصية	دائمًا	الأسهم المشتراة.
`days[].purchase_value`	سلسلة نصية	اختياري	القيمة بالدولار للمشتريات. تُحذف عندما لا يكون لأحد التداولات المجمَّعة فيها سعر.
`days[].purchaser_count`	عدد صحيح	دائمًا	من اشتروا، يُحسبون مرة واحدة لكل إفصاح.
`days[].sale_count`	عدد صحيح	دائمًا	عدد عمليات البيع في السوق المفتوحة.
`days[].sale_shares`	سلسلة نصية	دائمًا	الأسهم المباعة.
`days[].sale_value`	سلسلة نصية	اختياري	القيمة بالدولار للمبيعات. تُحذف عندما لا يكون لأحد التداولات المجمَّعة فيها سعر.
`days[].seller_count`	عدد صحيح	دائمًا	من باعوا، يُحسبون مرة واحدة لكل إفصاح.
`days[].net_shares`	سلسلة نصية	دائمًا	`purchase_shares` ناقص `sale_shares`.
`days[].net_value`	سلسلة نصية	اختياري	`purchase_value` ناقص `sale_value`.
`days[].planned_purchase_value`	سلسلة نصية	اختياري	قيمة المشتريات على النماذج التي تحدد خانة Rule 10b5-1. حد أعلى، لأن الخانة تشمل النموذج كله. تُحذف للإفصاحات قبل 1 أبريل 2023.
`days[].planned_sale_value`	سلسلة نصية	اختياري	قيمة المبيعات على النماذج التي تحدد خانة Rule 10b5-1. حد أعلى. تُحذف للإفصاحات قبل 1 أبريل 2023.
`next_cursor`	سلسلة نصية	دائمًا	مرّره بوصفه cursor لقراءة الصفحة التالية. يُرسل دائمًا؛ وقيمته null في الصفحة الأخيرة.

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/insider-trades/activity?company_id=usa:0000320193&limit=1"

{
  "days": [
    {
      "company_id": "usa:0000320193",
      "issuer": "Apple Inc.",
      "ticker": "AAPL",
      "transaction_date": "2026-11-03",
      "last_filing_date": "2026-11-05",
      "purchase_count": 0,
      "purchase_shares": "0",
      "purchase_value": "0",
      "purchaser_count": 0,
      "sale_count": 1,
      "sale_shares": "2399",
      "sale_value": "781474.25",
      "seller_count": 1,
      "net_shares": "-2399",
      "net_value": "-781474.25",
      "planned_purchase_value": "0",
      "planned_sale_value": "781474.25"
    }
  ],
  "next_cursor": "eyJrIjoiMDAwMDMyMDE5M3wy…"
}

قائمة رموز معاملات المطلعين

GET /v1/insider-trades/transaction-codes

القائمة الثابتة لرموز معاملات SEC مع معناها ومجموعتها. مجانية: لا يُحاسَب على هذا المسار.

الرموز ثابتة. استخدم هذه القائمة لقراءة code في تداول. لا تأخذ معلمات. يعرض المثال أول أربعة رموز من القائمة.

MCP: الأداة filings_list_insider_transaction_codes.

المعلمات

لا يأخذ هذا المسار أي معاملات.

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

حقل	النوع	يُرسل	المعنى
`codes`	قائمة كائنات	دائمًا	رموز المعاملات.
`codes[].code`	سلسلة نصية	دائمًا	رمز معاملة SEC من حرف واحد.
`codes[].meaning`	سلسلة نصية	دائمًا	معنى الرمز.
`codes[].group`	one of general, derivative, other	دائمًا	`general` أو `derivative` أو `other`.

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/insider-trades/transaction-codes"

{
  "codes": [
    {
      "code": "P",
      "meaning": "Open market or private purchase",
      "group": "general"
    },
    {
      "code": "S",
      "meaning": "Open market or private sale",
      "group": "general"
    },
    {
      "code": "V",
      "meaning": "Transaction voluntarily reported earlier than required",
      "group": "general"
    },
    {
      "code": "A",
      "meaning": "Grant, award or other acquisition",
      "group": "general"
    }
  ]
}

الأخطاء

تستخدم الأخطاء بنية المشكلة المشتركة مع: request_id. راجع أخطاء API والرصيد لمعرفة الشكل وترويسات الرصيد. لا تُحاسَب الطلبات الفاشلة.

الرمز	الحالة	المعنى
`invalid_query`	400	معامل مفقود أو غير معروف أو مكرر أو خارج نطاقه.
`invalid_cursor`	400	مؤشر الصفحة هذا لم يُعده هذا الطلب، أو أنه من طلب مختلف.
`company_not_found`	404	لا شركة تطابق المعرّف.
`not_covered`	404	السوق أو البلد أو الشركة غير مغطى بعد.
`insufficient_credits`	402	رصيدك أقل من تكلفة الطلب.
`company_data_unavailable`	503	تعذّرت قراءة الإفصاحات وراء هذا المسار الآن. حاول مرة أخرى بعد قليل.

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