Felo API PlatformFelo API Platform
Усі endpoint 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 перелік
      обов'язкове

      Оператор порівняння. Оператор '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 перелік

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

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

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

    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