معاملات المطلعين

يُرجِع بيانات الصفقات الداخلية من نماذج SEC Form 4 المُقدَّمة. استخدِم المسار /filings لعرض الإيداعات بشكل مُجمَّع (الصفقات متداخلة تحت كل إيداع)، أو المسار /transactions لعرض كل صفقة بشكل منفصل (مُسطَّح). كلا المسارين يدعمان معاملات الاستعلام نفسها.

GET /api/v1/sec/insider_transactions/{view_type}

الصفقات الداخلية

cURL

curl --request GET \
  --url 'https://api.benzinga.com/api/v1/sec/insider_transactions/{view_type}?token='

استجابة (200 OK)

{
  "data": [
    {
      "accession_number": "0000905729-26-000009",
      "company_cik": "0000803164",
      "company_name": "CHOICEONE FINANCIAL SERVICES INC",
      "company_symbol": "COFS",
      "filing_date": "2026-01-05T19:54:05Z",
      "footnotes": null,
      "form_type": "4",
      "html_url": "https://www.sec.gov/Archives/edgar/data/0000803164/000090572926000009//Archives/edgar/data/803164/000090572926000009/0000905729-26-000009-index.htm",
      "id": "695c171b1bd4be0001967659",
      "is_10b5": false,
      "owner": {
        "insider_cik": "0001788991",
        "insider_name": "Gregory McConnell",
        "insider_title": "",
        "is_director": true,
        "is_officer": false,
        "is_ten_percent_owner": false,
        "raw_signature": "/s/ Sarah A. Harper, by Power of Attorney"
      },
      "remaining_shares": "34400",
      "traded_percentage": "0.68%",
      "transactions": [
        {
          "acquired_or_disposed": "A",
          "conversion_exercise_price_derivative": "",
          "date_deemed_execution": null,
          "date_exercisable": null,
          "date_expiration": null,
          "date_transaction": "2026-01-01T00:00:00Z",
          "is_derivative": false,
          "ownership": "d",
          "post_transaction_quantity": "34400",
          "price_per_share": "29.52",
          "remaining_underlying_shares": "",
          "security_title": "Common Stock",
          "shares": "233",
          "transaction_code": "a",
          "transaction_id": "0000803164_0000905729-26-000009_nd_t_0",
          "underlying_security_title": "",
          "underlying_shares": "",
          "voluntarily_reported": false
        }
      ],
      "updated": 1767642907
    }
  ]
}

استجابة (200 OK)

{
  "data": [
    {
      "accession_number": "0000905729-26-000009",
      "company_cik": "0000803164",
      "company_name": "CHOICEONE FINANCIAL SERVICES INC",
      "company_symbol": "COFS",
      "filing_date": "2026-01-05T19:54:05Z",
      "footnotes": null,
      "form_type": "4",
      "html_url": "https://www.sec.gov/Archives/edgar/data/0000803164/000090572926000009//Archives/edgar/data/803164/000090572926000009/0000905729-26-000009-index.htm",
      "id": "695c171b1bd4be0001967659",
      "is_10b5": false,
      "owner": {
        "insider_cik": "0001788991",
        "insider_name": "Gregory McConnell",
        "insider_title": "",
        "is_director": true,
        "is_officer": false,
        "is_ten_percent_owner": false,
        "raw_signature": "/s/ Sarah A. Harper, by Power of Attorney"
      },
      "remaining_shares": "34400",
      "traded_percentage": "0.68%",
      "transactions": [
        {
          "acquired_or_disposed": "A",
          "conversion_exercise_price_derivative": "",
          "date_deemed_execution": null,
          "date_exercisable": null,
          "date_expiration": null,
          "date_transaction": "2026-01-01T00:00:00Z",
          "is_derivative": false,
          "ownership": "d",
          "post_transaction_quantity": "34400",
          "price_per_share": "29.52",
          "remaining_underlying_shares": "",
          "security_title": "Common Stock",
          "shares": "233",
          "transaction_code": "a",
          "transaction_id": "0000803164_0000905729-26-000009_nd_t_0",
          "underlying_security_title": "",
          "underlying_shares": "",
          "voluntarily_reported": false
        }
      ],
      "updated": 1767642907
    }
  ]
}

التفويضات

token · string · query · مطلوب

معلمات المسار

view_type · enum<string> · مطلوب

صيغة الاستجابة: تعيد القيمة «filings» عرضًا مجمّعًا لملفات الإيداع مع تضمين المعاملات، بينما تعيد القيمة «transactions» عرضًا مسطَّحًا لكل معاملة منفردة

الخيارات المتاحة: filings, transactions

معلمات الاستعلام

page · integer · افتراضي: 0

إزاحة الصفحة (page offset). لأسباب متعلقة بتحسين الأداء والاعتبارات التقنية، يتم تقييد قيمة إزاحة الصفحة بين 0 و100000. حدِّد نطاق نتائج الاستعلام باستخدام معاملات أخرى مثل التاريخ. القيمة الافتراضية هي 0.

pagesize · integer · افتراضي: 100

عدد النتائج المُرجَعة. الحد الأقصى 1000.

date_from · string<date>

تاريخ البدء بصيغة YYYY-MM-DD

date_to · string<date>

تاريخ الانتهاء بصيغة YYYY-MM-DD

updated_since · integer

الطابع الزمني Unix (بتوقيت UTC) لآخر وقت كانت فيه السجلات محدَّثة. سيجبر هذا ترتيب الفرز على أن يكون أكبر من أو مساويًا للطابع الزمني المحدَّد

date · string<date>

تاريخ بصيغة YYYY-MM-DD

chamber · enum<string>

الغرفة

الخيارات المتاحة: House, Senate

fields · string

الحقول

search_keys_type · enum<string>

نوع مفاتيح البحث

الخيارات المتاحة: symbol, accession_number, cik, id

search_keys · string

مفاتيح البحث

display · enum<string>

نوع العرض

الخيارات المتاحة: flat, nested

الاستجابة

200

application/json

بيانات معاملات المطلعين. تختلف بنية الاستجابة باختلاف نقطة النهاية: تُرجِع ‏/filings بيانات ملفات متداخلة، بينما تُرجِع ‏/transactions بيانات معاملات مسطّحة

data · object[]

إظهار السمات الفرعية