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

get/v1/beta/financial/financial-metrics

الحصول على المقاييس المالية

نسب محسوبة لشركة واحدة عبر الزمن، نحو 49 لكل فترة: market_cap وenterprise_value وprice_to_earnings_ratio وprice_to_book_ratio وprice_to_sales_ratio وenterprise_value_to_ebitda_ratio وfree_cash_flow_yield وpeg_ratio وgross_margin وoperating_margin وnet_margin وreturn_on_equity وreturn_on_assets وreturn_on_invested_capital، ونسب الدوران والسيولة، كل منها مختوم بـ report_period وfiscal_period. period مطلوب؛ حدّد الشركة بـ ticker أو cik. استخدمه لرصد اتجاه نسبة عبر الفترات. وللقيم الحالية فقط، get_financial_financial_metrics_snapshot صف واحد وأصغر بكثير.

مرجع التسعير

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

الحد الأقصى لعدد النتائج المراد إرجاعها. هذا إجمالي عبر جميع الصفحات وليس حجم صفحة: تستوعب كل صفحة حتى 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_FinancialMetricsResponse

المقاييس والنسب المالية التاريخية لرمز ticker
accession_number
النوع: string | null

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

asset_turnover
النوع: number

الإيرادات مقسومة على متوسط إجمالي الأصول.

book_value_growth
النوع: number

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

book_value_per_share
النوع: number

حقوق المساهمين مقسومة على الأسهم القائمة.

cash_ratio
النوع: number

النقد وما يعادله مقسومًا على الالتزامات المتداولة.

currency
النوع: string

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

current_ratio
النوع: number

الأصول المتداولة مقسومة على الالتزامات المتداولة.

days_sales_outstanding
النوع: number

متوسط الذمم المدينة مقسومًا على الإيرادات خلال الفترة.

debt_to_assets
النوع: number

إجمالي الديون مقسومًا على إجمالي الأصول.

debt_to_equity
النوع: number

إجمالي الديون مقسومًا على حقوق المساهمين.

earnings_growth
النوع: number

النمو السنوي في الأرباح.

earnings_per_share
النوع: number

صافي الدخل مقسومًا على المتوسط المرجح للأسهم القائمة.

earnings_per_share_growth
النوع: number

نمو ربحية السهم خلال الفترة.

ebitda_growth
النوع: number

نمو EBITDA خلال الفترة.

enterprise_value
النوع: number

القيمة الإجمالية للشركة (القيمة السوقية + الدين - النقد).

enterprise_value_to_ebitda_ratio
النوع: number

نسبة قيمة المنشأة إلى EBITDA.

enterprise_value_to_revenue_ratio
النوع: 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_growth
النوع: number

نمو التدفق النقدي الحر خلال الفترة.

free_cash_flow_per_share
النوع: number

التدفق النقدي الحر مقسومًا على الأسهم القائمة.

free_cash_flow_yield
النوع: number

عائد التدفق النقدي الحر.

gross_margin
النوع: number

إجمالي الربح كنسبة مئوية من الإيرادات.

interest_coverage
النوع: number

EBIT مقسومًا على مصروف الفائدة.

inventory_turnover
النوع: number

تكلفة البضاعة المباعة مقسومة على متوسط المخزون.

net_margin
النوع: number

صافي الدخل كنسبة مئوية من الإيرادات.

next_page_url
النوع: string

عنوان URL المطلق للصفحة التالية من النتائج. موجود فقط عندما تبقى نتائج إضافية؛ اطلبه كما هو للمتابعة. تستوعب كل صفحة حتى 10 سجلات.

operating_cash_flow_ratio
النوع: number

التدفق النقدي التشغيلي مقسومًا على الالتزامات المتداولة.

operating_cycle
النوع: number

معدل دوران المخزون + معدل دوران الذمم المدينة.

operating_income_growth
النوع: number

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

operating_margin
النوع: number

الدخل التشغيلي كنسبة مئوية من الإيرادات.

payout_ratio
النوع: number

الأرباح الموزعة المدفوعة كنسبة مئوية من صافي الدخل.

peg_ratio
النوع: number

نسبة السعر إلى نمو الأرباح.

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

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

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

نسبة السعر إلى القيمة الدفترية.

price_to_earnings_ratio
النوع: number

نسبة السعر إلى الأرباح.

price_to_sales_ratio
النوع: number

نسبة السعر إلى المبيعات.

quick_ratio
النوع: number

الأصول السريعة مقسومة على الالتزامات المتداولة.

receivables_turnover
النوع: number

الإيرادات مقسومة على متوسط الذمم المدينة.

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

فترة التقارير للمقاييس المالية.

return_on_assets
النوع: number

صافي الدخل كنسبة مئوية من إجمالي الأصول.

return_on_equity
النوع: number

صافي الدخل كنسبة مئوية من حقوق المساهمين.

return_on_invested_capital
النوع: number

صافي الربح التشغيلي بعد الضرائب كنسبة مئوية من رأس المال المستثمر.

revenue_growth
النوع: number

النمو السنوي في الإيرادات.

ticker
النوع: string

رمز سهم الشركة.

working_capital_turnover
النوع: number

الإيرادات مقسومة على متوسط رأس المال العامل.
application/json
400

تعذّرت معالجة الطلب. تحقق من معاملات الطلب.
401

مطلوب مفتاح API صالح من Felo.
402

لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.
403

الحساب غير مصرّح له بهذه العملية.
429

تم بلوغ حد الطلبات أو حد الإنفاق.
502

تعذّر على الخدمة إكمال الطلب.
503

خدمة API أو الفوترة غير متاحة مؤقتًا.
504

انتهت مهلة الخدمة أثناء معالجة الطلب.
default

استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد

application/json

get/v1/beta/financial/financial-metrics

curl 'https://openapi.felo.ai/v1/beta/financial/financial-metrics?period=annual' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

عرض المخطط

{
  "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,
  "enterprise_value": 1,
  "price_to_earnings_ratio": 1,
  "price_to_book_ratio": 1,
  "price_to_sales_ratio": 1,
  "enterprise_value_to_ebitda_ratio": 1,
  "enterprise_value_to_revenue_ratio": 1,
  "free_cash_flow_yield": 1,
  "peg_ratio": 1,
  "gross_margin": 1,
  "operating_margin": 1,
  "net_margin": 1,
  "return_on_equity": 1,
  "return_on_assets": 1,
  "return_on_invested_capital": 1,
  "asset_turnover": 1,
  "inventory_turnover": 1,
  "receivables_turnover": 1,
  "days_sales_outstanding": 1,
  "operating_cycle": 1,
  "working_capital_turnover": 1,
  "current_ratio": 1,
  "quick_ratio": 1,
  "cash_ratio": 1,
  "operating_cash_flow_ratio": 1,
  "debt_to_equity": 1,
  "debt_to_assets": 1,
  "interest_coverage": 1,
  "revenue_growth": 1,
  "earnings_growth": 1,
  "book_value_growth": 1,
  "earnings_per_share_growth": 1,
  "free_cash_flow_growth": 1,
  "operating_income_growth": 1,
  "ebitda_growth": 1,
  "payout_ratio": 1,
  "earnings_per_share": 1,
  "book_value_per_share": 1,
  "free_cash_flow_per_share": 1,
  "next_page_url": "string"
}

المقاييس والنسب المالية التاريخية لرمز ticker

الحصول على المقاييس المالية

المصادقةRequired

Financial Data

الحصول على المقاييس المالية

مرجع التسعير