Felo API PlatformFelo API Platform
جميع endpoints الخاصة بـ Financial Data
v0.2.0-beta
OpenAPI 3.1.0

الحصول على تداولات المطلعين

الخادم:https://openapi.felo.ai
مكتبات العملاء

Financial Data

​

Company fundamentals, financial statements, market prices and economic data.

Financial Data العمليات

الحصول على تداولات المطلعين

​

استرجع تداولات المطلعين لرمز ticker، مستخدمًا limit لتقييد عدد النتائج المطلوبة. لا يعلن هذا العقد مرشّحات اسم الشخص أو نوع المعاملة أو تاريخ الإفصاح.

مرجع التسعير

  • القياس: أساس تكلفة ثابت لكل طلب ناجح.
  • تقدير الطلب المرجعي: 0.02 دولار أمريكي.
  • مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.

بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.

معاملات الاستعلام
  • limit
    النوع: string
  • ticker
    النوع: string
الاستجابات
  • 200
    النوع: object · ResponseE40Feb4D3D6B_InsiderTradesResponse

    استجابة تداولات المطلعين

    • insider_trades
      النوع: array object[] · ResponseE40Feb4D3D6B_InsiderTrade[]
      • filing_date
        النوع: string التنسيق: date

        تاريخ قبول SEC للإيداع.

      • form_type
        النوع: string

        نوع نموذج SEC: 4 (تقرير تداول) أو 5 (بيان سنوي)، أو تعديلاتهما 4/A و5/A.

      • is_board_director
        النوع: boolean

        ما إذا كان المطلع عضو مجلس إدارة.

      • issuer
        النوع: string

        اسم الشركة المصدرة.

      • name
        النوع: string

        اسم المطلع.

      • report_period
        النوع: string التنسيق: date

        فترة التقارير المعلنة في الإيداع. بالنسبة للنموذج 4، هذا هو تاريخ أقرب معاملة مُبلَّغ عنها، وقد يكون أسبق من filing_date.

      • security_title
        النوع: string

        اسم الورقة المالية المتضمنة في المعاملة.

      • shares_owned_after_transaction
        النوع: number

        عدد الأسهم المملوكة بعد المعاملة.

      • shares_owned_before_transaction
        النوع: number

        عدد الأسهم المملوكة قبل المعاملة.

      • ticker
        النوع: string

        رمز سهم الشركة.

      • title
        النوع: string

        المسمى الوظيفي للمطلع.

      • transaction_code
        النوع: string

        رمز المعاملة في نموذج SEC 4 (مثل P للشراء في السوق المفتوح، وS للبيع في السوق المفتوح، وM لممارسة الأوراق المالية المشتقة، وF للأسهم المحتجزة لتغطية الضرائب، وG للهدية). يميّز الأجزاء الفردية لإيداع متعدد الأجزاء.

      • transaction_date
        النوع: string التنسيق: date

        تاريخ المعاملة.

      • transaction_price_per_share
        النوع: number

        السعر لكل سهم في المعاملة.

      • transaction_shares
        النوع: number

        عدد الأسهم المتضمنة في المعاملة.

      • transaction_type
        النوع: string

        وصف مقروء للمعاملة، مشتق من transaction_code.

      • transaction_value
        النوع: number

        القيمة الإجمالية للمعاملة.

    • next_page_url
      النوع: string

      عنوان URL المطلق للصفحة التالية من النتائج. موجود فقط عندما تبقى نتائج إضافية؛ اطلبه كما هو للمتابعة. تستوعب كل صفحة حتى 10 سجلات.

    application/json
  • 400

    تعذّرت معالجة الطلب. تحقق من معاملات الطلب.

  • 401

    مطلوب مفتاح API صالح من Felo.

  • 402

    لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.

  • 403

    الحساب غير مصرّح له بهذه العملية.

  • 429

    تم بلوغ حد الطلبات أو حد الإنفاق.

  • 502

    تعذّر على الخدمة إكمال الطلب.

  • 503

    خدمة API أو الفوترة غير متاحة مؤقتًا.

  • 504

    انتهت مهلة الخدمة أثناء معالجة الطلب.

  • default

    استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد

    application/json
Request Example for get/v1/beta/financial/insider-trades
curl https://openapi.felo.ai/v1/beta/financial/insider-trades \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "insider_trades": [
    {
      "ticker": "string",
      "issuer": "string",
      "name": "string",
      "title": "string",
      "is_board_director": true,
      "form_type": "string",
      "filing_date": "2026-10-26",
      "report_period": "2026-10-26",
      "transaction_date": "2026-10-26",
      "transaction_code": "string",
      "transaction_type": "string",
      "transaction_shares": 1,
      "transaction_price_per_share": 1,
      "transaction_value": 1,
      "shares_owned_before_transaction": 1,
      "shares_owned_after_transaction": 1,
      "security_title": "string"
    }
  ],
  "next_page_url": "string"
}
Get insider trades