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 enumperiod
התקופה של הנתונים הפיננסיים.
ערכים- annual
- quarterly
- ttm
- סוג: object · ResponseE40Feb4D3D6B_FinancialsSearchResponse200
תגובת חיפוש מוצלחת
- סוג: array object[]search
_results - currencyסוג: string
המטבע של הנתונים הפיננסיים.
- periodסוג: string enum
התקופה של הנתונים הפיננסיים.
ערכים- 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"
}
]
}