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

get/v1/beta/financial/financials

Отримання всієї фінансової звітності

Усі три форми звітності однієї компанії за один виклик. Повертає об'єкт 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 ще вужчий.

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

Тарифікація: фіксована базова вартість успішного запиту.
Довідкова оцінка запиту: USD 0.02.
Довідковий множник для клієнта: 1.0. Не застосовуйте його повторно до вже розрахованої суми клієнта.

Лише довідкові метадані, а не котирування для облікового запису, гарантована ціна чи ліміт витрат. Кредити ресурсів — це не кредити Felo. Остаточні списання здійснюються за записами білінгу Felo.

Параметри запиту

cik
Тип: string

Central Index Key (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. Корисно для запитів на певний момент часу: повертаються лише дані, публічно подані до вказаної дати. Рядки без відомої дати подання виключаються.
limit
Тип: integer Формат: int32

Максимальна кількість фінансових звітів для повернення. Це загальна кількість по всіх сторінках, а не розмір сторінки: кожна сторінка містить до 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_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 в 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, якщо четвертий квартал виведено з річного документа.

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 перелік

Період балансового звіту.

значення
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 в 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
Тип: 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 перелік

Період звіту про рух грошових коштів.

значення
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 в 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, якщо четвертий квартал виведено з річного документа.

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 перелік

Період звіту про прибутки та збитки.

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

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

Відповідь з фінансовою звітністю

Отримання всієї фінансової звітності

АвтентифікаціяRequired

Financial Data

Отримання всієї фінансової звітності

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