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.

Financial Data פעולות

קבלת תמונת מצב של רווחים

​

רווחים מדווחים למניה אחת, בפועל מול הערכות. כל רשומה נושאת report_period, fiscal_period, filing_date, filing_url ו-accession_number, בלוק quarterly עם revenue, estimated_revenue, revenue_surprise ו-revenue_surprise_pct, אותה שלישייה עבור earnings_per_share, וכן שדות שינוי משנה לשנה. הוא גם מחזיר signals: דגלים המחושבים במעלה הזרם כגון EPS_BEAT עם headline וה-actual / estimate / surprise_pct שמאחוריו. ticker חובה והוא הפרמטר היחיד. השתמשו בו למה שהחברה דיווחה בפועל. לקונצנזוס צופה־פנים שטרם קרה השתמשו ב-get_financial_analyst_estimates.

מראה תמחור

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

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

פרמטרי שאילתה
  • cursor
    סוג: string

    סמן עימוד אטום מ-next_page_url של תגובה קודמת. כשמסופק, כל פרמטרי השאילתה האחרים מתעלמים: הסמן נושא את המסננים של הבקשה המקורית. התייחסו אליו כאטום; אל תיצרו או תשנו אותו.

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

    מספר תקופות הדיווח האחרונות שעבורן יוחזרו הגשות, ממוינות לפי (report_period DESC, filing_date ASC). מספר הרשומות שיוחזרו עשוי לעלות על limit כאשר בתקופה אחרונה יש גם 8-K וגם 10-Q / 10-K. ערכים מעל 40 מוגבלים ל-40. ערכים שאינם חיוביים או שאינם שלמים מחזירים 400. זהו סך כל העמודים, לא גודל עמוד: כל עמוד מכיל עד 10 רשומות, מקושרות ב-next_page_url.

  • ticker
    סוג: string
    חובה

    סמל הטיקר (למשל AAPL).

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

    תגובת רווחים

    • earnings
      סוג: array object[] · ResponseE40Feb4D3D6B_EarningsRecord[]

      רשימה שטוחה של הגשות SEC עבור הטיקר, ממוינת לפי (report_period DESC, filing_date ASC). כאשר limit=N, מוחזרות הגשות של עד N תקופות report_period; מספר הרשומות עשוי לעלות על N כאשר בתקופה אחרונה יש גם 8-K וגם 10-Q/10-K.

      • accession_number
        סוג: string
        חובה

        מספר ההצטרפות ב-SEC שמזהה את ההגשה.

      • filing_date
        סוג: string פורמט: date
        חובה

        היום הקלנדרי שבו SEC קיבלה את ההגשה, לפי שעון מזרח (אזור הזמן התפעולי של SEC). בן זוג קלנדרי ל-filing_datetime.

      • filing_url
        סוג: string פורמט: uri
        חובה

        כתובת URL להגשה ב-SEC.

      • report_period
        סוג: string פורמט: date
        חובה

        תקופת הדיווח שההגשה הזו מכסה.

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

        סוג טופס SEC שעליו מבוססת ההגשה הזו.

        ערכים
        • 8-K
        • 10-Q
        • 10-K
        • 20-F
      • ticker
        סוג: string
        חובה

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

      • annual
        סוג: object · ResponseE40Feb4D3D6B_EarningsTimeDimension
        • capital_expenditure
          סוג: number | null
        • capital_expenditure_chg
          סוג: number

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

        • capital_expenditure_yoy_chg
          סוג: number

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

        • cash_and_equivalents
          סוג: number | null
        • change_in_cash_and_equivalents
          סוג: number | null
        • earnings_per_share
          סוג: number | null
        • earnings_per_share_chg
          סוג: number

          אחוז השינוי ברווח למניה (EPS) לעומת התקופה הקודמת, כעשרוני. עוקב במטען הרבעוני, משנה לשנה במטען השנתי. מוחזר רק כאשר ניתן לחישוב.

        • earnings_per_share_yoy_chg
          סוג: number

          השינוי משנה לשנה ברווח למניה (EPS) לעומת אותו רבעון פיסקלי שנה קודם, כעשרוני. במטען הרבעוני בלבד. מוחזר רק כאשר ניתן לחישוב.

        • free_cash_flow
          סוג: number | null
        • free_cash_flow_chg
          סוג: number

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

        • free_cash_flow_yoy_chg
          סוג: number

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

        • gross_margin
          סוג: number

          שולי הרווח הגולמי כעשרוני (gross_profit / revenue). מוחזר רק כאשר ניתן לחישוב.

        • gross_margin_chg_bps
          סוג: number

          השינוי המוחלט בשולי הרווח הגולמי לעומת התקופה הקודמת בנקודות בסיס (למשל 200.0 = השוליים התרחבו ב-200 bps). מוחזר רק כאשר ניתן לחישוב.

        • gross_margin_chg_pct
          סוג: number

          אחוז השינוי בשולי הרווח הגולמי לעומת התקופה הקודמת, כעשרוני. מוחזר רק כאשר ניתן לחישוב.

        • gross_margin_yoy_chg_bps
          סוג: number

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

        • gross_margin_yoy_chg_pct
          סוג: number

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

        • gross_profit
          סוג: number | null
        • gross_profit_chg
          סוג: number

          אחוז השינוי ברווח הגולמי לעומת התקופה הקודמת, כעשרוני. עוקב במטען הרבעוני, משנה לשנה במטען השנתי. מוחזר רק כאשר ניתן לחישוב.

        • gross_profit_yoy_chg
          סוג: number

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

        • net_cash_flow_from_financing
          סוג: number | null
        • net_cash_flow_from_financing_chg
          סוג: number

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

        • net_cash_flow_from_financing_yoy_chg
          סוג: number

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

        • net_cash_flow_from_investing
          סוג: number | null
        • net_cash_flow_from_investing_chg
          סוג: number

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

        • net_cash_flow_from_investing_yoy_chg
          סוג: number

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

        • net_cash_flow_from_operations
          סוג: number | null
        • net_cash_flow_from_operations_chg
          סוג: number

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

        • net_cash_flow_from_operations_yoy_chg
          סוג: number

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

        • net_income
          סוג: number | null
        • net_income_chg
          סוג: number

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

        • net_income_yoy_chg
          סוג: number

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

        • net_margin
          סוג: number

          שולי הרווח הנקי כעשרוני (net_income / revenue). מוחזר רק כאשר ניתן לחישוב.

        • net_margin_chg_bps
          סוג: number

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

        • net_margin_chg_pct
          סוג: number

          אחוז השינוי בשולי הרווח הנקי לעומת התקופה הקודמת, כעשרוני. מוחזר רק כאשר ניתן לחישוב.

        • net_margin_yoy_chg_bps
          סוג: number

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

        • net_margin_yoy_chg_pct
          סוג: number

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

        • operating_income
          סוג: number | null
        • operating_income_chg
          סוג: number

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

        • operating_income_yoy_chg
          סוג: number

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

        • operating_margin
          סוג: number

          שולי הרווח התפעולי כעשרוני (operating_income / revenue). מוחזר רק כאשר ניתן לחישוב.

        • operating_margin_chg_bps
          סוג: number

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

        • operating_margin_chg_pct
          סוג: number

          אחוז השינוי בשולי הרווח התפעולי לעומת התקופה הקודמת, כעשרוני. מוחזר רק כאשר ניתן לחישוב.

        • operating_margin_yoy_chg_bps
          סוג: number

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

        • operating_margin_yoy_chg_pct
          סוג: number

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

        • revenue
          סוג: number | null
        • revenue_chg
          סוג: number

          אחוז השינוי בהכנסות לעומת התקופה הקודמת, כעשרוני (למשל 0.10 = +10%). עוקב במטען הרבעוני, משנה לשנה במטען השנתי. מוחזר רק כאשר ניתן לחישוב.

        • revenue_yoy_chg
          סוג: number

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

        • shareholders_equity
          סוג: number | null
        • total_assets
          סוג: number | null
        • total_debt
          סוג: number | null
        • total_liabilities
          סוג: number | null
        • weighted_average_shares
          סוג: number | null
        • weighted_average_shares_diluted
          סוג: number | null
      • currency
        סוג: string

        קוד מטבע ISO (למשל USD).

      • filing_datetime
        סוג: string | null פורמט: date-time

        חותמת זמן תת-יומית המתעדת מתי SEC קיבלה את ההגשה, לפי שעון מזרח. מקור: השדה acceptanceDateTime של SEC ב-EDGAR submissions API. עומד לצד filing_date (דיוק של יום קלנדרי לאותו אירוע).

      • filing_window
        סוג: string | null enum

        מפגש המסחר ברגע קבלת ההגשה על ידי SEC, לפי שעון מזרח. PRE_MARKET = יום חול 04:00–09:30 ET. DURING_MARKET = יום חול 09:30–16:00 ET. AFTER_HOURS = יום חול מחוץ לשעות המסחר הרגילות. WEEKEND = שבת או ראשון. Null כאשר filing_datetime אינו זמין.

        ערכים
        • PRE_MARKET
        • DURING_MARKET
        • AFTER_HOURS
        • WEEKEND
      • fiscal_period
        סוג: string

        תווית התקופה הפיסקלית (למשל 2026-Q1 או 2025-FY).

      • quarterly
        סוג: object · ResponseE40Feb4D3D6B_EarningsTimeDimension
        • capital_expenditure
          סוג: number | null
        • capital_expenditure_chg
          סוג: number

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

        • capital_expenditure_yoy_chg
          סוג: number

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

        • cash_and_equivalents
          סוג: number | null
        • change_in_cash_and_equivalents
          סוג: number | null
        • earnings_per_share
          סוג: number | null
        • earnings_per_share_chg
          סוג: number

          אחוז השינוי ברווח למניה (EPS) לעומת התקופה הקודמת, כעשרוני. עוקב במטען הרבעוני, משנה לשנה במטען השנתי. מוחזר רק כאשר ניתן לחישוב.

        • earnings_per_share_yoy_chg
          סוג: number

          השינוי משנה לשנה ברווח למניה (EPS) לעומת אותו רבעון פיסקלי שנה קודם, כעשרוני. במטען הרבעוני בלבד. מוחזר רק כאשר ניתן לחישוב.

        • free_cash_flow
          סוג: number | null
        • free_cash_flow_chg
          סוג: number

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

        • free_cash_flow_yoy_chg
          סוג: number

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

        • gross_margin
          סוג: number

          שולי הרווח הגולמי כעשרוני (gross_profit / revenue). מוחזר רק כאשר ניתן לחישוב.

        • gross_margin_chg_bps
          סוג: number

          השינוי המוחלט בשולי הרווח הגולמי לעומת התקופה הקודמת בנקודות בסיס (למשל 200.0 = השוליים התרחבו ב-200 bps). מוחזר רק כאשר ניתן לחישוב.

        • gross_margin_chg_pct
          סוג: number

          אחוז השינוי בשולי הרווח הגולמי לעומת התקופה הקודמת, כעשרוני. מוחזר רק כאשר ניתן לחישוב.

        • gross_margin_yoy_chg_bps
          סוג: number

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

        • gross_margin_yoy_chg_pct
          סוג: number

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

        • gross_profit
          סוג: number | null
        • gross_profit_chg
          סוג: number

          אחוז השינוי ברווח הגולמי לעומת התקופה הקודמת, כעשרוני. עוקב במטען הרבעוני, משנה לשנה במטען השנתי. מוחזר רק כאשר ניתן לחישוב.

        • gross_profit_yoy_chg
          סוג: number

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

        • net_cash_flow_from_financing
          סוג: number | null
        • net_cash_flow_from_financing_chg
          סוג: number

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

        • net_cash_flow_from_financing_yoy_chg
          סוג: number

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

        • net_cash_flow_from_investing
          סוג: number | null
        • net_cash_flow_from_investing_chg
          סוג: number

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

        • net_cash_flow_from_investing_yoy_chg
          סוג: number

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

        • net_cash_flow_from_operations
          סוג: number | null
        • net_cash_flow_from_operations_chg
          סוג: number

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

        • net_cash_flow_from_operations_yoy_chg
          סוג: number

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

        • net_income
          סוג: number | null
        • net_income_chg
          סוג: number

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

        • net_income_yoy_chg
          סוג: number

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

        • net_margin
          סוג: number

          שולי הרווח הנקי כעשרוני (net_income / revenue). מוחזר רק כאשר ניתן לחישוב.

        • net_margin_chg_bps
          סוג: number

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

        • net_margin_chg_pct
          סוג: number

          אחוז השינוי בשולי הרווח הנקי לעומת התקופה הקודמת, כעשרוני. מוחזר רק כאשר ניתן לחישוב.

        • net_margin_yoy_chg_bps
          סוג: number

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

        • net_margin_yoy_chg_pct
          סוג: number

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

        • operating_income
          סוג: number | null
        • operating_income_chg
          סוג: number

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

        • operating_income_yoy_chg
          סוג: number

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

        • operating_margin
          סוג: number

          שולי הרווח התפעולי כעשרוני (operating_income / revenue). מוחזר רק כאשר ניתן לחישוב.

        • operating_margin_chg_bps
          סוג: number

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

        • operating_margin_chg_pct
          סוג: number

          אחוז השינוי בשולי הרווח התפעולי לעומת התקופה הקודמת, כעשרוני. מוחזר רק כאשר ניתן לחישוב.

        • operating_margin_yoy_chg_bps
          סוג: number

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

        • operating_margin_yoy_chg_pct
          סוג: number

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

        • revenue
          סוג: number | null
        • revenue_chg
          סוג: number

          אחוז השינוי בהכנסות לעומת התקופה הקודמת, כעשרוני (למשל 0.10 = +10%). עוקב במטען הרבעוני, משנה לשנה במטען השנתי. מוחזר רק כאשר ניתן לחישוב.

        • revenue_yoy_chg
          סוג: number

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

        • shareholders_equity
          סוג: number | null
        • total_assets
          סוג: number | null
        • total_debt
          סוג: number | null
        • total_liabilities
          סוג: number | null
        • weighted_average_shares
          סוג: number | null
        • weighted_average_shares_diluted
          סוג: number | null
      • signals
        סוג: array object[] · ResponseE40Feb4D3D6B_Signal[]

        תובנות אצורות ומשנות שוק שזוקקו מההגשה הזו. לכל פריט יש headline מוכן מראש, details מובנים ודירוג importance. מוחזר רק כאשר לפחות אות אחד מופעל עבור הרשומה; אחרת השדה מושמט. עד 8 פריטים לכל רשומה, בסדר HIGH → MEDIUM → LOW.

        תובנה אצורה ומשנת שוק שנגזרה מההגשה הזו. headline מוכן מראש מתאים להצגה ישירה; details נושא שדות מובנים לסינון ולשימוש תוכנתי. האותות מוחזרים לפי סדר עדיפות (המהותי ביותר קודם); ה-type עצמו מקודד את העוצמה (למשל STRONG_REVENUE_INCREASE לעומת REVENUE_INCREASE).

        • headline
          סוג: string
          חובה

          סיכום מוכן מראש וקריא, מתאים להצגה ישירה.

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

          קטגוריית האות. MARGIN_EXPANSION/MARGIN_CONTRACTION: אחד משולי הרווח הגולמי/התפעולי/הנקי נע משנה לשנה ב-≥100bps. GUIDANCE_RAISED/GUIDANCE_LOWERED/GUIDANCE_REAFFIRMED/GUIDANCE_INITIATED: שינוי בתחזית קדימה המדווח בהגשה. SEGMENT_OUTPERFORMANCE/SEGMENT_UNDERPERFORMANCE: הסגמנט המדווח בעל הביצועים הטובים או הגרועים ביותר לפי צמיחת הכנסות אורגנית. NON_GAAP_DIVERGENCE: נתון מתואם/non-GAAP שונה מהותית ממקבילו ב-GAAP באותה תקופה. BACKLOG_SURGE/BACKLOG_DECLINE: צבר ההזמנות או התחייבויות ביצוע שנותרו נעו משנה לשנה ב-≥20%. REVENUE_INCREASE/STRONG_REVENUE_INCREASE וגרסאות DECLINE: שינוי מדורג בהכנסות משנה לשנה (≥10% / ≥20% בעוצמה). NET_INCOME_INCREASE/STRONG_NET_INCOME_INCREASE וגרסאות DECLINE: שינוי מדורג ברווח הנקי משנה לשנה (≥15% / ≥30%). EPS_INCREASE/STRONG_EPS_INCREASE וגרסאות DECLINE: שינוי מדורג ברווח למניה משנה לשנה (≥15% / ≥30%); בלתי תלוי ברווח הנקי משום שרכישה עצמית של מניות יכולה להגביר את תנועת הרווח למניה. CAPEX_INCREASE/STRONG_CAPEX_INCREASE וגרסאות DECLINE: שינוי מדורג בהוצאות ההון משנה לשנה בעוצמת ההוצאה (≥15% / ≥30%).

          ערכים
          • MARGIN_EXPANSION
          • MARGIN_CONTRACTION
          • GUIDANCE_RAISED
          • GUIDANCE_LOWERED
          • GUIDANCE_REAFFIRMED
        • details
          סוג: object

          שדות מובנים הספציפיים לסוג האות. התוכן משתנה: אותות תחזית נושאים low, high, point_estimate, prior_value, revision_pct; אותות סגמנט נושאים best, worst, spread_pp; אותות non-GAAP נושאים gaap_field, non_gaap_value, gaap_value, divergence_pct; אותות צמיחה נושאים current, yoy_chg. ערכי Null מושמטים. ראו דוגמאות לפי סוג.

          • propertyName
            סוג: anything
        • metric
          סוג: string | null

          המדד שאליו האות מתייחס, כאשר רלוונטי (למשל revenue, earnings_per_share, operating_margin, או שם מדד תחזית/KPI).

        • period
          סוג: string | null

          התקופה הפיסקלית שאליה האות מתייחס (למשל 2026-Q1, FY 2026). אותות תחזית קדימה מתייחסים לתקופה המודרכת; אותות פיננסיים מתייחסים לתקופת הדיווח של ההגשה הזו.

    • next_page_url
      סוג: string

      כתובת URL מוחלטת של העמוד הבא של התוצאות. קיימת רק כאשר נותרו תוצאות נוספות; יש לבקש אותה כפי שהיא כדי להמשיך. כל עמוד מכיל עד 10 רשומות.

    application/json
  • 400

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

  • 401

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

  • 402

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

  • 403

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

  • 429

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

  • 502

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

  • 503

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

  • 504

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

  • default

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

    application/json
Request Example for get/v1/beta/financial/earnings
curl 'https://openapi.felo.ai/v1/beta/financial/earnings?ticker=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "earnings": [
    {
      "ticker": "string",
      "report_period": "2026-10-26",
      "fiscal_period": "string",
      "currency": "string",
      "source_type": "8-K",
      "filing_date": "2026-10-26",
      "filing_datetime": null,
      "filing_window": "PRE_MARKET",
      "signals": [
        {
          "type": "MARGIN_EXPANSION",
          "metric": null,
          "period": null,
          "headline": "string",
          "details": {
            "additionalProperty": "anything"
          }
        }
      ],
      "filing_url": "https://example.com",
      "accession_number": "string",
      "quarterly": {
        "revenue": null,
        "revenue_chg": 1,
        "revenue_yoy_chg": 1,
        "earnings_per_share": null,
        "earnings_per_share_chg": 1,
        "earnings_per_share_yoy_chg": 1,
        "gross_profit": null,
        "gross_profit_chg": 1,
        "gross_profit_yoy_chg": 1,
        "gross_margin": 1,
        "gross_margin_chg_bps": 1,
        "gross_margin_chg_pct": 1,
        "gross_margin_yoy_chg_bps": 1,
        "gross_margin_yoy_chg_pct": 1,
        "operating_income": null,
        "operating_income_chg": 1,
        "operating_income_yoy_chg": 1,
        "operating_margin": 1,
        "operating_margin_chg_bps": 1,
        "operating_margin_chg_pct": 1,
        "operating_margin_yoy_chg_bps": 1,
        "operating_margin_yoy_chg_pct": 1,
        "net_income": null,
        "net_income_chg": 1,
        "net_income_yoy_chg": 1,
        "net_margin": 1,
        "net_margin_chg_bps": 1,
        "net_margin_chg_pct": 1,
        "net_margin_yoy_chg_bps": 1,
        "net_margin_yoy_chg_pct": 1,
        "weighted_average_shares": null,
        "weighted_average_shares_diluted": null,
        "cash_and_equivalents": null,
        "change_in_cash_and_equivalents": null,
        "total_debt": null,
        "total_assets": null,
        "total_liabilities": null,
        "shareholders_equity": null,
        "net_cash_flow_from_operations": null,
        "net_cash_flow_from_operations_chg": 1,
        "net_cash_flow_from_operations_yoy_chg": 1,
        "net_cash_flow_from_investing": null,
        "net_cash_flow_from_investing_chg": 1,
        "net_cash_flow_from_investing_yoy_chg": 1,
        "net_cash_flow_from_financing": null,
        "net_cash_flow_from_financing_chg": 1,
        "net_cash_flow_from_financing_yoy_chg": 1,
        "capital_expenditure": null,
        "capital_expenditure_chg": 1,
        "capital_expenditure_yoy_chg": 1,
        "free_cash_flow": null,
        "free_cash_flow_chg": 1,
        "free_cash_flow_yoy_chg": 1
      },
      "annual": {
        "revenue": null,
        "revenue_chg": 1,
        "revenue_yoy_chg": 1,
        "earnings_per_share": null,
        "earnings_per_share_chg": 1,
        "earnings_per_share_yoy_chg": 1,
        "gross_profit": null,
        "gross_profit_chg": 1,
        "gross_profit_yoy_chg": 1,
        "gross_margin": 1,
        "gross_margin_chg_bps": 1,
        "gross_margin_chg_pct": 1,
        "gross_margin_yoy_chg_bps": 1,
        "gross_margin_yoy_chg_pct": 1,
        "operating_income": null,
        "operating_income_chg": 1,
        "operating_income_yoy_chg": 1,
        "operating_margin": 1,
        "operating_margin_chg_bps": 1,
        "operating_margin_chg_pct": 1,
        "operating_margin_yoy_chg_bps": 1,
        "operating_margin_yoy_chg_pct": 1,
        "net_income": null,
        "net_income_chg": 1,
        "net_income_yoy_chg": 1,
        "net_margin": 1,
        "net_margin_chg_bps": 1,
        "net_margin_chg_pct": 1,
        "net_margin_yoy_chg_bps": 1,
        "net_margin_yoy_chg_pct": 1,
        "weighted_average_shares": null,
        "weighted_average_shares_diluted": null,
        "cash_and_equivalents": null,
        "change_in_cash_and_equivalents": null,
        "total_debt": null,
        "total_assets": null,
        "total_liabilities": null,
        "shareholders_equity": null,
        "net_cash_flow_from_operations": null,
        "net_cash_flow_from_operations_chg": 1,
        "net_cash_flow_from_operations_yoy_chg": 1,
        "net_cash_flow_from_investing": null,
        "net_cash_flow_from_investing_chg": 1,
        "net_cash_flow_from_investing_yoy_chg": 1,
        "net_cash_flow_from_financing": null,
        "net_cash_flow_from_financing_chg": 1,
        "net_cash_flow_from_financing_yoy_chg": 1,
        "capital_expenditure": null,
        "capital_expenditure_chg": 1,
        "capital_expenditure_yoy_chg": 1,
        "free_cash_flow": null,
        "free_cash_flow_chg": 1,
        "free_cash_flow_yoy_chg": 1
      }
    }
  ],
  "next_page_url": "string"
}
Get earnings snapshot