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.

الحصول على الميزانيات العمومية

​

الميزانيات العمومية لشركة واحدة، نحو 36 حقلًا لكل فترة: total_assets وcurrent_assets وcash_and_equivalents وinventory وtrade_and_non_trade_receivables وproperty_plant_and_equipment وgoodwill_and_intangible_assets وtotal_liabilities وcurrent_liabilities وcurrent_debt وtrade_and_non_trade_payables وdeferred_revenue وبنود حقوق الملكية، مختومة بـ report_period وfiscal_period وcurrency وfiling_url. period محدّد. استخدمها لهيكل رأس المال والسيولة. وللنسب المحسوبة أصلًا من هذه الأرقام استخدم get_financial_financial_metrics.

مرجع التسعير

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

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

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

    استجابة الميزانيات العمومية

    • 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

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

    • 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/balance-sheets
curl https://openapi.felo.ai/v1/beta/financial/financials/balance-sheets \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "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
    }
  ],
  "next_page_url": "string"
}
Get balance sheets