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.

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

​

Извлекает именованные финансовые строки по одной или нескольким компаниям за один вызов. Тело принимает tickers и line_items (оба обязательны, оба массивы), а также period (annual, quarterly или ttm) и limit. Возвращает search_results с одной строкой на ticker и период, содержащей только запрошенные поля, вместе с report_period, period и currency. Используйте, чтобы построить сравнительную таблицу, не выгружая три полные формы на каждую компанию. Названия статей совпадают с именами полей, которые возвращают инструменты отчётности, поэтому при сомнении сначала найдите их там. Для всего по одной компании используйте get_financial_financials.

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

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

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

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

    Массив статей для применения к поиску.

  • tickers
    Тип: array string[] 1…
    обязательно

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

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

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

  • period
    Тип: string enum

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

    значения
    • annual
    • quarterly
    • ttm
Ответы
  • 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/line-items
curl https://openapi.felo.ai/v1/beta/financial/financials/search/line-items \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "line_items": [
    ""
  ],
  "tickers": [
    ""
  ],
  "period": "ttm",
  "limit": 1
}'
{
  "search_results": [
    {
      "ticker": "string",
      "report_period": "2026-10-26",
      "period": "annual",
      "currency": "string",
      "additionalProperty": "string"
    }
  ]
}
Search specific financial metrics

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