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 פעולות

קבלת כל הדוחות הכספיים

​

כל שלושת הדוחות לחברה אחת בקריאה אחת. מחזיר אובייקט financials המכיל income_statements, balance_sheets ו-cash_flow_statements, כל אחד באותה צורה שהכלים הייעודיים מחזירים. period חובה (annual, quarterly או ttm); זהו את החברה לפי ticker או cik והגבילו עם limit. השתמשו בו כשצריך את התמונה המלאה ואחרת הייתם מבצעים שלוש קריאות. כשצריך דוח אחד בלבד, get_financial_financials_income_statements, get_financial_financials_balance_sheets או get_financial_financials_cash_flow_statements מחזירים הרבה פחות נתונים; כשצריך קומץ שדות בשם אחד על פני כמה חברות, post_financial_financials_search_line_items צר עוד יותר.

מראה תמחור

  • מדידה: בסיס עלות קבוע לבקשה מוצלחת.
  • אומדן בקשת ייחוס: 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 פורמט: int32

    המספר המרבי של דוחות כספיים להחזרה. זהו סך כל העמודים, לא גודל עמוד: כל עמוד מכיל עד 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_FinancialsResponse

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

    • financials
      סוג: object
      • balance_sheets
        סוג: array object[] · ResponseE40Feb4D3D6B_BalanceSheet[]
        • accession_number
          סוג: string | null

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

        • accumulated_other_comprehensive_income
          סוג: number

          סך הרווח המקיף האחר המצטבר של החברה.

        • cash_and_equivalents
          סוג: number

          המזומנים ושווי המזומנים של החברה.

        • currency
          סוג: string

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

        • current_assets
          סוג: number

          הנכסים השוטפים של החברה.

        • current_debt
          סוג: number

          החוב השוטף של החברה.

        • current_investments
          סוג: number

          ההשקעות השוטפות של החברה.

        • current_liabilities
          סוג: number

          ההתחייבויות השוטפות של החברה.

        • deferred_revenue
          סוג: number

          ההכנסות הנדחות של החברה.

        • deposit_liabilities
          סוג: 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 כאשר הרבעון הרביעי נגזר מההגשה השנתית.

        • goodwill_and_intangible_assets
          סוג: number

          המוניטין והנכסים הבלתי מוחשיים של החברה.

        • inventory
          סוג: number

          המלאי של החברה.

        • investments
          סוג: number

          ההשקעות של החברה.

        • non_current_assets
          סוג: number

          הנכסים הלא שוטפים של החברה.

        • non_current_debt
          סוג: number

          החוב הלא שוטף של החברה.

        • non_current_investments
          סוג: number

          ההשקעות הלא שוטפות של החברה.

        • non_current_liabilities
          סוג: number

          ההתחייבויות הלא שוטפות של החברה.

        • outstanding_shares
          סוג: number

          המניות בסחרור של החברה.

        • period
          סוג: string enum

          התקופה של המאזן.

          ערכים
          • quarterly
          • ttm
          • annual
        • property_plant_and_equipment
          סוג: number

          הנדל"ן, המתקנים והציוד של החברה.

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

          תקופת הדיווח של המאזן.

        • retained_earnings
          סוג: number

          הרווחים העודפים של החברה.

        • shareholders_equity
          סוג: number

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

        • tax_assets
          סוג: number

          נכסי המס של החברה.

        • tax_liabilities
          סוג: number

          התחייבויות המס של החברה.

        • ticker
          סוג: string

          סמל הטיקר.

        • total_assets
          סוג: number

          סך הנכסים של החברה.

        • total_debt
          סוג: number

          סך החוב של החברה.

        • total_liabilities
          סוג: number

          סך ההתחייבויות של החברה.

        • trade_and_non_trade_payables
          סוג: number

          חשבונות לתשלום סחריים ולא סחריים של החברה.

        • trade_and_non_trade_receivables
          סוג: number

          חשבונות לגבייה סחריים ולא סחריים של החברה.

      • cash_flow_statements
        סוג: array object[] · ResponseE40Feb4D3D6B_CashFlowStatement[]
        • accession_number
          סוג: string | null

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

        • business_acquisitions_and_disposals
          סוג: number

          רכישות ומימושים של עסקים של החברה.

        • capital_expenditure
          סוג: number

          הוצאות ההון של החברה.

        • change_in_cash_and_equivalents
          סוג: number

          השינוי במזומנים ושווי מזומנים של החברה.

        • currency
          סוג: string

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

        • depreciation_and_amortization
          סוג: number

          הפחת וההפחתות של החברה.

        • dividends_and_other_cash_distributions
          סוג: number

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

        • effect_of_exchange_rate_changes
          סוג: number

          השפעת שינויי שערי החליפין של החברה.

        • ending_cash_balance
          סוג: 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
          סוג: number

          תזרים המזומנים החופשי של החברה.

        • investment_acquisitions_and_disposals
          סוג: number

          רכישות ומימושים של השקעות של החברה.

        • issuance_or_purchase_of_equity_shares
          סוג: number

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

        • issuance_or_repayment_of_debt_securities
          סוג: number

          הנפקה או פירעון של ניירות חוב של החברה.

        • net_cash_flow_from_financing
          סוג: number

          תזרים המזומנים הנטו ממימון של החברה.

        • net_cash_flow_from_investing
          סוג: number

          תזרים המזומנים הנטו מהשקעות של החברה.

        • net_cash_flow_from_operations
          סוג: number

          תזרים המזומנים הנטו מפעילות של החברה.

        • net_income
          סוג: number

          הרווח הנקי של החברה.

        • period
          סוג: string enum

          התקופה של דוח תזרים המזומנים.

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

          תקופת הדיווח של דוח תזרים המזומנים.

        • share_based_compensation
          סוג: number

          התגמול מבוסס המניות של החברה.

        • ticker
          סוג: string

          סמל הטיקר.

      • income_statements
        סוג: array object[] · ResponseE40Feb4D3D6B_IncomeStatement[]
        • accession_number
          סוג: string | null

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

        • consolidated_income
          סוג: number

          ההכנסה המאוחדת של החברה.

        • cost_of_revenue
          סוג: number

          עלות ההכנסות של החברה.

        • currency
          סוג: string

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

        • dividends_per_common_share
          סוג: number

          הדיבידנדים לכל מניה רגילה של החברה.

        • earnings_per_share
          סוג: number

          הרווח למניה של החברה.

        • earnings_per_share_diluted
          סוג: number

          הרווח המדולל למניה של החברה.

        • ebit
          סוג: 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 כאשר הרבעון הרביעי נגזר מההגשה השנתית.

        • gross_profit
          סוג: number

          הרווח הגולמי של החברה.

        • income_tax_expense
          סוג: number

          הוצאות מס ההכנסה של החברה.

        • interest_expense
          סוג: number

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

        • net_income
          סוג: number

          הרווח הנקי של החברה.

        • net_income_common_stock
          סוג: number

          הרווח הנקי הזמין לבעלי מניות רגילות של החברה.

        • net_income_discontinued_operations
          סוג: number

          הרווח הנקי מפעילות מופסקת של החברה.

        • net_income_non_controlling_interests
          סוג: number

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

        • operating_expense
          סוג: number

          ההוצאות התפעוליות של החברה.

        • operating_income
          סוג: number

          הרווח התפעולי של החברה.

        • period
          סוג: string enum

          התקופה של דוח רווח והפסד.

          ערכים
          • quarterly
          • ttm
          • annual
        • preferred_dividends_impact
          סוג: number

          ההשפעה של דיבידנדים מועדפים על הרווח הנקי של החברה.

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

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

        • research_and_development
          סוג: number

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

        • revenue
          סוג: number

          סך ההכנסות של החברה.

        • selling_general_and_administrative_expenses
          סוג: number

          הוצאות המכירה, ההנהלה והכלליות של החברה.

        • ticker
          סוג: string

          סמל הטיקר.

        • weighted_average_shares
          סוג: number

          ממוצע משוקלל של המניות של החברה.

        • weighted_average_shares_diluted
          סוג: number

          ממוצע משוקלל מדולל של המניות של החברה.

    • 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/financials
curl 'https://openapi.felo.ai/v1/beta/financial/financials?period=annual' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "financials": {
    "income_statements": [
      {
        "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,
        "revenue": 1,
        "cost_of_revenue": 1,
        "gross_profit": 1,
        "operating_expense": 1,
        "selling_general_and_administrative_expenses": 1,
        "research_and_development": 1,
        "operating_income": 1,
        "interest_expense": 1,
        "ebit": 1,
        "income_tax_expense": 1,
        "net_income_discontinued_operations": 1,
        "net_income_non_controlling_interests": 1,
        "net_income": 1,
        "net_income_common_stock": 1,
        "preferred_dividends_impact": 1,
        "consolidated_income": 1,
        "earnings_per_share": 1,
        "earnings_per_share_diluted": 1,
        "dividends_per_common_share": 1,
        "weighted_average_shares": 1,
        "weighted_average_shares_diluted": 1
      }
    ],
    "balance_sheets": [
      {
        "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,
        "total_assets": 1,
        "current_assets": 1,
        "cash_and_equivalents": 1,
        "inventory": 1,
        "current_investments": 1,
        "trade_and_non_trade_receivables": 1,
        "non_current_assets": 1,
        "property_plant_and_equipment": 1,
        "goodwill_and_intangible_assets": 1,
        "investments": 1,
        "non_current_investments": 1,
        "outstanding_shares": 1,
        "tax_assets": 1,
        "total_liabilities": 1,
        "current_liabilities": 1,
        "current_debt": 1,
        "trade_and_non_trade_payables": 1,
        "deferred_revenue": 1,
        "deposit_liabilities": 1,
        "non_current_liabilities": 1,
        "non_current_debt": 1,
        "tax_liabilities": 1,
        "shareholders_equity": 1,
        "retained_earnings": 1,
        "accumulated_other_comprehensive_income": 1,
        "total_debt": 1
      }
    ],
    "cash_flow_statements": [
      {
        "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,
        "net_income": 1,
        "depreciation_and_amortization": 1,
        "share_based_compensation": 1,
        "net_cash_flow_from_operations": 1,
        "capital_expenditure": 1,
        "business_acquisitions_and_disposals": 1,
        "investment_acquisitions_and_disposals": 1,
        "net_cash_flow_from_investing": 1,
        "issuance_or_repayment_of_debt_securities": 1,
        "issuance_or_purchase_of_equity_shares": 1,
        "dividends_and_other_cash_distributions": 1,
        "net_cash_flow_from_financing": 1,
        "change_in_cash_and_equivalents": 1,
        "effect_of_exchange_rate_changes": 1,
        "ending_cash_balance": 1,
        "free_cash_flow": 1
      }
    ]
  },
  "next_page_url": "string"
}
Get all financial statements