Felo API PlatformFelo API Platform
כל ה-endpoints של Financial Data
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 פעולות

קבלת מדדים פיננסיים

​

יחסים מחושבים לחברה אחת לאורך זמן, כ-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 enum
    חובה

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

    ערכים
    • 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 enum

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

      ערכים
      • 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
Request Example for 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

Get financial metrics