Financial Data
Company fundamentals, financial statements, market prices and economic data.
بحث في القوائم المالية
ابحث عن رموز ticker تطابق شروطًا رقمية. يأخذ الجسم filters — كل منها field وoperator وvalue — إضافةً إلى limit. يعيد results مع ticker وcurrency وsector وindustry والحقل المفلتر الذي طابق. هذه الأداة الوحيدة هنا التي تعمل دون معرفة ticker مسبقًا؛ وكل ما عداها يأخذه كمدخل. الحقول القابلة للتصفية هي أسماء المقاييس التي يعيدها get_financial_financial_metrics. استخدمه لبناء قائمة مرشّحين، ثم اسحب التفاصيل لكل اسم بأدوات القوائم أو المقاييس.
مرجع التسعير
- القياس: أساس تكلفة ثابت لكل طلب ناجح.
- تقدير الطلب المرجعي: 0.02 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: array object[] 1…filtersمطلوب
مصفوفة كائنات مرشّحات لتطبيقها على البحث.
- fieldالنوع: stringمطلوب
المعايير المراد التصفية وفقها. لحقول المقاييس المالية، استخدم معاملات 'gt' و'lt' و'gte' و'lte' و'eq'. لحقلي 'ticker' و'cik'، استخدم المعامل 'in' للتصفية مقابل قيم متعددة.
- operatorالنوع: string تعدادمطلوب
معامل المقارنة. لا يمكن استخدام المعامل 'in' إلا مع قيمة حقل 'ticker' أو 'cik'، ويتيح لك التصفية مقابل قيم متعددة.
القيم- gt
- lt
- gte
- lte
- eq
- in
- valueمطلوب
- النوع: number
القيمة المراد المقارنة بها لمعاملات القيمة الواحدة (gt، lt، gte، lte، eq)
- النوع: integerlimitالحد الأدنى:1
الحد الأقصى لعدد النتائج المراد إرجاعها.
- النوع: 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/screener \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"limit": 10,
"filters": [
{
"field": "",
"operator": "gt",
"value": 1
}
]
}'
{
"search_results": [
{
"ticker": "string",
"report_period": "2026-10-26",
"period": "annual",
"currency": "string",
"additionalProperty": "string"
}
]
}