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.

الحصول على قوائم التدفقات النقدية

​

قوائم التدفقات النقدية لشركة واحدة، نحو 27 حقلًا لكل فترة: net_cash_flow_from_operations وnet_cash_flow_from_investing وnet_cash_flow_from_financing وcapital_expenditure وdepreciation_and_amortization وshare_based_compensation وissuance_or_repayment_of_debt_securities وissuance_or_purchase_of_equity_shares وdividends_and_other_cash_distributions، مختومة بـ report_period وfiscal_period وcurrency. period مطلوب. استخدمها لرؤية توليد النقد لا الأرباح المحاسبية. عائد التدفق النقدي الحر والأرقام المشتقة المشابهة موجودة في get_financial_financial_metrics.

مرجع التسعير

  • القياس: أساس تكلفة ثابت لكل طلب ناجح.
  • تقدير الطلب المرجعي: 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_CashFlowStatementResponse

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

    • 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

        رمز السهم.

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