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 Операции

Получение финансовых показателей

​

Вычисленные коэффициенты одной компании во времени, около 49 за период: market_cap, enterprise_value, price_to_earnings_ratio, price_to_book_ratio, price_to_sales_ratio, enterprise_value_to_ebitda_ratio, free_cash_flow_yield, peg_ratio, gross_margin, operating_margin, net_margin, return_on_equity, return_on_assets, return_on_invested_capital, коэффициенты оборачиваемости и ликвидности, каждый с отметкой report_period и fiscal_period. period обязателен; идентифицируйте по ticker или cik. Используйте для отслеживания динамики коэффициента по периодам. Только для текущих значений get_financial_financial_metrics_snapshot — это одна строка и намного меньше.

Справочная информация о ценах

  • Тарификация: фиксированная базовая стоимость успешного запроса.
  • Справочная оценка запроса: USD 0.02.
  • Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.

Только справочные метаданные, а не котировка для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.

Query-параметры
  • cik
    Тип: string

    Central Index Key (CIK) компании. Можно использовать вместо ticker.

  • 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. Полезно для запросов на определённый момент времени: возвращаются только данные, публично поданные к указанной дате. Строки без известной даты подачи исключаются.

  • limit
    Тип: integer

    Максимальное количество возвращаемых результатов. Это общее количество по всем страницам, а не размер страницы: на каждой странице до 10 записей, связанных через next_page_url.

  • period
    Тип: string enum
    обязательно

    Период финансовых данных.

    значения
    • annual
    • quarterly
    • ttm
  • report_period
    Тип: string Формат: date

    Фильтрует по точной дате отчётного периода в формате YYYY-MM-DD.

  • report_period_gt
    Тип: string Формат: date

    Фильтр по отчётному периоду позже даты в формате YYYY-MM-DD.

  • report_period_gte
    Тип: string Формат: date

    Фильтр по отчётному периоду не ранее даты в формате YYYY-MM-DD.

  • report_period_lt
    Тип: string Формат: date

    Фильтр по отчётному периоду раньше даты в формате YYYY-MM-DD.

  • report_period_lte
    Тип: string Формат: date

    Фильтр по отчётному периоду не позднее даты в формате YYYY-MM-DD.

  • ticker
    Тип: string

    Тикер-символ компании. Обязателен, если не указан cik.

Ответы
  • 200
    Тип: object · ResponseE40Feb4D3D6B_FinancialMetricsResponse

    Исторические финансовые показатели и коэффициенты по ticker

    • accession_number
      Тип: string | null

      Номер документа SEC.

    • asset_turnover
      Тип: number

      Выручка, делённая на средние совокупные активы.

    • book_value_growth
      Тип: number

      Рост балансовой стоимости год к году.

    • book_value_per_share
      Тип: number

      Собственный капитал акционеров, делённый на акции в обращении.

    • cash_ratio
      Тип: number

      Денежные средства и их эквиваленты, делённые на краткосрочные обязательства.

    • currency
      Тип: string

      Валюта, в которой отчитываются финансовые данные.

    • current_ratio
      Тип: number

      Оборотные активы, делённые на краткосрочные обязательства.

    • days_sales_outstanding
      Тип: number

      Средняя дебиторская задолженность, делённая на выручку за период.

    • debt_to_assets
      Тип: number

      Совокупная задолженность, делённая на совокупные активы.

    • debt_to_equity
      Тип: number

      Совокупная задолженность, делённая на собственный капитал акционеров.

    • earnings_growth
      Тип: number

      Рост прибыли год к году.

    • earnings_per_share
      Тип: number

      Чистая прибыль, делённая на средневзвешенное число акций в обращении.

    • earnings_per_share_growth
      Тип: number

      Рост прибыли на акцию за период.

    • ebitda_growth
      Тип: number

      Рост EBITDA за период.

    • enterprise_value
      Тип: number

      Совокупная стоимость компании (рыночная капитализация + задолженность − денежные средства).

    • enterprise_value_to_ebitda_ratio
      Тип: number

      Отношение стоимости предприятия к EBITDA.

    • enterprise_value_to_revenue_ratio
      Тип: number

      Отношение стоимости предприятия к выручке.

    • filing_date
      Тип: string | null Формат: date

      Календарный день принятия документа SEC по восточному времени (рабочий часовой пояс SEC). Календарная пара к filing_datetime. Null, если к строке не привязан документ SEC с датой.

    • filing_datetime
      Тип: string | null Формат: date-time

      Временная метка с точностью меньше дня, фиксирующая момент принятия документа SEC по восточному времени. Источник — поле acceptanceDateTime SEC в API submissions EDGAR. Сочетается с filing_date (точность до календарного дня для того же события).

    • filing_url
      Тип: string | null Формат: uri

      URL документа SEC.

    • fiscal_period
      Тип: string

      Фискальный период финансовых показателей.

    • form_type
      Тип: string | null

      Форма SEC, из которой получена эта строка (10-K, 10-Q/A, 20-F, S-1, ...). Указывается точная форма в том виде, в каком она подана, поэтому поправки сохраняют суффикс /A. Null, если period — ttm: скользящее окно в двенадцать месяцев может охватывать несколько документов, поэтому мы не привязываем его к одному. Строка quarterly может содержать 10-K, если четвёртый квартал выведен из годового документа.

    • free_cash_flow_growth
      Тип: number

      Рост свободного денежного потока за период.

    • free_cash_flow_per_share
      Тип: number

      Свободный денежный поток, делённый на акции в обращении.

    • free_cash_flow_yield
      Тип: number

      Доходность свободного денежного потока.

    • gross_margin
      Тип: number

      Валовая прибыль в процентах от выручки.

    • interest_coverage
      Тип: number

      EBIT, делённый на процентные расходы.

    • inventory_turnover
      Тип: number

      Себестоимость проданных товаров, делённая на средние запасы.

    • net_margin
      Тип: number

      Чистая прибыль в процентах от выручки.

    • next_page_url
      Тип: string

      Абсолютный URL следующей страницы результатов. Присутствует, только если остались результаты; запрашивайте его как есть для продолжения. На каждой странице до 10 записей.

    • operating_cash_flow_ratio
      Тип: number

      Операционный денежный поток, делённый на краткосрочные обязательства.

    • operating_cycle
      Тип: number

      Оборачиваемость запасов + оборачиваемость дебиторской задолженности.

    • operating_income_growth
      Тип: number

      Рост операционной прибыли за период.

    • operating_margin
      Тип: number

      Операционная прибыль в процентах от выручки.

    • payout_ratio
      Тип: number

      Выплаченные дивиденды в процентах от чистой прибыли.

    • peg_ratio
      Тип: number

      Отношение цены к росту прибыли.

    • period
      Тип: string enum

      Период финансовых показателей.

      значения
      • quarterly
      • ttm
      • annual
    • price_to_book_ratio
      Тип: number

      Отношение цены к балансовой стоимости.

    • price_to_earnings_ratio
      Тип: number

      Отношение цены к прибыли.

    • price_to_sales_ratio
      Тип: number

      Отношение цены к выручке.

    • quick_ratio
      Тип: number

      Быстрореализуемые активы, делённые на краткосрочные обязательства.

    • receivables_turnover
      Тип: number

      Выручка, делённая на среднюю дебиторскую задолженность.

    • report_period
      Тип: string Формат: date

      Отчётный период финансовых показателей.

    • return_on_assets
      Тип: number

      Чистая прибыль в процентах от совокупных активов.

    • return_on_equity
      Тип: number

      Чистая прибыль в процентах от собственного капитала акционеров.

    • return_on_invested_capital
      Тип: number

      Чистая операционная прибыль после налогов в процентах от инвестированного капитала.

    • revenue_growth
      Тип: number

      Рост выручки год к году.

    • ticker
      Тип: string

      Тикер-символ компании.

    • working_capital_turnover
      Тип: number

      Выручка, делённая на средний оборотный капитал.

    application/json
  • 400

    Запрос не удалось обработать. Проверьте параметры запроса.

  • 401

    Требуется действительный API-ключ Felo.

  • 402

    Запрос не может быть выполнен: не выполнено требование биллинга.

  • 403

    Аккаунту не разрешено выполнять эту операцию.

  • 429

    Достигнут лимит запросов или расходов.

  • 502

    Сервис не смог выполнить запрос.

  • 503

    API или сервис биллинга временно недоступны.

  • 504

    Истекло время ожидания обработки запроса.

  • default

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

    application/json
Request Example for get/v1/beta/financial/financial-metrics
curl 'https://openapi.felo.ai/v1/beta/financial/financial-metrics?period=annual' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "ticker": "string",
  "report_period": "2026-10-26",
  "fiscal_period": "string",
  "period": "quarterly",
  "currency": "string",
  "accession_number": null,
  "form_type": null,
  "filing_url": null,
  "filing_date": null,
  "filing_datetime": null,
  "enterprise_value": 1,
  "price_to_earnings_ratio": 1,
  "price_to_book_ratio": 1,
  "price_to_sales_ratio": 1,
  "enterprise_value_to_ebitda_ratio": 1,
  "enterprise_value_to_revenue_ratio": 1,
  "free_cash_flow_yield": 1,
  "peg_ratio": 1,
  "gross_margin": 1,
  "operating_margin": 1,
  "net_margin": 1,
  "return_on_equity": 1,
  "return_on_assets": 1,
  "return_on_invested_capital": 1,
  "asset_turnover": 1,
  "inventory_turnover": 1,
  "receivables_turnover": 1,
  "days_sales_outstanding": 1,
  "operating_cycle": 1,
  "working_capital_turnover": 1,
  "current_ratio": 1,
  "quick_ratio": 1,
  "cash_ratio": 1,
  "operating_cash_flow_ratio": 1,
  "debt_to_equity": 1,
  "debt_to_assets": 1,
  "interest_coverage": 1,
  "revenue_growth": 1,
  "earnings_growth": 1,
  "book_value_growth": 1,
  "earnings_per_share_growth": 1,
  "free_cash_flow_growth": 1,
  "operating_income_growth": 1,
  "ebitda_growth": 1,
  "payout_ratio": 1,
  "earnings_per_share": 1,
  "book_value_per_share": 1,
  "free_cash_flow_per_share": 1,
  "next_page_url": "string"
}
Get financial metrics

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