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 العمليات

الحصول على لقطة الأرباح

​

أرباح مُبلَّغ عنها لسهم واحد، الفعلي مقابل التقديرات. يحمل كل إدخال report_period وfiscal_period وfiling_date وfiling_url وaccession_number، وكتلة quarterly تضم revenue وestimated_revenue وrevenue_surprise وrevenue_surprise_pct، والثلاثي نفسه لـ earnings_per_share، إضافةً إلى حقول التغير السنوي. يعيد أيضًا signals: إشارات محسوبة في المنبع مثل EPS_BEAT مع headline وما يقف خلفها من actual / estimate / surprise_pct. ticker مطلوب وهو المعامل الوحيد. استخدمه لما أبلغت عنه الشركة فعليًا. وللتوافق المستقبلي الذي لم يحدث بعد استخدم get_financial_analyst_estimates.

مرجع التسعير

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

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

معاملات الاستعلام
  • cursor
    النوع: string

    مؤشر ترقيم صفحات معتم من next_page_url في استجابة سابقة. عند توفيره، تُتجاهل جميع معاملات الاستعلام الأخرى: يحمل المؤشر مرشّحات الطلب الأصلي. تعامل معه كقيمة معتمة؛ لا تنشئه أو تعدّله.

  • limit
    النوع: integer
    الحد الأدنى:  
    1
    الحد الأقصى:  
    40

    عدد فترات التقارير الأحدث التي تُعاد إيداعاتها، مرتّبة حسب (report_period DESC, filing_date ASC). قد يتجاوز عدد الإدخالات المعادة limit عندما تحتوي فترة حديثة على 8-K و10-Q / 10-K معًا. تُقيَّد القيم الأعلى من 40 عند 40. القيم غير الموجبة أو غير الصحيحة تُعيد 400. هذا إجمالي عبر جميع الصفحات وليس حجم صفحة: تستوعب كل صفحة حتى 10 سجلات، مرتبطة بـnext_page_url.

  • ticker
    النوع: string
    مطلوب

    رمز السهم (مثل AAPL).

الاستجابات
  • 200
    النوع: object · ResponseE40Feb4D3D6B_EarningsResponse

    استجابة الأرباح

    • earnings
      النوع: array object[] · ResponseE40Feb4D3D6B_EarningsRecord[]

      قائمة مسطحة بإفصاحات SEC للسهم، مرتبة حسب (report_period DESC, filing_date ASC). عند limit=N، تُعاد إفصاحات بما يصل إلى N من فترات report_period؛ وقد يتجاوز عدد الإدخالات N عندما تكون لفترة حديثة إفصاحا 8-K و10-Q/10-K معًا.

      • accession_number
        النوع: string
        مطلوب

        رقم الانضمام لدى SEC الذي يحدد الإيداع.

      • filing_date
        النوع: string التنسيق: date
        مطلوب

        اليوم التقويمي الذي قبلت فيه SEC الإيداع، بالتوقيت الشرقي (المنطقة الزمنية التشغيلية لـ SEC). يقترن باليوم التقويمي لـ filing_datetime.

      • filing_url
        النوع: string التنسيق: uri
        مطلوب

        عنوان URL لإيداع SEC.

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

        فترة التقرير التي يغطيها هذا الإيداع.

      • source_type
        النوع: string تعداد
        مطلوب

        نوع نموذج SEC الذي يستند إليه هذا الإيداع.

        القيم
        • 8-K
        • 10-Q
        • 10-K
        • 20-F
      • ticker
        النوع: string
        مطلوب

        رمز السهم المطلوب.

      • annual
        النوع: object · ResponseE40Feb4D3D6B_EarningsTimeDimension
        • capital_expenditure
          النوع: number | null
        • capital_expenditure_chg
          النوع: number

          نسبة التغير في النفقات الرأسمالية مقارنةً بالفترة السابقة كرقم عشري. تسلسلي في الحمولة الربع سنوية، وسنوي في الحمولة السنوية. يُعاد فقط عندما يكون قابلًا للحساب.

        • capital_expenditure_yoy_chg
          النوع: number

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

        • cash_and_equivalents
          النوع: number | null
        • change_in_cash_and_equivalents
          النوع: number | null
        • earnings_per_share
          النوع: number | null
        • earnings_per_share_chg
          النوع: number

          نسبة التغير في ربحية السهم (EPS) مقارنةً بالفترة السابقة كرقم عشري. تسلسلي في الحمولة الربع سنوية، وسنوي في الحمولة السنوية. يُعاد فقط عندما يكون قابلًا للحساب.

        • earnings_per_share_yoy_chg
          النوع: number

          التغير السنوي في ربحية السهم (EPS) مقارنةً بالربع المالي نفسه قبل سنة، كرقم عشري. للحمولة الربع سنوية فقط. يُعاد فقط عندما يكون قابلًا للحساب.

        • free_cash_flow
          النوع: number | null
        • free_cash_flow_chg
          النوع: number

          نسبة التغير في التدفق النقدي الحر مقارنةً بالفترة السابقة كرقم عشري. تسلسلي في الحمولة الربع سنوية، وسنوي في الحمولة السنوية. يُعاد فقط عندما يكون قابلًا للحساب.

        • free_cash_flow_yoy_chg
          النوع: number

          التغير السنوي في التدفق النقدي الحر مقارنةً بالربع المالي نفسه قبل سنة، كرقم عشري. للحمولة الربع سنوية فقط. يُعاد فقط عندما يكون قابلًا للحساب.

        • gross_margin
          النوع: number

          هامش الربح الإجمالي كرقم عشري (gross_profit / revenue). يُعاد فقط عندما يكون قابلًا للحساب.

        • gross_margin_chg_bps
          النوع: number

          التغير المطلق في هامش الربح الإجمالي مقارنةً بالفترة السابقة بنقاط الأساس (مثل 200.0 = توسّع الهامش 200 bps). يُعاد فقط عندما يكون قابلًا للحساب.

        • gross_margin_chg_pct
          النوع: number

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

        • gross_margin_yoy_chg_bps
          النوع: number

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

        • gross_margin_yoy_chg_pct
          النوع: number

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

        • gross_profit
          النوع: number | null
        • gross_profit_chg
          النوع: number

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

        • gross_profit_yoy_chg
          النوع: number

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

        • net_cash_flow_from_financing
          النوع: number | null
        • net_cash_flow_from_financing_chg
          النوع: number

          نسبة التغير في صافي التدفق النقدي من التمويل مقارنةً بالفترة السابقة كرقم عشري. تسلسلي في الحمولة الربع سنوية، وسنوي في الحمولة السنوية. يُعاد فقط عندما يكون قابلًا للحساب.

        • net_cash_flow_from_financing_yoy_chg
          النوع: number

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

        • net_cash_flow_from_investing
          النوع: number | null
        • net_cash_flow_from_investing_chg
          النوع: number

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

        • net_cash_flow_from_investing_yoy_chg
          النوع: number

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

        • net_cash_flow_from_operations
          النوع: number | null
        • net_cash_flow_from_operations_chg
          النوع: number

          نسبة التغير في صافي التدفق النقدي من التشغيل مقارنةً بالفترة السابقة كرقم عشري. تسلسلي في الحمولة الربع سنوية، وسنوي في الحمولة السنوية. يُعاد فقط عندما يكون قابلًا للحساب.

        • net_cash_flow_from_operations_yoy_chg
          النوع: number

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

        • net_income
          النوع: number | null
        • net_income_chg
          النوع: number

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

        • net_income_yoy_chg
          النوع: number

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

        • net_margin
          النوع: number

          هامش الربح الصافي كرقم عشري (net_income / revenue). يُعاد فقط عندما يكون قابلًا للحساب.

        • net_margin_chg_bps
          النوع: number

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

        • net_margin_chg_pct
          النوع: number

          نسبة التغير في هامش الربح الصافي مقارنةً بالفترة السابقة كرقم عشري. يُعاد فقط عندما يكون قابلًا للحساب.

        • net_margin_yoy_chg_bps
          النوع: number

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

        • net_margin_yoy_chg_pct
          النوع: number

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

        • operating_income
          النوع: number | null
        • operating_income_chg
          النوع: number

          نسبة التغير في الدخل التشغيلي مقارنةً بالفترة السابقة كرقم عشري. تسلسلي في الحمولة الربع سنوية، وسنوي في الحمولة السنوية. يُعاد فقط عندما يكون قابلًا للحساب.

        • operating_income_yoy_chg
          النوع: number

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

        • operating_margin
          النوع: number

          هامش الربح التشغيلي كرقم عشري (operating_income / revenue). يُعاد فقط عندما يكون قابلًا للحساب.

        • operating_margin_chg_bps
          النوع: number

          التغير المطلق في هامش الربح التشغيلي مقارنةً بالفترة السابقة بنقاط الأساس. يُعاد فقط عندما يكون قابلًا للحساب.

        • operating_margin_chg_pct
          النوع: number

          نسبة التغير في هامش الربح التشغيلي مقارنةً بالفترة السابقة كرقم عشري. يُعاد فقط عندما يكون قابلًا للحساب.

        • operating_margin_yoy_chg_bps
          النوع: number

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

        • operating_margin_yoy_chg_pct
          النوع: number

          نسبة التغير السنوي في هامش الربح التشغيلي مقارنةً بالربع المالي نفسه قبل سنة، كرقم عشري. للحمولة الربع سنوية فقط. يُعاد فقط عندما يكون قابلًا للحساب.

        • revenue
          النوع: number | null
        • revenue_chg
          النوع: number

          نسبة التغير في الإيرادات مقارنةً بالفترة السابقة كرقم عشري (مثل 0.10 = +10%). تسلسلي في الحمولة الربع سنوية، وسنوي في الحمولة السنوية. يُعاد فقط عندما يكون قابلًا للحساب.

        • revenue_yoy_chg
          النوع: number

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

        • shareholders_equity
          النوع: number | null
        • total_assets
          النوع: number | null
        • total_debt
          النوع: number | null
        • total_liabilities
          النوع: number | null
        • weighted_average_shares
          النوع: number | null
        • weighted_average_shares_diluted
          النوع: number | null
      • currency
        النوع: string

        رمز العملة ISO (مثل USD).

      • filing_datetime
        النوع: string | null التنسيق: date-time

        طابع زمني دون اليوم يسجّل وقت قبول SEC للإيداع، بالتوقيت الشرقي. مأخوذ من حقل acceptanceDateTime لدى SEC في واجهة EDGAR submissions API. يقترن بـ filing_date (دقة اليوم التقويمي للحدث نفسه).

      • filing_window
        النوع: string | null تعداد

        جلسة السوق لحظة قبول SEC للإيداع، محسوبة بالتوقيت الشرقي. PRE_MARKET = يوم من أيام الأسبوع 04:00–09:30 ET. DURING_MARKET = يوم من أيام الأسبوع 09:30–16:00 ET. AFTER_HOURS = يوم من أيام الأسبوع خارج ساعات التداول العادية. WEEKEND = السبت أو الأحد. Null عندما يكون filing_datetime غير متاح.

        القيم
        • PRE_MARKET
        • DURING_MARKET
        • AFTER_HOURS
        • WEEKEND
      • fiscal_period
        النوع: string

        تسمية الفترة المالية (مثل 2026-Q1 أو 2025-FY).

      • quarterly
        النوع: object · ResponseE40Feb4D3D6B_EarningsTimeDimension
        • capital_expenditure
          النوع: number | null
        • capital_expenditure_chg
          النوع: number

          نسبة التغير في النفقات الرأسمالية مقارنةً بالفترة السابقة كرقم عشري. تسلسلي في الحمولة الربع سنوية، وسنوي في الحمولة السنوية. يُعاد فقط عندما يكون قابلًا للحساب.

        • capital_expenditure_yoy_chg
          النوع: number

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

        • cash_and_equivalents
          النوع: number | null
        • change_in_cash_and_equivalents
          النوع: number | null
        • earnings_per_share
          النوع: number | null
        • earnings_per_share_chg
          النوع: number

          نسبة التغير في ربحية السهم (EPS) مقارنةً بالفترة السابقة كرقم عشري. تسلسلي في الحمولة الربع سنوية، وسنوي في الحمولة السنوية. يُعاد فقط عندما يكون قابلًا للحساب.

        • earnings_per_share_yoy_chg
          النوع: number

          التغير السنوي في ربحية السهم (EPS) مقارنةً بالربع المالي نفسه قبل سنة، كرقم عشري. للحمولة الربع سنوية فقط. يُعاد فقط عندما يكون قابلًا للحساب.

        • free_cash_flow
          النوع: number | null
        • free_cash_flow_chg
          النوع: number

          نسبة التغير في التدفق النقدي الحر مقارنةً بالفترة السابقة كرقم عشري. تسلسلي في الحمولة الربع سنوية، وسنوي في الحمولة السنوية. يُعاد فقط عندما يكون قابلًا للحساب.

        • free_cash_flow_yoy_chg
          النوع: number

          التغير السنوي في التدفق النقدي الحر مقارنةً بالربع المالي نفسه قبل سنة، كرقم عشري. للحمولة الربع سنوية فقط. يُعاد فقط عندما يكون قابلًا للحساب.

        • gross_margin
          النوع: number

          هامش الربح الإجمالي كرقم عشري (gross_profit / revenue). يُعاد فقط عندما يكون قابلًا للحساب.

        • gross_margin_chg_bps
          النوع: number

          التغير المطلق في هامش الربح الإجمالي مقارنةً بالفترة السابقة بنقاط الأساس (مثل 200.0 = توسّع الهامش 200 bps). يُعاد فقط عندما يكون قابلًا للحساب.

        • gross_margin_chg_pct
          النوع: number

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

        • gross_margin_yoy_chg_bps
          النوع: number

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

        • gross_margin_yoy_chg_pct
          النوع: number

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

        • gross_profit
          النوع: number | null
        • gross_profit_chg
          النوع: number

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

        • gross_profit_yoy_chg
          النوع: number

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

        • net_cash_flow_from_financing
          النوع: number | null
        • net_cash_flow_from_financing_chg
          النوع: number

          نسبة التغير في صافي التدفق النقدي من التمويل مقارنةً بالفترة السابقة كرقم عشري. تسلسلي في الحمولة الربع سنوية، وسنوي في الحمولة السنوية. يُعاد فقط عندما يكون قابلًا للحساب.

        • net_cash_flow_from_financing_yoy_chg
          النوع: number

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

        • net_cash_flow_from_investing
          النوع: number | null
        • net_cash_flow_from_investing_chg
          النوع: number

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

        • net_cash_flow_from_investing_yoy_chg
          النوع: number

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

        • net_cash_flow_from_operations
          النوع: number | null
        • net_cash_flow_from_operations_chg
          النوع: number

          نسبة التغير في صافي التدفق النقدي من التشغيل مقارنةً بالفترة السابقة كرقم عشري. تسلسلي في الحمولة الربع سنوية، وسنوي في الحمولة السنوية. يُعاد فقط عندما يكون قابلًا للحساب.

        • net_cash_flow_from_operations_yoy_chg
          النوع: number

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

        • net_income
          النوع: number | null
        • net_income_chg
          النوع: number

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

        • net_income_yoy_chg
          النوع: number

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

        • net_margin
          النوع: number

          هامش الربح الصافي كرقم عشري (net_income / revenue). يُعاد فقط عندما يكون قابلًا للحساب.

        • net_margin_chg_bps
          النوع: number

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

        • net_margin_chg_pct
          النوع: number

          نسبة التغير في هامش الربح الصافي مقارنةً بالفترة السابقة كرقم عشري. يُعاد فقط عندما يكون قابلًا للحساب.

        • net_margin_yoy_chg_bps
          النوع: number

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

        • net_margin_yoy_chg_pct
          النوع: number

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

        • operating_income
          النوع: number | null
        • operating_income_chg
          النوع: number

          نسبة التغير في الدخل التشغيلي مقارنةً بالفترة السابقة كرقم عشري. تسلسلي في الحمولة الربع سنوية، وسنوي في الحمولة السنوية. يُعاد فقط عندما يكون قابلًا للحساب.

        • operating_income_yoy_chg
          النوع: number

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

        • operating_margin
          النوع: number

          هامش الربح التشغيلي كرقم عشري (operating_income / revenue). يُعاد فقط عندما يكون قابلًا للحساب.

        • operating_margin_chg_bps
          النوع: number

          التغير المطلق في هامش الربح التشغيلي مقارنةً بالفترة السابقة بنقاط الأساس. يُعاد فقط عندما يكون قابلًا للحساب.

        • operating_margin_chg_pct
          النوع: number

          نسبة التغير في هامش الربح التشغيلي مقارنةً بالفترة السابقة كرقم عشري. يُعاد فقط عندما يكون قابلًا للحساب.

        • operating_margin_yoy_chg_bps
          النوع: number

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

        • operating_margin_yoy_chg_pct
          النوع: number

          نسبة التغير السنوي في هامش الربح التشغيلي مقارنةً بالربع المالي نفسه قبل سنة، كرقم عشري. للحمولة الربع سنوية فقط. يُعاد فقط عندما يكون قابلًا للحساب.

        • revenue
          النوع: number | null
        • revenue_chg
          النوع: number

          نسبة التغير في الإيرادات مقارنةً بالفترة السابقة كرقم عشري (مثل 0.10 = +10%). تسلسلي في الحمولة الربع سنوية، وسنوي في الحمولة السنوية. يُعاد فقط عندما يكون قابلًا للحساب.

        • revenue_yoy_chg
          النوع: number

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

        • shareholders_equity
          النوع: number | null
        • total_assets
          النوع: number | null
        • total_debt
          النوع: number | null
        • total_liabilities
          النوع: number | null
        • weighted_average_shares
          النوع: number | null
        • weighted_average_shares_diluted
          النوع: number | null
      • signals
        النوع: array object[] · ResponseE40Feb4D3D6B_Signal[]

        رؤى منسّقة محرّكة للسوق مستخلصة من هذا الإيداع. لكل عنصر headline معد مسبقًا، وdetails منظمة، وترتيب importance. يُعاد فقط عندما تنطلق إشارة واحدة على الأقل لهذا الإدخال؛ ويُحذف الحقل بخلاف ذلك. بحد أقصى 8 لكل إدخال، مرتبة HIGH → MEDIUM → LOW.

        رؤية منسّقة محرّكة للسوق مستخلصة من هذا الإيداع. headline المعد مسبقًا صالح للعرض المباشر؛ ويحمل details حقولًا منظمة للتصفية والاستخدام البرمجي. تُعاد الإشارات بترتيب الأولوية (الأكثر مادية أولًا)؛ ويشفّر type نفسه الحجم (مثل STRONG_REVENUE_INCREASE مقابل REVENUE_INCREASE).

        • headline
          النوع: string
          مطلوب

          ملخص معد مسبقًا ومقروء، صالح للعرض المباشر.

        • type
          النوع: string تعداد
          مطلوب

          فئة الإشارة. MARGIN_EXPANSION/MARGIN_CONTRACTION: تحرك أي من هوامش الربح الإجمالي/التشغيلي/الصافي سنة بعد سنة بمقدار ≥100bps. GUIDANCE_RAISED/GUIDANCE_LOWERED/GUIDANCE_REAFFIRMED/GUIDANCE_INITIATED: تغيير في التوجيهات المستقبلية مُبلَّغ عنه في الإيداع. SEGMENT_OUTPERFORMANCE/SEGMENT_UNDERPERFORMANCE: القطاع القابل للتقرير الأفضل أو الأسوأ أداءً من حيث نمو الإيرادات العضوية. NON_GAAP_DIVERGENCE: رقم معدّل/non-GAAP يختلف جوهريًا عن نظيره GAAP في الفترة نفسها. BACKLOG_SURGE/BACKLOG_DECLINE: تحرك الأعمال المتراكمة أو التزامات الأداء المتبقية سنة بعد سنة بمقدار ≥20%. REVENUE_INCREASE/STRONG_REVENUE_INCREASE ومتغيرات DECLINE: تغيّر متدرج في الإيرادات سنة بعد سنة (≥10% / ≥20% من حيث الحجم). NET_INCOME_INCREASE/STRONG_NET_INCOME_INCREASE ومتغيرات DECLINE: تغيّر متدرج في صافي الدخل سنة بعد سنة (≥15% / ≥30%). EPS_INCREASE/STRONG_EPS_INCREASE ومتغيرات DECLINE: تغيّر متدرج في ربحية السهم سنة بعد سنة (≥15% / ≥30%)؛ مستقل عن صافي الدخل لأن إعادة شراء الأسهم قد تضخم حركة ربحية السهم. CAPEX_INCREASE/STRONG_CAPEX_INCREASE ومتغيرات DECLINE: تغيّر متدرج في النفقات الرأسمالية سنة بعد سنة من حيث حجم الإنفاق (≥15% / ≥30%).

          القيم
          • MARGIN_EXPANSION
          • MARGIN_CONTRACTION
          • GUIDANCE_RAISED
          • GUIDANCE_LOWERED
          • GUIDANCE_REAFFIRMED
        • details
          النوع: object

          حقول منظمة خاصة بنوع الإشارة. يختلف المحتوى: إشارات التوجيه تحمل low وhigh وpoint_estimate وprior_value وrevision_pct؛ وإشارات القطاعات تحمل best وworst وspread_pp؛ وإشارات non-GAAP تحمل gaap_field وnon_gaap_value وgaap_value وdivergence_pct؛ وإشارات النمو تحمل current وyoy_chg. تُحذف القيم Null. راجع الأمثلة الخاصة بكل نوع.

          • propertyName
            النوع: anything
        • metric
          النوع: string | null

          المقياس الذي تشير إليه هذه الإشارة، عند الانطباق (مثل revenue أو earnings_per_share أو operating_margin، أو اسم مقياس توجيه/KPI).

        • period
          النوع: string | null

          الفترة المالية التي تشير إليها الإشارة (مثل 2026-Q1 وFY 2026). تشير إشارات التوجيه المستقبلي إلى الفترة الموجَّهة؛ وتشير الإشارات المالية إلى فترة التقارير لهذا الإيداع.

    • 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/earnings
curl 'https://openapi.felo.ai/v1/beta/financial/earnings?ticker=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "earnings": [
    {
      "ticker": "string",
      "report_period": "2026-10-26",
      "fiscal_period": "string",
      "currency": "string",
      "source_type": "8-K",
      "filing_date": "2026-10-26",
      "filing_datetime": null,
      "filing_window": "PRE_MARKET",
      "signals": [
        {
          "type": "MARGIN_EXPANSION",
          "metric": null,
          "period": null,
          "headline": "string",
          "details": {
            "additionalProperty": "anything"
          }
        }
      ],
      "filing_url": "https://example.com",
      "accession_number": "string",
      "quarterly": {
        "revenue": null,
        "revenue_chg": 1,
        "revenue_yoy_chg": 1,
        "earnings_per_share": null,
        "earnings_per_share_chg": 1,
        "earnings_per_share_yoy_chg": 1,
        "gross_profit": null,
        "gross_profit_chg": 1,
        "gross_profit_yoy_chg": 1,
        "gross_margin": 1,
        "gross_margin_chg_bps": 1,
        "gross_margin_chg_pct": 1,
        "gross_margin_yoy_chg_bps": 1,
        "gross_margin_yoy_chg_pct": 1,
        "operating_income": null,
        "operating_income_chg": 1,
        "operating_income_yoy_chg": 1,
        "operating_margin": 1,
        "operating_margin_chg_bps": 1,
        "operating_margin_chg_pct": 1,
        "operating_margin_yoy_chg_bps": 1,
        "operating_margin_yoy_chg_pct": 1,
        "net_income": null,
        "net_income_chg": 1,
        "net_income_yoy_chg": 1,
        "net_margin": 1,
        "net_margin_chg_bps": 1,
        "net_margin_chg_pct": 1,
        "net_margin_yoy_chg_bps": 1,
        "net_margin_yoy_chg_pct": 1,
        "weighted_average_shares": null,
        "weighted_average_shares_diluted": null,
        "cash_and_equivalents": null,
        "change_in_cash_and_equivalents": null,
        "total_debt": null,
        "total_assets": null,
        "total_liabilities": null,
        "shareholders_equity": null,
        "net_cash_flow_from_operations": null,
        "net_cash_flow_from_operations_chg": 1,
        "net_cash_flow_from_operations_yoy_chg": 1,
        "net_cash_flow_from_investing": null,
        "net_cash_flow_from_investing_chg": 1,
        "net_cash_flow_from_investing_yoy_chg": 1,
        "net_cash_flow_from_financing": null,
        "net_cash_flow_from_financing_chg": 1,
        "net_cash_flow_from_financing_yoy_chg": 1,
        "capital_expenditure": null,
        "capital_expenditure_chg": 1,
        "capital_expenditure_yoy_chg": 1,
        "free_cash_flow": null,
        "free_cash_flow_chg": 1,
        "free_cash_flow_yoy_chg": 1
      },
      "annual": {
        "revenue": null,
        "revenue_chg": 1,
        "revenue_yoy_chg": 1,
        "earnings_per_share": null,
        "earnings_per_share_chg": 1,
        "earnings_per_share_yoy_chg": 1,
        "gross_profit": null,
        "gross_profit_chg": 1,
        "gross_profit_yoy_chg": 1,
        "gross_margin": 1,
        "gross_margin_chg_bps": 1,
        "gross_margin_chg_pct": 1,
        "gross_margin_yoy_chg_bps": 1,
        "gross_margin_yoy_chg_pct": 1,
        "operating_income": null,
        "operating_income_chg": 1,
        "operating_income_yoy_chg": 1,
        "operating_margin": 1,
        "operating_margin_chg_bps": 1,
        "operating_margin_chg_pct": 1,
        "operating_margin_yoy_chg_bps": 1,
        "operating_margin_yoy_chg_pct": 1,
        "net_income": null,
        "net_income_chg": 1,
        "net_income_yoy_chg": 1,
        "net_margin": 1,
        "net_margin_chg_bps": 1,
        "net_margin_chg_pct": 1,
        "net_margin_yoy_chg_bps": 1,
        "net_margin_yoy_chg_pct": 1,
        "weighted_average_shares": null,
        "weighted_average_shares_diluted": null,
        "cash_and_equivalents": null,
        "change_in_cash_and_equivalents": null,
        "total_debt": null,
        "total_assets": null,
        "total_liabilities": null,
        "shareholders_equity": null,
        "net_cash_flow_from_operations": null,
        "net_cash_flow_from_operations_chg": 1,
        "net_cash_flow_from_operations_yoy_chg": 1,
        "net_cash_flow_from_investing": null,
        "net_cash_flow_from_investing_chg": 1,
        "net_cash_flow_from_investing_yoy_chg": 1,
        "net_cash_flow_from_financing": null,
        "net_cash_flow_from_financing_chg": 1,
        "net_cash_flow_from_financing_yoy_chg": 1,
        "capital_expenditure": null,
        "capital_expenditure_chg": 1,
        "capital_expenditure_yoy_chg": 1,
        "free_cash_flow": null,
        "free_cash_flow_chg": 1,
        "free_cash_flow_yoy_chg": 1
      }
    }
  ],
  "next_page_url": "string"
}
Get earnings snapshot