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.

חיפוש בדוחות כספיים

​

מצאו טיקרים שמתאימים לתנאים מספריים. הגוף מקבל filters — כל אחד field, operator ו-value — וכן limit. מחזיר results עם ticker, currency, sector, industry והשדה המסונן שהותאם. זהו הכלי היחיד כאן שעובד בלי לדעת ticker מראש; כל השאר מקבל אחד כקלט. השדות הניתנים לסינון הם שמות המדדים ש-get_financial_financial_metrics מחזיר. השתמשו בו לבניית רשימת מועמדים, ואז שלפו פירוט לכל שם עם כלי הדוחות או המדדים.

מראה תמחור

  • מדידה: בסיס עלות קבוע לבקשה מוצלחת.
  • אומדן בקשת ייחוס: 0.02 דולר ארה״ב.
  • מכפיל לקוח לייחוס: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.

זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.

גוף
חובה
application/json
  • filters
    סוג: array object[] 1…
    חובה

    מערך של אובייקטי מסנן להחלה על החיפוש.

    • field
      סוג: string
      חובה

      הקריטריונים לסינון. עבור שדות מדדים פיננסיים, השתמשו באופרטורים 'gt', 'lt', 'gte', 'lte', 'eq'. עבור השדות 'ticker' ו-'cik', השתמשו באופרטור 'in' לסינון מול ערכים מרובים.

    • operator
      סוג: string enum
      חובה

      אופרטור ההשוואה. ניתן להשתמש באופרטור 'in' רק עם ערך שדה 'ticker' או 'cik', והוא מאפשר סינון מול ערכים מרובים.

      ערכים
      • gt
      • lt
      • gte
      • lte
      • eq
      • in
    • value
      חובה
      • סוג: number

        הערך להשוואה עבור אופרטורים של ערך בודד (gt, lt, gte, lte, eq)

  • limit
    סוג: integer
    מינימום:  
    1

    המספר המרבי של תוצאות להחזרה.

תגובות
  • 200
    סוג: object · ResponseE40Feb4D3D6B_FinancialsSearchResponse

    תגובת חיפוש מוצלחת

    • search_results
      סוג: array object[]
      • currency
        סוג: string

        המטבע של הנתונים הפיננסיים.

      • period
        סוג: string enum

        התקופה של הנתונים הפיננסיים.

        ערכים
        • annual
        • quarterly
        • ttm
      • report_period
        סוג: string פורמט: date

        תקופת הדיווח של הנתונים הפיננסיים.

      • ticker
        סוג: string

        סמל הטיקר של החברה.

      • propertyName
        סוג: string

        מדדים פיננסיים נוספים בהתאם לקריטריוני החיפוש.

    application/json
  • 400

    לא ניתן היה לעבד את הבקשה. בדקו את פרמטרי הבקשה.

  • 401

    נדרש מפתח API תקף של Felo.

  • 402

    לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.

  • 403

    החשבון אינו מורשה לבצע את הפעולה הזו.

  • 429

    הגעתם למגבלת בקשות או לתקרת הוצאה.

  • 502

    השירות לא הצליח להשלים את הבקשה.

  • 503

    שירות ה-API או החיוב אינו זמין באופן זמני.

  • 504

    השירות פג בזמן הטיפול בבקשה.

  • default

    תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק

    application/json
Request Example for post/v1/beta/financial/financials/search/screener
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"
    }
  ]
}
Search financial statements