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.

Поиск финансовой отчётности

​

Находит ticker, соответствующие числовым условиям. Тело принимает filters — каждый с field, operator и value — плюс limit. Возвращает results с ticker, currency, sector, industry и тем отфильтрованным полем, которое совпало. Это единственный инструмент здесь, работающий без заранее известного ticker; все остальные принимают его на вход. Поля для фильтрации — это имена показателей, которые возвращает get_financial_financial_metrics. Используйте, чтобы построить список кандидатов, затем выгружайте детали по каждому через инструменты отчётности или показателей.

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

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

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

Тело
обязательно
application/json
  • filters
    Тип: array object[] 1…
    обязательно

    Массив объектов фильтра для применения к поиску.

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

      Критерии фильтрации. Для полей финансовых показателей используйте операторы 'gt', 'lt', 'gte', 'lte', 'eq'. Для полей 'ticker' и 'cik' используйте оператор 'in', чтобы фильтровать по нескольким значениям.

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

      Оператор сравнения. Оператор 'in' можно использовать только со значением поля 'ticker' или 'cik'; он позволяет фильтровать по нескольким значениям.

      значения
      • gt
      • lt
      • gte
      • lte
      • eq
      • in
    • value
      обязательно
      • Тип: number

        Значение для сравнения в операторах с одним значением (gt, lt, gte, lte, eq)

  • limit
    Тип: integer
    мин.:  
    1

    Максимальное количество результатов для возврата.

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

    Успешный ответ на поиск

    • search_results
      Тип: array object[]
      • currency
        Тип: string

        Валюта финансовых данных.

      • period
        Тип: string enum

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

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

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

      • ticker
        Тип: string

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

      • propertyName
        Тип: string

        Дополнительные финансовые показатели по критериям поиска.

    application/json
  • 400

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

  • 401

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

  • 402

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

  • 403

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

  • 429

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

  • 502

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

  • 503

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

  • 504

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

  • default

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

    application/json
Request Example for post/v1/beta/financial/financials/search/screener
curl https://openapi.felo.ai/v1/beta/financial/financials/search/screener \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "limit": 10,
  "filters": [
    {
      "field": "",
      "operator": "gt",
      "value": 1
    }
  ]
}'
{
  "search_results": [
    {
      "ticker": "string",
      "report_period": "2026-10-26",
      "period": "annual",
      "currency": "string",
      "additionalProperty": "string"
    }
  ]
}
Search financial statements

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