Felo API PlatformFelo API Platform
Усі endpoint Financial Data
v0.2.0-beta
OpenAPI 3.1.0

Отримання фінансових показників

Felo API Support
MIT
Сервер:https://openapi.felo.ai
Клієнтські бібліотеки
Shell Curl

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.

Параметри запиту
  • 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 перелік
    обов'язкове

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

    значення
    • 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 перелік

      Період фінансових показників.

      значення
      • 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

    Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника

    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"
}

Історичні фінансові показники та коефіцієнти за ticker

Get financial metrics