Felo API PlatformFelo API Platform
Все эндпоинты 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.

Query-параметры
  • 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 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 б.п.). Возвращается, только когда его можно рассчитать.

        • 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 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 б.п.). Возвращается, только когда его можно рассчитать.

        • 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: любая из валовой/операционной/чистой маржи изменилась год к году на ≥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

    Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

    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

Нужна помощь?