Felo API PlatformFelo API Platform
همه endpointهای 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