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

الحصول على جميع القوائم المالية

Felo API Support
MIT
الخادم:https://openapi.felo.ai
مكتبات العملاء
Shell Curl

Financial Data

​

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

Financial Data العمليات

الحصول على جميع القوائم المالية

​

القوائم الثلاث كلها لشركة واحدة في استدعاء واحد. يعيد كائن financials يضم income_statements وbalance_sheets وcash_flow_statements، كل منها بالشكل نفسه الذي تعيده الأدوات المخصصة. period مطلوب (annual أو quarterly أو ttm)؛ حدّد الشركة بـ ticker أو cik وحدّد الحد الأقصى بـ limit. استخدمه عندما تحتاج الصورة الكاملة وكنت ستصنع ثلاثة استدعاءات. وعندما تحتاج قائمة واحدة فقط، يعيد get_financial_financials_income_statements أو get_financial_financials_balance_sheets أو get_financial_financials_cash_flow_statements بيانات أقل بكثير؛ وعندما تحتاج حفنة من الحقول المسمّاة عبر عدة شركات، يكون post_financial_financials_search_line_items أضيق منها.

مرجع التسعير

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

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

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

    مفتاح الفهرس المركزي (CIK) للشركة.

  • cursor
    النوع: string

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

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

    تصفية حسب تاريخ إفصاح SEC الدقيق بصيغة YYYY-MM-DD. تُستبعد الصفوف التي لا يتوفر لها تاريخ إفصاح معروف.

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

    تصفية حسب تاريخ إفصاح SEC الأكبر من التاريخ بصيغة YYYY-MM-DD. تُستبعد الصفوف التي لا يتوفر لها تاريخ إفصاح معروف.

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

    تصفية حسب تاريخ إفصاح SEC الأكبر من أو المساوي للتاريخ بصيغة YYYY-MM-DD. تُستبعد الصفوف التي لا يتوفر لها تاريخ إفصاح معروف.

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

    تصفية حسب تاريخ إفصاح SEC الأصغر من التاريخ بصيغة YYYY-MM-DD. تُستبعد الصفوف التي لا يتوفر لها تاريخ إفصاح معروف.

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

    تصفية حسب تاريخ إفصاح SEC الأصغر من أو المساوي للتاريخ بصيغة YYYY-MM-DD. مفيد للاستعلامات اللحظية (point-in-time): يعيد فقط البيانات التي أُفصح عنها علنًا بحلول التاريخ المحدد. تُستبعد الصفوف التي لا يتوفر لها تاريخ إفصاح معروف.

  • limit
    النوع: integer التنسيق: int32

    الحد الأقصى لعدد البيانات المالية المراد إرجاعها. هذا إجمالي عبر جميع الصفحات وليس حجم صفحة: تستوعب كل صفحة حتى 10 سجلات، مرتبطة بـnext_page_url.

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

    الفترة الزمنية للبيانات المالية.

    القيم
    • annual
    • quarterly
    • ttm
  • report_period
    النوع: string التنسيق: date

    تصفية حسب تاريخ فترة التقرير الدقيق بصيغة YYYY-MM-DD.

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

    تصفية حسب فترة التقرير الأكبر من التاريخ بصيغة YYYY-MM-DD.

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

    تصفية حسب فترة التقرير الأكبر من أو المساوية للتاريخ بصيغة YYYY-MM-DD.

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

    تصفية حسب فترة التقرير الأصغر من التاريخ بصيغة YYYY-MM-DD.

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

    تصفية حسب فترة التقرير الأصغر من أو المساوية للتاريخ بصيغة YYYY-MM-DD.

  • ticker
    النوع: string

    رمز السهم. مطلوب إذا لم يُقدَّم cik.

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

    استجابة القوائم المالية

    • financials
      النوع: object
      • balance_sheets
        النوع: array object[] · ResponseE40Feb4D3D6B_BalanceSheet[]
        • accession_number
          النوع: string | null

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

        • accumulated_other_comprehensive_income
          النوع: number

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

        • cash_and_equivalents
          النوع: number

          النقد وما يعادله لدى الشركة.

        • currency
          النوع: string

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

        • current_assets
          النوع: number

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

        • current_debt
          النوع: number

          الديون المتداولة للشركة.

        • current_investments
          النوع: number

          الاستثمارات المتداولة للشركة.

        • current_liabilities
          النوع: number

          الالتزامات المتداولة للشركة.

        • deferred_revenue
          النوع: number

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

        • deposit_liabilities
          النوع: 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 عندما يُشتق الربع الرابع من إيداع السنة المالية.

        • goodwill_and_intangible_assets
          النوع: number

          الشهرة والأصول غير الملموسة للشركة.

        • inventory
          النوع: number

          المخزون لدى الشركة.

        • investments
          النوع: number

          الاستثمارات لدى الشركة.

        • non_current_assets
          النوع: number

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

        • non_current_debt
          النوع: number

          الديون غير المتداولة للشركة.

        • non_current_investments
          النوع: number

          الاستثمارات غير المتداولة للشركة.

        • non_current_liabilities
          النوع: number

          الالتزامات غير المتداولة للشركة.

        • outstanding_shares
          النوع: number

          الأسهم القائمة للشركة.

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

          الفترة الزمنية للميزانية العمومية.

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

          العقارات والمنشآت والمعدات للشركة.

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

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

        • retained_earnings
          النوع: number

          الأرباح المحتجزة للشركة.

        • shareholders_equity
          النوع: number

          حقوق المساهمين في الشركة.

        • tax_assets
          النوع: number

          الأصول الضريبية للشركة.

        • tax_liabilities
          النوع: number

          الالتزامات الضريبية للشركة.

        • ticker
          النوع: string

          رمز السهم.

        • total_assets
          النوع: number

          إجمالي الأصول للشركة.

        • total_debt
          النوع: number

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

        • total_liabilities
          النوع: number

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

        • trade_and_non_trade_payables
          النوع: number

          الذمم الدائنة التجارية وغير التجارية للشركة.

        • trade_and_non_trade_receivables
          النوع: number

          الذمم المدينة التجارية وغير التجارية للشركة.

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

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

        • business_acquisitions_and_disposals
          النوع: number

          عمليات الاستحواذ على الأعمال والتخلص منها للشركة.

        • capital_expenditure
          النوع: number

          النفقات الرأسمالية للشركة.

        • change_in_cash_and_equivalents
          النوع: number

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

        • currency
          النوع: string

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

        • depreciation_and_amortization
          النوع: number

          الإهلاك والاستهلاك للشركة.

        • dividends_and_other_cash_distributions
          النوع: number

          الأرباح الموزعة والتوزيعات النقدية الأخرى للشركة.

        • effect_of_exchange_rate_changes
          النوع: number

          أثر تغيرات أسعار الصرف للشركة.

        • ending_cash_balance
          النوع: 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 عندما يُشتق الربع الرابع من إيداع السنة المالية.

        • free_cash_flow
          النوع: number

          التدفق النقدي الحر للشركة.

        • investment_acquisitions_and_disposals
          النوع: number

          عمليات الاستحواذ على الاستثمارات والتخلص منها للشركة.

        • issuance_or_purchase_of_equity_shares
          النوع: number

          إصدار أسهم حقوق الملكية أو شراؤها للشركة.

        • issuance_or_repayment_of_debt_securities
          النوع: number

          إصدار سندات الدين أو سدادها للشركة.

        • net_cash_flow_from_financing
          النوع: number

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

        • net_cash_flow_from_investing
          النوع: number

          صافي التدفق النقدي من الاستثمار للشركة.

        • net_cash_flow_from_operations
          النوع: number

          صافي التدفق النقدي من التشغيل للشركة.

        • net_income
          النوع: number

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

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

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

          القيم
          • quarterly
          • ttm
          • annual
        • report_period
          النوع: string التنسيق: date

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

        • share_based_compensation
          النوع: number

          المكافآت القائمة على الأسهم للشركة.

        • ticker
          النوع: string

          رمز السهم.

      • 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
curl 'https://openapi.felo.ai/v1/beta/financial/financials?period=annual' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "financials": {
    "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
      }
    ],
    "balance_sheets": [
      {
        "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,
        "total_assets": 1,
        "current_assets": 1,
        "cash_and_equivalents": 1,
        "inventory": 1,
        "current_investments": 1,
        "trade_and_non_trade_receivables": 1,
        "non_current_assets": 1,
        "property_plant_and_equipment": 1,
        "goodwill_and_intangible_assets": 1,
        "investments": 1,
        "non_current_investments": 1,
        "outstanding_shares": 1,
        "tax_assets": 1,
        "total_liabilities": 1,
        "current_liabilities": 1,
        "current_debt": 1,
        "trade_and_non_trade_payables": 1,
        "deferred_revenue": 1,
        "deposit_liabilities": 1,
        "non_current_liabilities": 1,
        "non_current_debt": 1,
        "tax_liabilities": 1,
        "shareholders_equity": 1,
        "retained_earnings": 1,
        "accumulated_other_comprehensive_income": 1,
        "total_debt": 1
      }
    ],
    "cash_flow_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,
        "net_income": 1,
        "depreciation_and_amortization": 1,
        "share_based_compensation": 1,
        "net_cash_flow_from_operations": 1,
        "capital_expenditure": 1,
        "business_acquisitions_and_disposals": 1,
        "investment_acquisitions_and_disposals": 1,
        "net_cash_flow_from_investing": 1,
        "issuance_or_repayment_of_debt_securities": 1,
        "issuance_or_purchase_of_equity_shares": 1,
        "dividends_and_other_cash_distributions": 1,
        "net_cash_flow_from_financing": 1,
        "change_in_cash_and_equivalents": 1,
        "effect_of_exchange_rate_changes": 1,
        "ending_cash_balance": 1,
        "free_cash_flow": 1
      }
    ]
  },
  "next_page_url": "string"
}

استجابة القوائم المالية

Get all financial statements