Felo API PlatformFelo API Platform
Усі endpoint 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.

Довідкові ціни

  • Тарифікація: фіксована базова вартість успішного запиту.
  • Довідкова оцінка запиту: USD 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 звітних періодів документів; кількість записів може перевищувати 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 перелік
        обов'язкове

        Тип форми 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 б.п.). Повертається, лише коли її можна обчислити.

        • 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 в API submissions EDGAR. Поєднується з filing_date (точність до календарного дня для тієї самої події).

      • filing_window
        Тип: string | null перелік

        Ринкова сесія на момент прийняття документа 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 б.п.). Повертається, лише коли її можна обчислити.

        • 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 перелік
          обов'язкове

          Категорія сигналу. MARGIN_EXPANSION/MARGIN_CONTRACTION: будь-яка з валової/операційної/чистої маржі змінилася рік до року на ≥100 б.п. 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: ступінчаста зміна EPS рік до року (≥15% / ≥30%); незалежно від чистого прибутку, оскільки зворотний викуп акцій може підсилювати рух EPS. 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