Financial Data
Company fundamentals, financial statements, market prices and economic data.
بحث في مقاييس مالية محدّدة
اسحب بنودًا مالية مسمّاة عبر شركة واحدة أو أكثر في استدعاء واحد. يأخذ الجسم tickers وline_items (كلاهما مطلوب، وكلاهما مصفوفة)، إضافةً إلى period (annual أو quarterly أو ttm) وlimit. يعيد search_results بصف واحد لكل ticker وفترة يحمل فقط الحقول التي طلبتها، إلى جانب report_period وperiod وcurrency. استخدمه لبناء جدول مقارنة دون سحب ثلاث قوائم كاملة لكل شركة. أسماء البنود هي أسماء الحقول نفسها التي تعيدها أدوات القوائم، لذا ابحث عنها هناك أولًا إن لم تكن متأكدًا. ولكل ما يتعلق بشركة واحدة استخدم get_financial_financials.
مرجع التسعير
- القياس: أساس تكلفة ثابت لكل طلب ناجح.
- تقدير الطلب المرجعي: 0.02 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: array string[] 1…line
_items مطلوبمصفوفة بنود لتطبيقها على البحث.
- النوع: array string[] 1…tickersمطلوب
مصفوفة رموز تداول لتطبيقها على البحث.
- النوع: integerlimitالحد الأدنى:1
الحد الأقصى لعدد النتائج المراد إرجاعها.
- النوع: string تعدادperiod
الفترة الزمنية للبيانات المالية.
القيم- annual
- quarterly
- ttm
- النوع: object · ResponseE40Feb4D3D6B_FinancialsSearchResponse200
استجابة بحث ناجحة
- النوع: array object[]search
_results - currencyالنوع: string
عملة البيانات المالية.
- periodالنوع: string تعداد
الفترة الزمنية للبيانات المالية.
القيم- annual
- quarterly
- ttm
- reportالنوع: string التنسيق: date
_period فترة التقارير للبيانات المالية.
- tickerالنوع: string
رمز سهم الشركة.
- propertyالنوع: string
Name مقاييس مالية إضافية بناءً على معايير البحث.
application/json - 400
تعذّرت معالجة الطلب. تحقق من معاملات الطلب.
- 401
مطلوب مفتاح API صالح من Felo.
- 402
لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.
- 403
الحساب غير مصرّح له بهذه العملية.
- 429
تم بلوغ حد الطلبات أو حد الإنفاق.
- 502
تعذّر على الخدمة إكمال الطلب.
- 503
خدمة API أو الفوترة غير متاحة مؤقتًا.
- 504
انتهت مهلة الخدمة أثناء معالجة الطلب.
- default
استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد
application/json
curl https://openapi.felo.ai/v1/beta/financial/financials/search/line-items \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"line_items": [
""
],
"tickers": [
""
],
"period": "ttm",
"limit": 1
}'
{
"search_results": [
{
"ticker": "string",
"report_period": "2026-10-26",
"period": "annual",
"currency": "string",
"additionalProperty": "string"
}
]
}