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

Получение всей финансовой отчётности

​

Все три формы отчётности одной компании за один вызов. Возвращает объект 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.

Query-параметры
  • 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 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_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 enum

          Период балансового отчёта.

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

          Период отчёта о движении денежных средств.

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

          Период отчёта о прибылях и убытках.

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

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

    application/json
Request Example for 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"
}
Get all financial statements

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