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.

الحصول على قوائم الدخل

​

قوائم الدخل لشركة واحدة، نحو 32 حقلًا لكل فترة: revenue وcost_of_revenue وgross_profit وoperating_expense وselling_general_and_administrative_expenses وresearch_and_development وoperating_income وinterest_expense وebit وincome_tax_expense وnet_income وnet_income_common_stock وبنود السهم، كل منها مختوم بـ report_period وfiscal_period وcurrency وfiling_date وfiling_url. period محدّد (annual أو quarterly أو ttm). استخدمها لمسار الانتقال من الإيرادات إلى الأرباح. وللقوائم الثلاث دفعة واحدة استخدم get_financial_financials.

مرجع التسعير

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

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

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

    استجابة قوائم الدخل

    • income_statements
      النوع: array object[] · ResponseE40Feb4D3D6B_IncomeStatement[]
      • accession_number
        النوع: string | null

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

      • consolidated_income
        النوع: number

        الدخل الموحد للشركة.

      • cost_of_revenue
        النوع: number

        تكلفة الإيرادات للشركة.

      • currency
        النوع: string

        العملة التي تُبلَّغ بها البيانات المالية.

      • dividends_per_common_share
        النوع: number

        توزيعات الأرباح لكل سهم عادي للشركة.

      • earnings_per_share
        النوع: number

        ربحية السهم للشركة.

      • earnings_per_share_diluted
        النوع: number

        ربحية السهم المخففة للشركة.

      • ebit
        النوع: number

        الأرباح قبل الفوائد والضرائب للشركة.

      • filing_date
        النوع: string | null التنسيق: date

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

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

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

      • filing_url
        النوع: string | null التنسيق: uri

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

      • fiscal_period
        النوع: string

        الفترة المالية لقائمة الدخل.

      • form_type
        النوع: string | null

        نموذج SEC الذي استُمد منه هذا الصف (10-K، 10-Q/A، 20-F، S-1، ...). النموذج الدقيق كما قُدّم، لذا تحتفظ التعديلات بلاحقة /A. Null عندما تكون period هي ttm: قد تمتد نافذة الاثني عشر شهرًا المتدحرجة عبر عدة إيداعات، لذا لا ننسبها إلى إيداع واحد. يمكن أن يحمل صف quarterly النموذج 10-K عندما يُشتق الربع الرابع من إيداع السنة المالية.

      • gross_profit
        النوع: number

        إجمالي الربح للشركة.

      • income_tax_expense
        النوع: number

        مصروفات ضريبة الدخل للشركة.

      • interest_expense
        النوع: number

        مصروفات الفائدة للشركة.

      • net_income
        النوع: number

        صافي الدخل للشركة.

      • net_income_common_stock
        النوع: number

        صافي الدخل المتاح للمساهمين العاديين للشركة.

      • net_income_discontinued_operations
        النوع: number

        صافي الدخل من العمليات المتوقفة للشركة.

      • net_income_non_controlling_interests
        النوع: number

        صافي الدخل من المصالح غير المسيطرة للشركة.

      • operating_expense
        النوع: number

        المصروفات التشغيلية للشركة.

      • operating_income
        النوع: number

        الدخل التشغيلي للشركة.

      • period
        النوع: string تعداد

        الفترة الزمنية لقائمة الدخل.

        القيم
        • quarterly
        • ttm
        • annual
      • preferred_dividends_impact
        النوع: number

        أثر توزيعات الأرباح المفضلة على صافي دخل الشركة.

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

        فترة التقارير لقائمة الدخل.

      • research_and_development
        النوع: number

        مصروفات البحث والتطوير للشركة.

      • revenue
        النوع: number

        إجمالي الإيرادات للشركة.

      • selling_general_and_administrative_expenses
        النوع: number

        مصروفات البيع والعموم والإدارة للشركة.

      • ticker
        النوع: string

        رمز السهم.

      • weighted_average_shares
        النوع: number

        المتوسط المرجح للأسهم للشركة.

      • weighted_average_shares_diluted
        النوع: 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/financials/income-statements
curl https://openapi.felo.ai/v1/beta/financial/financials/income-statements \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "income_statements": [
    {
      "ticker": "string",
      "report_period": "2026-10-26",
      "fiscal_period": "string",
      "period": "quarterly",
      "currency": "string",
      "accession_number": null,
      "form_type": null,
      "filing_url": null,
      "filing_date": null,
      "filing_datetime": null,
      "revenue": 1,
      "cost_of_revenue": 1,
      "gross_profit": 1,
      "operating_expense": 1,
      "selling_general_and_administrative_expenses": 1,
      "research_and_development": 1,
      "operating_income": 1,
      "interest_expense": 1,
      "ebit": 1,
      "income_tax_expense": 1,
      "net_income_discontinued_operations": 1,
      "net_income_non_controlling_interests": 1,
      "net_income": 1,
      "net_income_common_stock": 1,
      "preferred_dividends_impact": 1,
      "consolidated_income": 1,
      "earnings_per_share": 1,
      "earnings_per_share_diluted": 1,
      "dividends_per_common_share": 1,
      "weighted_average_shares": 1,
      "weighted_average_shares_diluted": 1
    }
  ],
  "next_page_url": "string"
}
Get income statements